ENVISION commands


PROGRAM NAME

spectrum - Interactive Image Classification System

DESCRIPTION

Spectrum is an interactive signal/image classification system. It aids the user in classifying image data. An image may be displayed, and then pixels in the image assigned to classes by holding the mouse button down and moving the pointer over the desired pixel in the image ("painting"). For identification, classes are given a name and an unique color. A class may contain as many pixels as desired; pixels may be moved from one class to another. When the classification procedure is complete, the image can be written out along with a legend file for later use.

A "Spectral Response Curve" provides a graph giving information about the map data (feature data) associated with a cluster. The "Legend Control" feature is used to modify the legend of classes; among other things, you may assign a color to a class, list the clusters contained in the class, empty a class of clusters, transfer an entire class into another one, create a "catch-all" class of remaining unclassified clusters, and hide selected classes from view in order to examine the image without their interference. A "Zoom" capability allows you to zoom in on the image; when the Update Mode is set to Button Press, clusters may be assigned to a class by "painting" on the zoom window rather than in the image.

Spectrum was specifically designed for images that have been pre-clustered, and therefore have additional information associated with them, this info being stored in the map data. This special info in the map data will include N rows of cluster centers (mean vectors), where each column of the info is associated with a special feature of interest that was extracted during the previously-used clustering algorithm. If you do NOT have pre-clustered data, spectrum can still be used to interactively classify the pixels in the image; however, if you do have pre-clustered images, there are additional features of spectrum that you may take advantage of:

\(bu display of different map columns as Red, Green, or Blue.
\(bu display of functions of map columns as Red, Green, or Blue (note: not implemented as of Khoros 2.0 Beta).
\(bu a 2D scatter plot where one map column provides the X coordinates, and another map column provides the Y coordinates; unassigned cluster numbers appear in white, while assigned cluster numbers appear in the same color as was specified for their class in the legend.
\(bu the same 2D scatter plot as above, but with specified functions of map columns providing the X and Y coordinates.

Please see the manual section on I/O if you have additional information associated with the input image provided by a clustering algorithm; this section details the input format expected by spectrum for such information. In addition, this section also details the ascii Legend File that is used with spectrum.

Spectrum is covered in detail in Chapter 8 of the Envision Manual; the information given there will not be repeated here, so you are referred to that document.

REQUIRED ARGUMENTS

none

OPTIONAL ARGUMENTS

-i
type: infile
desc: File containing input image
default: {none}
-l
type: infile
desc: File containing input legend
default: {none}
-t
type: infile
desc: File containing input display environment file
default: {none}
-p
type: infile
desc: File containing input predetermined classification file
default: {none}
-method
type: cycle
desc: Add/delete cluster method
default: 1 "Paint"
-priv
type: boolean
desc: Use private colormap?
default: false
-alloc
type: cycle
desc: Color allocation policy
default: 1 "Read Only"
-x
type: integer
desc: X location for GUI autoplacement
default: -1
bounds: -1 < [-x] < 1000
-y
type: integer
desc: Y location for GUI autoplacement
default: -1
bounds: -1 < [-y] < 1000
-update
type: float
desc: How often to check input file for modification
default: 1
bounds: value >= 0.0

EXAMPLES

% spectrum -i albq2.viff -l albq2.lgd

SEE ALSO

Spectrum is covered in Chapter 8 of the Envision Manual.

RESTRICTIONS

REFERENCES

Spectrum is covered in Chapter 8 of the Envision Manual.

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.