GAMMA Interferometric Point Target Analysis Software (IPTA): Reference Manual

disp_prt

ANSI-C programs: disp_prt.c

NAME
disp_prt - generate point displacement histories in text format

SYNOPSIS
disp_prt <plist> <pmask> <plist_txt> <pSLC_par> <itab> <pmap> <phgt> <pdef> <psigma> <pdisp> <items> <output>

<plist>	(input) point list (int)
<pmask>	(input) point data stack of mask values ( set to - to accept all points)
<plist_txt>	(input) text list of points to print out (enter -: all points) consists of a single column list of point indices to print out values
<pSLC_par>	(input) stack of SLC/MLI parameters (binary)
<itab>	(input) table associating interferogram stack records with pairs of SLC stack records (ascii) (line entries are: pSLC_rec1 pSLC_rec2 pINT_rec switch_flag)
<pmap>	(input) point positions in map proj. coord. (easting, northing or lat,lon) (enter - for none) (float)
<phgt>	(input) (input) point data stack of height (m, float)
<pdef>	(input) point data stack of linear deformation rate (m/year, float)
<psigma>	(input) point data stack of phase standard deviation from fit (float)
<pmap>	(input) point positions in map proj. coord. (easting, northing or lat,lon) (enter - for none) (float)
<pdisp>	(input) displacement (m) for each point and each layer in the stack (float)
<item_list>	(output) column heading information (text)
<disp_tab>	(output) displacement time series output (text)

EXAMPLE

disp_prt pt_utm.coord pmsk2 - pSLC_par itab pt_utm phgt3 pdef3 psigma2 pdisp_los3 item_list disp_los3.txt

Generates a text file containing the deformation history of all the points that have not been masked out by pmsk2.

INSTALLATION
Source code disp_prt.c in ./IPTA/src, executable version disp_prt in ./IPTA/bin. The xmgrace program, part of the grace software package must be installed.

DESCRIPTION
The program disp_prt.c is used to generate text file containing the deformation histories of points generated using the IPTA software. The output file consists of rows containing the displacement time series for a single point. The different columns pertain to the parameters as shown below in Table 1. An example displacement time series file is shown in Table 2. where only the first 12 values of the displacement time series are shown for a small subset of the points. Addtional data displayed on the line include the x and y pixel locations of the point as specified in the point list, the point number, the geographic coordinates in easting and northing (lat/lon in the case of no map projection), altitude, linear deformation rate, phase standard deviation in the IPTA phase regression. For each column containing the displacement information, the items_list specifieds the date, Julian day (JD) and the number of days relative to the reference frame.

   1 
        point number

           2  x pixel

           3  y pixel

           4  east coordinate

           5  north coordinate

           6  height (m)

           7  deformation rate (m/y)

           8  phase sigma (rad)

           9  displacement date: 1997  5
        31  JD: 2450600  delta: -700

          10  displacement date: 1997  7 
        5  JD: 2450635  delta: -665

          11  displacement date: 1997  8 
        9  JD: 2450670  delta: -630

          12  displacement date: 1997  9 13 
        JD: 2450705  delta: -595

          13  displacement date: 1997 10 18  JD:
        2450740  delta: -560

          14  displacement date: 1997 11 22  JD:
        2450775  delta: -525

          15  displacement date: 1997 12 27  JD:
        2450810  delta: -490

          16  displacement date: 1998  1 31 
        JD: 2450845  delta: -455

          17  displacement date: 1998  3 
        7  JD: 2450880  delta: -420

          18  displacement date: 1998  4 11 
        JD: 2450915  delta: -385

          19  displacement date: 1998  5 16 
        JD: 2450950  delta: -350

          20  displacement date: 1998  6 20 
        JD: 2450985  delta: -315

          21  displacement date: 1998  7 25 
        JD: 2451020  delta: -280

          22  displacement date: 1998 10  3 
        JD: 2451090  delta: -210

          23  displacement date: 1998 11  7 
        JD: 2451125  delta: -175

          24  displacement date: 1998 12 12  JD:
        2451160  delta: -140

          25  displacement date: 1999  1 16 
        JD: 2451195  delta: -105

          26  displacement date: 1999  5 
        1  JD: 2451300  delta: 0

          27  displacement date: 1999  6 
        5  JD: 2451335  delta: 35

          28  displacement date: 1999  7 10 
        JD: 2451370  delta: 70

          29  displacement date: 1999  8 14 
        JD: 2451405  delta: 105

          31  displacement date: 1999 11 27  JD:
        2451510  delta: 210

          32  displacement date: 2000  2 
        5  JD: 2451580  delta: 280

          33  displacement date: 2000  3 11 
        JD: 2451615  delta: 315

          34  displacement date: 2000  4 15 
        JD: 2451650  delta: 350

          35  displacement date: 2000  9 
        2  JD: 2451790  delta: 490

          36  displacement date: 2000 12 16  JD:
        2451895  delta: 595

Table 1

  329204    1224    2366   379995.625  3739557.250     27.765  2.1140e-03  0.2716 -0.0037 -0.0032  0.0011 -0.0009  0.0011 -0.0020 -0.0039 -0.0028 -0.0072 -0.0078 -0.0099
  329205    1222    2366   379978.562  3739561.000     27.426  1.7759e-03  0.2633 -0.0031 -0.0026  0.0018 -0.0002  0.0014 -0.0014 -0.0033 -0.0024 -0.0070 -0.0075 -0.0096
  329206    1222    2366   379974.062  3739562.000     20.848  1.7780e-03  0.2460 -0.0029 -0.0024  0.0018 -0.0002  0.0011 -0.0013 -0.0031 -0.0024 -0.0070 -0.0078 -0.0096
  329207     902    2296   376779.438  3740257.000     42.905  1.5613e-03  0.2833 -0.0023 -0.0020 -0.0010 -0.0010 -0.0030 -0.0020 -0.0023 -0.0030 -0.0024 -0.0038 -0.0031
  329208     891    2294   376668.969  3740281.000     45.206  3.1304e-03  0.2871 -0.0050 -0.0054 -0.0031 -0.0034 -0.0051 -0.0042 -0.0054 -0.0047 -0.0040 -0.0054 -0.0047
  329209     876    2290   376511.000  3740315.250     44.945  3.8924e-03  0.3086 -0.0070 -0.0063 -0.0046 -0.0062 -0.0059 -0.0039 -0.0052 -0.0052 -0.0042 -0.0054 -0.0060
  329210     875    2290   376507.000  3740316.250     37.552  1.9631e-03  0.3049 -0.0033 -0.0027 -0.0013 -0.0031 -0.0028 -0.0011 -0.0025 -0.0027 -0.0020 -0.0033 -0.0042

Table 2

OPTIONS
The user can specify a text list of point numbers to generate output displacement time series. If a - is entered for the plist_txt file, then all points not masked out by pmask will be processed.

SEE ALSO

dispmap_pt, vu_disp