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

insgeodisp(mfile, options, dims, filedem, filo)

Name	Type	Caption	Length	Value range
MFILE *	str	Input folder, or text file	1 -
OPTIONS	str	Options for DateTimes of Interest	0 -	Default:
DIMS	List[int]	Number of dimensions to output	0 -
FILEDEM *	str	File or folder containing the digital elevation model	1 -
FILO *	str	Database output file name	1 -

* 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.

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.

from pci.insgeodisp import insgeodisp

mfile   =  "mfile.txt"                    #List of ASC and DSC displacements
options  = "2017-03-15T15:08:59.512Z"         #Specifying single date.
dims     = [2]
filo    =  "insgeodisp_single_date.pix"   #output file of raster layers

insgeodisp(mfile, options, dims, filo)

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.

from pci.insgeodisp import insgeodisp

mfile   =  "mfile.txt"                  #List of ASC and DSC displacements
options = "2017-03-15, 2018-03-15, 1.0m"   #Interval with step size 1 month.
dims    = []
filo    =  "insgeodisp_interval.pix"    #output containing the raster layers

insgeodisp(mfile, options, dims, filo)

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

from pci.insgeodisp import insgeodisp

mfile   =  "mfile.txt"                #List of ASC and DSC displacements
options = "insgeodisp_DateTimes.txt"   #File with specified DateTimes as above
dims    = [2]                             #Output 2 dimensional data
filo    =  "insgeodisp_fileDates.pix" #output file of raster layers

insgeodisp(mfile, options, dims, filo)

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