Scroll to navigation

MINTPY-DEM_ERROR(1) User Commands MINTPY-DEM_ERROR(1)

NAME

mintpy-dem_error - DEM Error (Topographic Residual) Correction

DESCRIPTION

usage: dem_error.py [-h] [-g GEOM_FILE] [-o OUTFILE] [-t TEMPLATE_FILE]

[--ex [EXCLUDEDATE ...]] [-p POLYORDER]
[-s [STEPFUNCDATE ...]] [--periodic PERIODIC [PERIODIC ...]] [--phase-velocity] [--update] [--ram MAXMEMORY] [-c {lsf,pbs,slurm,local}] [--num-worker NUMWORKER] [--config CONFIG] timeseries_file

DEM Error (Topographic Residual) Correction

positional arguments:

Timeseries file to be corrrected

options:

show this help message and exit
geometry file including datasets: incidence angle slant range distance and/or 3D perpendicular baseline
Output file name for corrected time-series
Use phase velocity instead of phase for inversion constrain.
Enable update mode, and skip inversion if: 1) output timeseries file already exists, readable and newer than input interferograms file 2) all configuration parameters are the same.
Max amount of memory in GB to use (default: 4.0). Adjust according to your computer memory.

temporal deformation model:

template file with the options
Exclude date(s) for DEM error estimation. All dates will be corrected for DEM residual phase still.
polynomial order number of temporal deformation model (default: 2).
Date of step jump for temporal deformation model (default: []). i.e. date of earthquake/volcanic eruption
periodic functinos of temporal deformation model (default: []).

parallel:

parallel processing using dask
Cluster to use for parallel computing (default: None to turn OFF).
Number of workers to use (default: 4).
Configuration name to use in dask.yaml (default: None).

reference:

Fattahi, H., and F. Amelung (2013), DEM Error Correction in InSAR Time Series, IEEE TGRS, 51(7), 4249-4259, doi:10.1109/TGRS.2012.2227761.

template options:

## Topographic residual (DEM error) correction ## reference: Fattahi and Amelung (2013, IEEE-TGRS) ## stepFuncDate - specify stepFuncDate option if you know there are sudden displacement jump in your area, ## e.g. volcanic eruption, or earthquake ## excludeDate - dates excluded for the error estimation ## pixelwiseGeometry - use pixel-wise geometry (incidence angle & slant range distance) ## yes - use pixel-wise geometry if they are available [slow; used by default] ## no - use the mean geometry [fast] mintpy.topographicResidual = auto #[yes / no], auto for yes mintpy.topographicResidual.polyOrder = auto #[1-inf], auto for 2, poly order of temporal deformation model mintpy.topographicResidual.phaseVelocity = auto #[yes / no], auto for no - phase, use phase velocity for minimization mintpy.topographicResidual.stepFuncDate = auto #[20080529,20190704T1733 / no], auto for no, date of step jump mintpy.topographicResidual.excludeDate = auto #[20070321 / txtFile / no], auto for exclude_date.txt mintpy.topographicResidual.pixelwiseGeometry = auto #[yes / no], auto for yes, use pixel-wise geometry info

example:

# correct DEM error with pixel-wise geometry parameters [slow] dem_error.py timeseries_ERA5_ramp.h5 -g inputs/geometryRadar.h5 -t smallbaselineApp.cfg
# correct DEM error with mean geometry parameters [fast] dem_error.py timeseries_ERA5_ramp.h5 -t smallbaselineApp.cfg
# get updated/corrected DEM save_roipac.py inputs/geometryGeo.h5 -o dem.h5 #for dataset in geo coordinates mask.py demErr.h5 -m maskTempCoh.h5 -o demErr_msk.h5 add.py demErr_msk.h5 dem.h5 -o demNew.h5
May 2022 mintpy-dem_error v1.3.3