Scroll to navigation

MINTPY-UNWRAP_ERROR_BRIDGING(1) User Commands MINTPY-UNWRAP_ERROR_BRIDGING(1)

NAME

mintpy-unwrap_error_bridging - Unwrapping Error Correction with Bridging

DESCRIPTION

usage: unwrap_error_bridging.py [-h] [-r BRIDGEPTSRADIUS]

[--ramp {linear,quadratic}]
[--water-mask WATERMASKFILE] [-m CONNCOMPMINAREA] [-t TEMPLATE_FILE] [-i DATASETNAMEIN] [-o DATASETNAMEOUT] [--update] ifgram_file

Unwrapping Error Correction with Bridging

by connecting reliable regions with MST bridges. This method assumes the phase differences between neighboring regions are less than pi rad in magnitude.

positional arguments:

interferograms file to be corrected

options:

show this help message and exit
radius of the end point of bridge to search area to get median representative value default: 50.
type of phase ramp to be removed before correction.
path of water mask file.
minimum region/area size of a single connComponent.
template file with bonding point info, e.g. mintpy.unwrapError.yx = 283,1177,305,1247;350,2100,390,2200
name of dataset to be corrected, default: unwrapPhase
name of dataset to be written after correction, default: {}_bridging
Enable update mode: if unwrapPhase_unwCor dataset exists, skip the correction.

reference:

Yunjun, Z., H. Fattahi, and F. Amelung (2019), Small baseline InSAR time series analysis: Unwrapping error correction and noise reduction, Computers & Geosciences, 133, 104331, doi:10.1016/j.cageo.2019.104331.

template options:

## connected components (mintpy.load.connCompFile) are required for this step. ## SNAPHU (Chem & Zebker,2001) is currently the only unwrapper that provides connected components as far as we know. ## reference: Yunjun et al. (2019, section 3) ## supported methods: ## a. phase_closure - suitable for highly redundant network ## b. bridging - suitable for regions separated by narrow decorrelated features, e.g. rivers, narrow water bodies ## c. bridging+phase_closure - recommended when there is a small percentage of errors left after bridging mintpy.unwrapError.method = auto #[bridging / phase_closure / bridging+phase_closure / no], auto for no mintpy.unwrapError.waterMaskFile = auto #[waterMask.h5 / no], auto for waterMask.h5 or no [if not found] mintpy.unwrapError.connCompMinArea = auto #[1-inf], auto for 2.5e3, discard regions smaller than the min size in pixels
## phase_closure options: ## numSample - a region-based strategy is implemented to speedup L1-norm regularized least squares inversion. ## Instead of inverting every pixel for the integer ambiguity, a common connected component mask is generated, ## for each common conn. comp., numSample pixels are radomly selected for inversion, and the median value of the results ## are used for all pixels within this common conn. comp. mintpy.unwrapError.numSample = auto #[int>1], auto for 100, number of samples to invert for common conn. comp.
## briding options: ## ramp - a phase ramp could be estimated based on the largest reliable region, removed from the entire interferogram ## before estimating the phase difference between reliable regions and added back after the correction. ## bridgePtsRadius - half size of the window used to calculate the median value of phase difference mintpy.unwrapError.ramp = auto #[linear / quadratic], auto for no; recommend linear for L-band data mintpy.unwrapError.bridgePtsRadius = auto #[1-inf], auto for 50, half size of the window around end points

Example:

./inputs/ifgramStack.h5 -t GalapagosSenDT128.template --update
./inputs/ifgramStack.h5 --water-mask waterMask.h5
20180502_20180619.unw --water-mask waterMask.h5
May 2022 mintpy-unwrap_error_bridging v1.3.3