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

vu_disp

ANSI-C programs: vu_disp.c

NAME
vu_disp - Display point deformation time-series using a raster image for point selection

SYNOPSIS
vu_disp <plist> <pmask> <pSLC_par> <itab> <pdisp> <pdef> <pdhgt> <psigma> <pmap> <ras> [ymin] [ymax] [mag] [win_sz]

<plist>	(input) point list (int)
<pmask>	(input) point data stack of mask values (uchar, set to - to accept all points)
<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)
<pdisp>	(input) displacement (m) for each point and each layer in the stack (float)
<pdef>	(input) point data stack of linear deformation rate (m/year, float)
<pdh>	(input) point data stack of height correction value (m, 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)
<ras>	(input) raster reference image with PT locations marked (SUN .ras, or BMP .bmp)
[ymin]	(input) plot display minimum (enter - for default = -0.03)
[ymax]	(input) lot display maximum (enter - for default = +0.03)
[mag]	zoom magnification factor (default=3)
[win_sz]	zoom window size before magnification (default=128)

EXAMPLE

vu_disp pt_1.6 pmsk2 pSLC_par itab pdisp_los3 pdef2 phgt3 psigma2 - pdef3.ras -.06 .06

Displays the deformation of data in the slant range SAR geometry. The user selects points displayed in the image pdef3.ras and the deformation history is shown in a plot window. If the user depressess the write point button the the plot and deformation data are saved to files p*.txt and p*.jpg where * is the point number.

vu_disp pt_1.6_utm.coord pmsk2 pSLC_par itab pdisp_los3 pdef2 phgt3 psigma2 pt_1.6_utm pdef3_utm.ras -.06 .06

Displays the deformation histories of individual points in the map UTM geometry using xmgrace. The user selects points displayed in the image pdef3_utm.ras and the deformation history is shown in a plot window. If the user depressess the write point button the the plot and deformation data are saved to files p*.txt and p*.jpg where * is the point number. The easting and northing of the points stored in the file p_1.6_utm is added to the annotation both in the plot and in the txt file.

INSTALLATION

The Gnuplot program must be installed (version > 4.4, 4.6 preferred) to support plot generation.

DESCRIPTION

Plots the deformation time series of points selected using a reference image. The reference image is in Sun raster or BMP format with the points marking the pixels contained in the point list. The user can select a points for analysis by clicking them with mouse button 1. The point closest to the clicked location is selected if it is closer than 5 pixels.

The coordinates of the point, both in the reference image on the screen, and in the point list are then displayed in the application window. Deformation values are plotted versus delta-time in the Gnuplot plot window, where the delta-time values have been calculated from the SLC parameter data and interferogram table (itab) files. The values of the linear deformation rate, height , and northing and easting of the point, and the deformation history are displayed in the terminal window.

By depressing the write point button in the display window the user can store the point deformation history, annotation, and a PNG format image of the plot. Below is an example of the text file output for a single point. At the beginning are the important parameters for the point location and altitude given in keyword:value format. The deformation history is written out in 4 columns:

epoch index
epoch of the measurement in ISO 8601 format YYYY-MM-DDTHH:MM:SS.SSS
time in days since 1-Jan-1970
phase or deformation history

file:    p9699.txt

        point:       9699

        x_pixel:      310

        y_pixel:      253

        east:    252944.453

        north:  3946231.000

        height:   114.2966 m

        deformation_rate: -9.37873e-02  m/year

        phase_sigma:     1.4568  rad

           0  2002-02-20T13:59:26.981  
        11738.58295   0.00000e+00

           1  2002-03-16T13:59:21.980  
        11762.58289   3.91618e-02

           2  2002-04-09T13:59:22.914  
        11786.58290   1.48124e-02

           3  2002-05-03T13:59:23.412  
        11810.58291  -1.68577e-02

           4  2002-05-27T13:59:20.941  
        11834.58288  -1.47504e-02

           5  2002-07-14T13:59:19.202  
        11882.58286  -7.45409e-03

           6  2002-08-07T13:59:15.395  
        11906.58282  -8.16142e-03

           7  2002-08-31T13:59:14.403  
        11930.58281  -3.87606e-02

           8  2002-09-24T13:59:12.963  
        11954.58279  -3.74278e-02

           9  2002-10-18T13:59:11.954  
        11978.58278  -3.40827e-02

          10  2002-11-11T13:59: 9.895  
        12002.58275  -4.95644e-02

          11  2002-12-29T13:58:59.573  
        12050.58263  -6.05509e-02

          12  2003-01-22T13:58:56.732  
        12074.58260  -9.03066e-02

          13  2003-03-11T13:58:56.559  
        12122.58260  -1.09059e-01

          14  2003-04-04T13:58:52.594  
        12146.58255  -1.16364e-01

          15  2003-04-28T13:58:49.259  
        12170.58251  -1.12930e-01

          16  2003-05-22T13:58:50.797  
        12194.58253  -1.09981e-01

          17  2003-06-15T13:58:48.641  
        12218.58251  -1.41443e-01

          18  2003-07-09T13:58:42.132  
        12242.58243  -1.34967e-01

          19  2003-08-02T13:58:42.670  
        12266.58244  -1.46865e-01

          20  2003-08-26T13:58:41.440  
        12290.58242  -1.87127e-01

          21  2003-09-19T13:58:39.028  
        12314.58240  -1.81534e-01

          22  2003-10-13T13:58:36.515  
        12338.58237  -1.84052e-01

          23  2003-11-06T13:58:34.050  
        12362.58234  -1.58334e-01

          24  2003-11-30T13:58:33.235  
        12386.58233  -1.92379e-01

          25  2003-12-24T13:58:30.592  
        12410.58230  -1.69473e-01

          26  2004-01-17T13:58:24.932  
        12434.58223  -1.70627e-01

          27  2004-02-10T13:58:22.597  
        12458.58221  -1.92817e-01

An example of the output plot for this deformation history is shown here:

SEE ALSO
dispmap_pt, vu_disp2d