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

prox_prt

ANSI-C program: prox_prt.c

NAME
prox_prt - print data stack elements close to a particular location to ASCII file

SYNOPSIS
prox_prt <plist> <pmask> <pdata> <cr> <cl> <dr> <dl> <np_max> <type> [output] [rec_num] [n_rec]

<plist>	(input) point list (int)
<pmask>	(input) point data stack of mask values (uchar, set to - to accept all points)
<pdata>	(input) point data stack (various types supported)
<cr>	area center range coordinate (beginning with 0)
<cl>	area center azimuth line number (beginning with 0)
<dr>	area range search width (cr-dr,cr+dr), enter - for the entire image width
<dl>	area azimuth line number search window (cl-dl,cl+dl), enter - for all lines
<np_max>	maximum number of nearest points to include, enter - for all
<type>	data type (0:fcomplex 1:scomplex 2:float 3:int 4:short 5:byte 7:position 8:coordinates(int))
[output]	(output) ascii file (enter - for output to stdout)
[rec_num]	starting record number (default=1, starting with 1)
[n_rec]	number of records to display (default= to end of stack)

EXAMPLE
prox_prt testsite.plist testsite.pmask testsite.punw 214 712 50 250 20 2 testsite.unw.txt

Reads the input point list, searches the 20 valid points which are closest to the indicated coordinate, and writes out the corresponding values from the input point data stack to the output ascii file.

prox_prt testsite.plist testsite.pmask testsite.punw 214 712 50 250 20 2 - 1 25

Reads the input point list, searches the 20 valid points which are closest to the indicated coordinate, and writes out the corresponding values of records 1 to 25 from the input point data stack to standard output.

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

DESCRIPTION
prox_prt extracts values of points close to an indicated coordinate from a point data stack and writes these out to a text file or standard output.

For the center of the search the range and azimuth coordinate (relative to the reference SLC geometry) are indicated. The search area can further be limited by indicating a maximum distance in range pixels and azimuth lines.

prox_prt searches all valid points of the input point list in the indicated search area, orders these by increasing distance from the area center, and determines the nearest points up to the indicated maximum number.

The optional mask file indicates for each point if it is valid (1, i.e. considered) or not volid (0, excluded).

For these closest points the data values are extracted from the indicated records of the point data stack and written out to an ascii file or standard output. The point indices begin with 0. Point coordinates are specified such that the x and y position coordinates begin with 0.

OPTIONS
none.

SEE ALSO
ipta.h.