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

dis_data

ANSI-C programs: dis_data.c

NAME
dis_data - display point-based data as a time series.

SYNOPSIS
dis_data <plist> <pmask> <pSLC_par> <itab> <nstack> <pdata1> ... <pdata_type> <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)
<nstack>	number of point data stacks
<pdata1>	(input) point data stack (fcomplex or float)
...	(input) sequence of remaining data stacks
<pdata_type>	data type (0:float 1:fcomplex, default=0: float)
<ras>	(input) raster reference image with PT locations marked (SUN .ras, or BMP .bmp)
[ymin]	(input) plot display minimum (enter - for default = -PI)
[ymax]	(input) plot display maximum (enter - for default = +PI)
[mag]	zoom magnification factor (default=3)
[win_sz]	zoom window size before magnification (default=128)

EXAMPLE
dis_data pt0 pmask ppar itab pdef_unw0 0 pt0.ras

Displays the SUN/BMP rasterfile pt0.ras showing the point locations, and plots the data as a time series using xmgrace

INSTALLATION
Source code dis_data.c in ./IPTA/src, executable version dis_data in ./IPTA/bin

DESCRIPTION
Plots the data values of one or more data stacks as time series at locations selected using the reference image. The reference image is in Sun raster or BMP format with the points marking the pixels contained in the plist. The user can select a point for analysis by clicking on the point 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 plist are then displayed in the application window. Values from the different data stacks are plotted versus delta-time in the xmgrace plot window, where the delta-time values have been calculated from the SLC parameter data and itab files. The specific data values in the input data stack are also written to stdout, which by default is the terminal window.

Either fcomplex or float data stacks can examined as specified by the pdata_type command line parameter. In the case of fcomplex format data, the phase is first calculated and then plotted. In the case of a single layer in the stack, the plot is not generated and the value is shown in the application window that is associated with the selected point.

This program can be used to display the time history of deformaton for individual points generated using the program dispmap_pt.

OPTIONS
Individual plots can be saved or printed using the xmgrace functionality. The plot can also be zoomed or transformed in various ways, as described in the xmgrace documentation.

SEE ALSO
dispmap_pt