biopal.ground_cancellation.ground_cancellation.ground_cancellation#
- biopal.ground_cancellation.ground_cancellation.ground_cancellation(data_stack, kz_stack, multi_master_flag, z_emph, eq_flag, pho_r, theta_look, ground_slope)#
Ground Cancellation APP
Computes the ground cancellation from input data stack.
- Parameters:
- data_stackdict of dicts containing 2D numpy arrays
stack of calibrated, ground steered SLC images; it is a dictionary of two nested dictionaries (acquisitions->polarizations) where each data_stack[ acquisition_name_string ][ polarization_name_string ] is an array of shape [Nrg x Naz]
- kz_stackdict of numpy arrays or double
phase-to-height conversion factors; needed if num_acq > 2. It is a dictionary where kz_stack[acquisition_name_string] is an array of shape [Nrg x Naz] or a scalar for constant geometries
- multi_master_flagbool
manage master:
if true average notch is computed with all possible masters
if false average notch is computed automatically selecting the best master
in both cases, only if more than two acquisitions are present
- z_emphdouble or 2D numpy array
two choices:
can be a scalar value for forest height [m] used in the processing to determine the vertical wavenumber for which the ground cancelled data is generated; only with more than two acquisitions
can be a 2D map of shape [Nrg x Naz] and in this case the space varying feature is enabled
- eq_flagstr
backscatter equalization, with possible values “1”,”2”’ or “3” where:
“1” equalization OFF
“2” equalization ON
“3” if just two acquisitions are present in each of the used stacks is ON, otherwise is OFF
- pho_rdouble
slant range resolution [m]
- theta_look2D numpy array
off-nadir angles map [rad], it is an array of shape [Nrg x Naz]
- ground_slope2D numpy array
terrain slope map [rad], it is an array of shape [Nrg x Naz]
- Returns:
- GroundNotchedSLCdict containing 2D numpy arrays
dictionary containing three polarizations, each composed by an [Nrg x Naz] ground notched SLC image.