INSSTACK

Description

INSSTACK generates velocities, displacements, or cumulative displacements for non-overlapping time steps corresponding to consecutive SAR acquisition times. INSSTACK supports line-of-sight measurements (LOS) from single stack output and geodetic (vertical, longitudinal (east/west)) from multi-stack output.

Parameters

Name	Type	Caption	Length	Value range
FILI*	String	Database input file name	1 - 192
OQUANT	String	Output quantity	0 - 192	VEL | DISP | CDIS | AVER Default: CDIS
DISPDIR	String	Displacement direction	0 - 192	LOS | VERT | LONG Default: LOS
DUNITS	String	Distance units	0 - 192	MM | CM | M | IN | FT Default: M
TUNITS	String	Time units	0 - 192	DAT | YEAR Default: YEAR
FILO*	String	Database output file name	1 - 192
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

The name of the file containing the single stack LOS displacements from INSDMV or decomposed multi-stack displacements generated by INSGEODISP. The displacement values must be written in meters.

OQUANT

Specifies the output parameter.

DISPDIR

DUNITS

The distance units used to measure the displacement.

TUNITS

The time units used to measure the time interval used for velocity estimates. This unit is also used as the X axis by the InSAR temporal chart tool.

FILO

The name of the output PCIDSK (.pix) which will contain the estimated displacements, cumulative displacements, or velocities corresponding to the time intervals bracketed by the temporally ordered acquisition dates.

The specified output 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

INSSTACK reads the stack of temporally ordered, non-overlapping displacements corresponding to each acquisition interval and converts them to velocity, displacement, or cumulative displacement in user defined units. For single stack input generated by INSDMV the output is written in the line-of-sight (LOS) direction. For multi-stack input generated by INSGEODISP, the output may be written in the vertical direction (up is positive) or the longitudinal direction (east is positive). If OQUANT is set to CDIS, the cumulative displacement for each layer is written. If OQUANT is set to AVER, the output will consist of a single layer of average velocity. The average velocity is calculated as the cumulative displacement divided by the reference stack time interval. The units selected for DUNITS and TUNITS are also used as the X and Y axis by the InSAR temporal chart tool.

Examples

The following example reads the file of temporally ordered, non-overlapping, LOS displacements generated by INSDMV to provide temporally ordered layers of LOS velocity. The output will be measured in centimeters per year.

EASI>FILI="D:\INSDMV_Displacements.pix"          ! output from INSDMV
EASI>OQUANT="VEL"                                ! line of sight measurements
EASI>DISPDIR= "LOS"                              ! LOS measurement
EASI>DUNITS="CM"                                 ! distance unit = cm
EASI>TUNITS="YEAR"                               ! temporal unit = year
EASI>FILO="D:\Velocity.pix"                      ! name of output file
EASI>run INSSTACK
      

The following example uses the output from INSGEODISP generate cumulative vertical (up positive) displacement in millimeters.

EASI>FILI="D:\INSGEODISP_Displacements.pix"      ! output from INSDMV
EASI>OQUANT="CDISP"                              ! cumulative measurements
EASI>DISPDIR= "VERT"                             ! vertical measurement
EASI>DUNITS="MM"                                 ! distance unit = mm
EASI>TUNITS="YEAR"                               ! temporal unit = year
EASI>FILO="D:\Vertical.pix"                      ! name of output file
EASI>run INSSTACK
      

The following example uses the output from the same INSGEODISP file to generate cumulative longitudinal (east positive) displacement in millimeters.

EASI>FILI="D:\INSGEODISP_Displacements.pix"      ! output from INSDMV
EASI>OQUANT="CDISP"                              ! cumulative measurements
EASI>DISPDIR= "LONG"                             ! longitudinal (e/w) measurement
EASI>DUNITS="MM"                                 ! distance unit = mm
EASI>TUNITS="YEAR"                               ! temporal unit = year
EASI>FILO="D:\Vertical.pix"                      ! name of output file
EASI>run INSSTACK