ANSI-C program: image2pt.c
NAME
image2pt - generate point list of all non-zero pixels of 2-D data
file
SYNOPSIS
image2pt <f_in> <width> <plist>
<rlks> <azlks> <type>
| <f_in> | (input) 2-D image data file (various types supported) |
| <width> | number of samples/row of f_in |
| <plist> | (output) point list of coordinates of all non-zero points (int) |
| <rlks> | range looks of f_in relative to SLC reference (default -: 1) |
| <azlks> | azimuth looks of f_in relative to SLC reference (default -: 1)) |
| <type> | data type (0:fcomplex 1:scomplex 2:float 3:int 4:short 5:byte 6:SUN/BMP raster) |
EXAMPLE
image2pt testsite.mask.ras 1000 testsite.plist 1 5
6
Generates a point list of coordinates with a point for each non-zero pixel of the input image (testsite.mask.ras). The input image geometry corresponds to the SLC reference geometry multi-looked in range and azimuth (indicated look numbers).
INSTALLATION
Source code image2pt.c in ./IPTA/src, executable version image2pt
in ./IPTA/bin
DESCRIPTION
In the IPTA point lists contain the coordinates (range and
azimuth pixel number relative to the reference SLC geometry) of
the selected points. Data at these points (SLC values,
interferogram values, ...) are stored in point data stacks with
each record corresponding to a different SLC or interferogram.
The point data stack of mask values contains for each point a
flag (0 or 1) which indicates if the data of a point are
considered (1) or not considered (0).
image2pt supports the generation of point lists. A point list of coordinates with a point for each non-zero pixel of the input image (testsite.mask.ras) is created. The input image geometry corresponds to the SLC reference geometry multi-looked in range and azimuth (indicated look numbers).
When using a multi-looked image only one point is written to the point list. This means that in areas of non-zero image values the points in the list will have a range and azimuth sampling correspoding to the range and azimuth look numbers.
image2pt supports for example the generation of point lists which include all points for a specific area of the image, as may be required for an in depth investigation. On the other hand classification tools and interactive tools can be used to tune the input data file to generate user-defined point lists.
Other programs to generate new point lists are mkgrid, merge_pt, prox_pt, pwr_stat, and sp_stat.
Programs to validate existing point lists are qc_pt and expand_pt.
OPTIONS
none.
SEE ALSO
expand_pt, merge_pt, mkgrid,
prox_pt, pwr_stat, qc_pt,
sp_stat, SLC_par, typedef_ISP.h, ipta.h.
© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2003.
UW, CW, TS, last change 20-Feb-2003.