Gamma LAT: Reference Manual

single_class_mapping

ANSI-C program: single_class_mapping.c

NAME
single_class_mapping - Generate a map of a single class based on co-registered multiple input files.

SYNOPSIS
single_class_mapping <nfiles> <f1> <lt1> <ut1> <f2> <lt2> <ut2> ... <ras_out> <width> [start] [nlines] [pixav_x] [pixav_y] [LR]

<nfiles>	number of input data files
<f1>	1. input data file (float)
<lt1>	lower threshold for file 1
<ut1>	upper threshold for file 1
<f2>	2. input data file (float)
<lt2>	lower threshold for file 2
<ut2>	upper threshold for file 2
...	further input files and thresholds
<ras_out>	output 8-bit SUN raster BMP format image file (SUN raster file: .ras, BMP file: .bmp)
<width>	number of samples/row
[start]	starting line (default=1)
[nlines]	number of lines to display (default: 0=to end of file)
[pixav_x]	number of pixels to average in range (default=1)
[pixav_y]	number of pixels to average in azimuth (default=1)
[LR]	left/right flipping flag (default: 1=normal, -1=mirror image)

EXAMPLE
single_class_mapping 2 1825_1868.cc 0.1 0.4 1825_1868.pwr1 0.05 0.12 1825_1868.forest.ras 2500 1 0 1 1 -1

Classifies the class (forest) with coherence values between 0.1 and 0.4 and backscatter intensities betwenn 0.05 and 0.12. The result is written to a SUN raster image.

INSTALLATION
Source code single_class_mapping.c in $LAT_HOME/src. For compilation adjust and use Makefile: Executable image of single_class_mapping is locateed in $LAT_HOME/bin.

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

DESCRIPTION
single_class_mapping provides a simple classification algorithm. Multiple input data sets are read and one class, specified by decision intervals for each input data set, is classified. The decision intervals are specified on the command line.The result of the classification is written to an 8-bit SUN raster or BMP format file with white color (value 1, color table values R=255, G=255, B=255) for the pixels belonging to the class versus black color (value 0, color table values R=0, G=0, B=0).

OPTIONS
The output image may be left/right flipped to generate a geometry corresponding better to the natural geometry. The program multi_class_mapping uses an input file specifying multiple thresholds for mapping more than 1 class at a time.

DIAGNOSTICS
All messages are generally self-explanatory.

NOTES
No filtering, averaging or multi-looking is performed by single_class_mapping. These processing steps are often esssential for the performence of a classification algorithm. Such processing steps have to be performed prior to the use of the classification with single_class_mapping.