ANSI-C program: cc_monitoring.c
NAME
cc_monitoring - Classification of multiple input files using a
single threshold.
SYNOPSIS
cc_monitoring <nfiles> <f1> <f2> ...
<ras_out> <width> [cc_thresh] [start] [nlines]
[pixav_x] [pixav_y] [LR]
| <nfiles> | number of input data files |
| <f1> | 1. input data file (float) |
| <f2> | 2. input data file (float) |
| ... | further input files (float) |
| <ras_out> | output 8-bit image file (SUN raster: *.ras, BMP image format: *.bmp) |
| <width> | number of samples/row |
| [cc_thresh] | classification threshold (default=0.5) |
| [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
cc_monitoring 3 1825_1868.cc 1868_1911.cc 1911_1954.cc
cc_out.ras 2500 0.5 1 0 3 3 -1
Generates a SUN raster or BP format image filewith 8 different classes (values), each corresponding to a specific series of coherence below or above the indicated threshold 0.5.
INSTALLATION
Source code cc_monitoring.c in ./src. For compilation adjust and
use Makefile: Executable version cc_monitoring 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
A simple classification based on a number of input data files of
type float and a single threshold value is conducted. For each
pixel the algorithm determines if the values of the different
input files is above or below the indicated threshold. For 3
input files, for example this leads to 2^3=8 classes or more
general for n input files to 2^n classes.The algorithm can be
used to monitor change. A classification based on multi-temporal
backscatter or coherence data contains, for example, information
on freezing, farming activities, snow cover and so on. The
information content and the interpretation of the classification
result depend on the sensor and data selection as well as scene
properties.
OPTIONS
Multi-looking in range and/or azimuth direction may be performed
before the classification.The output image may be left/right
flipped to generate a geometry corresponding better to the
natural geometry.The relation between the output colors and the
classes is written to the screen. In general, the class numbering
corresponds to binary numbers with a value above the threshold
corresponding to a 1 and a value below the threshold
corresponding to a 0. A sequence 101 (above,below,above), for
example, corresponds to the fifth class (value 5 in the output
image) and is represented by magenta color corresponding to
red:255, green:0, and blue:255.
SEE ALSO
display.h, rasterfile.h, bmp_image.h
DIAGNOSTICS
All messages are generally self-explanatory.
NOTES
none.
© Copyrights for Documentation, Users Guide and Reference Manual by Gamma Remote Sensing, 2000.
UW, CW, last change 24-Jan-2000.