ANSI-C program: ras_triangle.c
NAME
ras_triangle - draw Delauney triangulation net on a SUN/BMP
raster image
SYNOPSIS
ras_triangle <plist> <pmask> <ras_in>
<ras_out> [rlks] [azlks] [r] [g] [b] [zflg]
| <plist> | (input) point list (int) |
| <pmask> | (input) point data stack of mask values (uchar, set to - to accept all points) |
| <ras_in> | (input) SUN/BMP raster file (8 or 24 bits/sample, enter - for none) |
| <ras_out> | (output) SUN/BMP raster file with marked point list locations |
| [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) |
| [r] | cross color value red (0 --> 255, default: 255) |
| [g] | cross color value green (0 --> 255, default: 255) |
| [b] | cross color value blue (0 --> 255, default: 0) |
| [zflg] | zero out flag (default=0: retain values, 1: set all values to 0 except lines) |
EXAMPLE
ras_triangle testsite.plist - testsite.pwr.ras
testsite.pt.ras 1 5
Generates an 8-bit SUN rasterfile which corresponds to the input 8-bit SUN rasterfile testsite.pwr.ras except for yellow lines added to indicate the Delauney triangulation net for the coordinates of all points of the point list.
ras_triangle testsite.plist testsite.pmask testsite.rgb.ras testsite.pt.ras 1 5 255 0 0
Generates an 24-bit SUN rasterfile which corresponds to the input 24-bit SUN rasterfile testsite.rgb.ras except for red lines added to indicate the Delauney triangulation net for the coordinates of all valid points of the point list.
INSTALLATION
Source code ras_triangle.c in ./IPTA/src, executable version
ras_triangle 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 valid
(1) or not valid (0).
ras_triangle supports the generation of a SUN/BMP raster file image which shows the Delauney triangulation net for the coordinates of all valid points of the point list in the spatial context. As background the input SUN/BMP raster file is used.
For the input SUN/BMP raster file (in the "normal" 2-D raster image format) can either be in the SLC geometry used for the point list coordinates or in a multi-looked geometry (relative to the same SLC geometry, without offsets in range and azimuth).
The input SUN/BMP raster file can be 8-bit or 24-bit per sample. The output SUN/BMP raster file will be of the same type as the input SUN/BMP raster file. In the 8-bit case the color of the crosses is added to the color table. In the case of a full color table pixels belonging to color 255 are moved to color 254 and color 255 is used for the crosses.
For the crosses the color (red, green, blue values) and the size (in pixels) can be indicated.
Instead of using the input SUN/BMP raster file as background only the lines of the Delauney Triangulation net can be written to the output rasterfile if the zero out flag is set to 1.
OPTIONS
none.
SEE ALSO
ipta.h.
© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2003.
UW, CW, TS, last change 20-Feb-2003.