Gmma DISP Package: Reference Manual


rasdt_pwr24

ANSI-C program: rasdt_pwr24.c

NAME
rasdt_pwr24 - generate 24-bit SUN/BMP raster file of float parameter (e.g. deformation) + intensity image

SYNOPSIS
rasdt_pwr24 <data> <pwr> <width> [start_data] [start_pwr] [nlines] [pixavr] [pixavaz] [cycle] [scale] [exp] [LR] [rasf] [cc] [start_cc] [cc_min]

<data> (input) real valued image (float, e.g. deformation rate, terrain height)
<pwr> (input) intensity image (enter - for none, (float))
<width> number of samples/row of data and pwr
[start_data] starting line of data (default=1)
[start_pwr] starting line of pwr (default=1)
[nlines] number of lines to display (default=0: to end of file)
[pixavr] number of pixels to average in range (default=1)
[pixavaz] number of pixels to average in azimuth (default=1)
[cycle] data value per color cycle (default = 0.002)
[scale] pwr display scale factor (default=1.)
[exp] pwr display exponent (default=.35)
[LR] left/right flipping flag, (default=1: normal, -1: mirror image)
[rasf] (output) 24-bit rasterfile (enter - for default=*.ras: SUN raster format, *.bmp: BMP format)
[cc] display threshold data file (float, e.g. correlation)
[start_cc] starting line of cc data file (default=1)
[cc_min] pixels with cc values below cc_min are displayed using greyscale (default=.2)

EXAMPLE

rasdt_pwr24 19960421_19960422.def 19990421.rmli 1000 1 1 0 1 1 .01 0.8 .35 1 19960421_19960422.def.ras

Generates an 24-bit SUN raster file of the real valued deformation (in m/year) rates using the backscatter intensity image for the image brightness and a colors with a cycle corresponding to 1 cm/year for the deformation.

DESCRIPTION
rasdt_pwr24 supports the generation of a 24-bit SUN/BMP raster file image of a real valued image displayed in color and the image brightness corresponding to a backscatter intensity image.

In the frame of an IPTA investigation the use of a 24-bit SUN/BMP raster file may be an advantage due to the higher visibility of fine details in the color (deformation rate, height, ...) and intensity information.

For areas of low coherence (below the indicated threshold), the color is suppressed and the corresponding intensity is displayed in grey. This avoids the high "color noise" of low coherence areas.

If a minus - is specified for the intensity image, then the background image will be 0 where the input data is 0, otherwise a constant intensity image is generated of the parameter.

This program can also be used to display unwrapped phase by setting the cycle parameter to be multiples of 2PI (6.28, 12.56...). Areas where data=0 are
display the background image intensity in greyscale.

Optionally, a sub-section of the entire image, multi-looking in range and azimuth direction, or a left/right flipping are supported.

Note that all pixels with non-zero data value have non-zero RGB values in the output image so that "no data" is represented by RGB=0,0,0. If the image is converted to PNG or other format that supports transparency, 0,0,0 pixels can then  be marked  transparent. Using the Imagemagick convert utility:

convert -transparent=black 19960421_19960422.def.ras 19960421_19960422.def.png

will generate a PNG format image with regions with no data marked

SEE ALSO
rasmph_pwr24, http://www.imagemagick.org/script/index.php


© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2011.
UW, CW, TS, last change 13-Jul-2011.