Phase Deformation Converter#

PhaseDeformationConverter#

class faninsar.PhaseDeformationConverter(freq_or_wl: Frequency | Wavelength)[source]#

Bases: object

Convert between phase and deformation (mm) for SAR interferometry.

Note

In FanInSAR, deformation/displacement is referenced to Earth, resulting in inverted signs when referring to radar measurements. Specifically, negative values indicate movement away from the radar (e.g., subsidence), while positive values signify movement towards the radar (e.g., uplift).

classmethod from_frequency(frequency: float, unit: Literal['GHz', 'MHz', 'kHz', 'Hz'] = 'GHz') PhaseDeformationConverter[source]#

Create a PhaseDeformationConverter from frequency value.

Parameters:
  • frequency (float) – The frequency value.

  • unit (Literal["GHz", "MHz", "kHz", "Hz"], optional) – The unit of frequency, by default “GHz”.

Returns:

The converter instance.

Return type:

PhaseDeformationConverter

classmethod from_wavelength(wavelength: float, unit: Literal['m', 'cm', 'dm', 'mm'] = 'm') PhaseDeformationConverter[source]#

Create a PhaseDeformationConverter from wavelength value.

Parameters:
  • wavelength (float) – The wavelength value.

  • unit (Literal["m", "cm", "dm", "mm"], optional) – The unit of wavelength, by default “m”.

Returns:

The converter instance.

Return type:

PhaseDeformationConverter

phase2deformation(phase: NDArray[np.floating]) NDArray[np.floating][source]#

Convert phase to deformation (mm).

deformation2phase(deformation: NDArray[np.floating]) NDArray[np.floating][source]#

Convert deformation (mm) to phase (radian).

wrap_phase(phase: NDArray[np.floating]) NDArray[np.floating][source]#

Wrap phase to [0, 2π].