INSGEODISP

Description

From a series of stacks produced from INSDMV, both the vertical and easterly velocities in meters per year will be calculated at user specified intervals.

Parameters

Name	Type	Caption	Length	Value range
MFILE *	String	Input folder, or text file	1 - 192
OPTIONS	String	Options for DateTimes of Interest	0 - 192	Default:
DIMS	Integer	Number of dimensions to output	0 -
FILEDEM *	String	File or folder containing the digital elevation model	1 - 192
FILO *	String	Database output file name	1 - 192
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

MFILE

The name of a folder, or a text file containing the list of interferometric stacks to be processed. Only the PIX file format (*.pix) is supported. All files listed in the MFILE or within the input folder pointed to by MFILE must correspond to displacements generated by INSDMV.

All input files must be co-registered and have the same number of lines and columns.

When MFILE is a text file, it must contain a list of interferograms (one per line) with their full pathname, for example: MFILE= "C:/InSAR_project/Ineterograms_list.txt"

where the text file contains

C:/InSAR_project/Ascending.pix

C:/InSAR_project/Decending.pix

Alternatively, an input folder can be specified: MFILE = "C:/InSAR_project/RAW"

It is recommended to use wildcards (*) to refine the search within the specified folder, for example:

MFILE = r"C:/InSAR_project/RAW/*.pix"
MFILE = r"C:/InSAR_project/RAW/ref*.pix"

Note: For more information about using MFILE, including the requirements for a valid file, see Using an MFILE with a CATALYST Professional algorithm.

OPTIONS

Methods for passing DateTimes of interested to ppf.

n DateTimes separated by delimitator.
Start DateTime, End DateTime, Stepsize
MAX, Stepsize
Full path/file name to RAW text file containing either of the previous options.

Date Times must be in valid ISO Extended format:

Date-Time: YYYY-MM-DDThh:mm:ss.ssssZ "2017-03-15T15:08:59.512Z"
Date-Time: YYYY-MM-DDThh:mm:ss.ssss "2017-03-15T15:08:59.512"
Date Only: YYYY-MM-DDTZ "2017-03-15TZ"
Date Only: YYYY-MM-DD "2017-03-15"

MAX detects maximum date-time range available and automatically sets matching start and end DateTime.

Stepsize is used to set the dates of interest in interval the options are in:

y = years, example: "1.5y" = 1 year, 6 months
m = months
w = weeks, example: "1.5w" = 1 week, 3 days, 12 hours
d = days, example: "1.5d" = 1 day, 12 hours
h = hours

Mixing options of y,m, w, d,h is not allowed, i.e. "1w3d" is not valid.

DIMS

The number of dimensions to output. Valid values are 2 or 3. 2 dimensions will output vertical displacement and longitudinal displacement. 3 dimensions will also estimate a latitudinal displacement from the vertical and longitudinal displacements and local slope information.

FILEDEM

The name of a file, folder, or DEM index file containing DEM tiles.

The following table describes the processing of FILEDEM based on the value you specify.

FILO

Specifies the name of the PIX file to be generated. The output file will contain 2 channels for each chronologically ordered time interval. The odd numbered channels represent the vertical velocities while the even numbered channels represent the easterly velocities.

This file must not already exist.

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

ON: Turns the monitor ON (default)
OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

INSGEODISP computes the vertical and eastly velocities (meters per year) from interferometric stacks with differing viewing geometries (usually ascending and descending). The output file (filo) contains:

Vertical Velocity (m/yr)
Eastwardly Velocity (m/yr)
Repeats above for each DateTime
...

Option specifies DateTimes of interest.

INSGEODISP accepts stacks of interferograms generated by INSDMV.

This algorithm takes line of sight displacements along the look vectors and resolves the line of sight displacement vectors with the normalized vertical and east vectors as its basis. The Least Squares Method is used to solve the system to change of basis from the multiple look directions to their geodetic vertical and east components.

Examples

Generates vertical and easterly velocities (m/yr) for a single date, using a list of ASC and DSC interferograms.


EASI>MFILE="mfile.txt"                  !List of ASC and DSC displacements
EASI>OPTIONS="2017-03-15"                  !Specifying single date.
EASI>FILO="insgeodisp_single_date.pix"  !output file of raster layers
EASI>run INSGEODISP

Generates vertical and easterly velocities (m/yr) for an interval of dates and a step size of one month, using a list of stacks containing the ASC and DSC displacements.


EASI>MFILE="mfile.txt"                    !List of ASC and DSC displacements
EASI>OPTIONS="2017-03-15, 2018-03-15, 1.0m"  !Interval with step size 1 month.
EASI>FILO="insgeodisp_interval.pix"       !output file of raster layers
EASI>run INSGEODISP

Generates Vertical and Eastwardly velocities (m/yr) for dates from file, using a list of ASC and DSC interferograms.


EASI>MFILE="mfile.txt"                  !List of ASC and DSC displacements
EASI>OPTIONS="insgeodisp_DateTimes.txt" !File with specified DateTimes as above
EASI>DIMS=
EASI>FILO="insgeodisp_interval.pix"     !output file of raster layers
EASI>run INSGEODISP

Environments	PYTHON :: EASI
Quick links	Description :: Parameters :: Parameter descriptions :: Details :: Examples :: Related