ANSI-C program: ras_data_pt.c
NAME
ras_data_pt: draw data values at point list locations on a
SUN/BMP raster image
SYNOPSIS
ras_data_pt.exe <plist> <pmask>
<pdata1> <rec_num> <nrec> <ras_in>
<ras_out> <type> <rlks> <azlks> [cycle]
[bx]
| <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 formats supported) |
| <rec_num> | starting record number in pdata, starting with 1 |
| <nrec> | number of records to display (enter - for remainder of stack) |
| <ras_in> | (input) raster image (SUN raster or BMP format) |
| <ras_out> | (output) output raster file name template, example: diff0/pdiff0 |
| <type> | pdata type (0:fcomplex 2:float) |
| [rlks] | range looks of raster image relative to point coordinates (default=1.0) |
| [azlks] | azimuth looks of raster image relative to point coordinates (default=1.0) |
| [cycle] | data value per color cycle (default = TWO_PI) |
| [bx] | size of square in pixels, set to 1 for single points (default: 1) |
EXAMPLE
ras_data_pt pt_lh pmsk0 pdiff3u 1 -
rmli_2_3/rmli_2_3.ave.ras diff3u/pdiff3u 2 2 3 12.56
1
display all the layers of the float data stack pdiff3u
using rmli_2_3/rmli_2_3.ave.ras as the backdrop.
There are 2 range looks and 3 azimuth looks for the backdrop
image relative to the SLC. The color wrap is 12.56. Output images
are in the diff3u directory (created beforehand). File names are
pdiff3u_001.ras, pdiff3u_002.ras...
ras_data_pt pt_map_lh pmsk3 pdef4 1 1
rmli_2_3/rmli_2_3_utm.ave.ras def4_map/pdef4_map 2 1 1 .2
1
Display a single layer point data file pdef4 using 1
look in range and azimuth. The image rmli_2_3_utm.ave.ras is the
backdrop. Point data are displayed with a color cycle fo .2. The
output raster image file is called pdef4_map_001.ras
INSTALLATION
Source code ras_data_pt in ./IPTA/src, executable version
ras_data_pt in ./IPTA_v1.x/bin
DESCRIPTION
ras_data_ptsupports
generation of 8-bit SUN/BMP raster images of real or
complex-valued data stack values. The data values are displayed
as the color of a rectangle, located at the point positions
specified in the plist. The intensity of the
rectangle is constant at all points. The point data
are displayed as a rectangle with size specified on the command
line (default = 1). The wrap of the color scale is specified by
the command line "cycle" parameter. The number
of looks in range and azimuth of the background image
relative to the point coordinates in the point list is specified
by the rlks and azlks parameters. The type parameter specifies if
the input data stack values are float or complex. If complex, the
phase of the complex number is displayed in the color of
the rectangle.
This program displays the data stack values very rapidly since there is no recalculation of the background raster image, or generation of a raster version of the point data prior to display. The point data values are directly displayed on the background image.
The root name of the output image series is specified on the command line. The out image series are numbered sequentially starting with the value of the rec_num command line parameter.
SEE ALSO
ipta.h, ras_data_pt.c