Gamma LAT: Reference Manual

comb_hsi

ANSI-C program: comb_hsi.c

NAME
comb_hsi - Combines hue/saturation from one image file with the intensity from a second image file. The format of the input and output data can be either SUN raster or BMP format.

SYNOPSIS
comb_hsi <ras1> <ras2> <ras_out>

<ras1>	input 8-bit SUN raster/BMP image file (HUE+ SATURATION) (SUN raster: .ras, BMP image format: .bmp)
<ras2>	input 8-bit SUN raster/BMP image file (INTENSITY) (SUN raster: .ras, BMP image format: .bmp)
<ras_out>	output 24-bit SUN raster/BMP image file (INTENSITY) (SUN raster: .ras, BMP image format: .bmp)

EXAMPLE
comb_hsi cc123.ras pwr_ave.ras cc123_pwr.ras

Combines the color of the multi-temporal coherence (24-bit SUN raster cc123.ras) with the average intensity (8-bit SUN raster pwr_ave.ras).

comb_hsi 1868_1911.landuse.ras pwr_ave.ras landuse_pwr.ras

Combines the color of the landuse classification from the 8-bit SUN raster 1868_1911.landuse.ras with the average intensity from the 8-bit SUN/BMP raster file pwr_ave.ras.

INSTALLATION
Source code comb_hsi.c in $LAT_HOME/src. For compilation adjust and use Makefile: Executable version comb_hsi in ../bin

AVAILABILITY
Uses display programs definition file display.h, SUN raster file definition file rasterfile.h, and BMP format definition file, bmp_image.h

DESCRIPTION
comb_hsi supports the visualization of data by combination of 2 image files in SUN raster or BMP format. The hue/saturation/intensity (HSI) of the output image correspond to the hue/saturation of the first and the intesnity of the second input image.

Input images can have an image depths of 8 or 24 bits. The color tables of the input data are used to map the DN values in the file to RGB values. The hue and saturation values of the first input image are combined with the intensity of the second input image, converted back to RGB and written to the output file.

The output image files have 24 bit depth. The program shareware program xv or the LAT program ras_ras.c may be used to convert image formats between SUN raster and BMP.

OPTIONS
A large variety of programs for the generation of the two input SUN rasterfiles are available. (see for example LAT_reference_manual.

SEE ALSO
display.h, rasterfile.h, bmp_image.h

DIAGNOSTICS
All messages are generally self-explanatory.

NOTES
It is asssumed that the 2 input image files are co-registered and of the same dimensions. No multi-looking, image flipping, or image sub-section selection functions are available in the program.