Creates a color classification map of a classified input image.
Creates a color classification map of a classified input image. The class assignments in the input image should be in the range of 1 to 32. Values greater than 32 are accepted by the program, but they will be set to black if a default Display Lookup Table File is used. For a user specified Display Lookup Table File (DLTF), the color classification will be assigned based on the Lookup Table (LUT) of the DLTF. In this case, the display of color palette shall be limited to 32 classes only. This color palette will be displayed vertically along the right side of the image. One input classification map produces a three-band classification map display output. The three bands are the red, green, and blue components of a full color display.
- IN
- Input image. It should be a single-band byte image with a possible range of pixel values from 1 to 32. For input image with pixel values greater than 32, user should specify a selected DLTF. Otherwise, default lookup table will set values greater than 32 to black. The pixel values should be consecutive. If a multi-band image is given, only the first band is used and an informational message is printed.
- OUT
- Output image. It is a three band byte image. The size of the image is determined by the truncation option, with the minimum size of 512x512 pixels.
- TRUNOPT("FILL" )
- Truncate option. Allows the user to influence the output image size selection. See User Note 4 for the five reserved image sizes.
= FILL: CLASSMAP will choose a reserved image size which is one step larger than the input image specification. Any excess in the output product is filled with zeros after the account of pixels for tick marks, annotation and color palette. = TRUNC: CLASSMAP will choose a reserved image size which is one step smaller than the input image specification. Any excess of the input image is truncated after the program has accounted pixels for tick marks, annotation and color palette.
- NCLASS(0)
- Number of classes. It is the number of classes (not exceeding 32) in the classified image. If NCLASS = 0, CLASSMAP will assign class names as class1, class2, etc. for up to 32 classes according to color assignments in the lookup table. If NCLASS is not 0, CLASSMAP will prompt the user NCLASS times for class names and their corresponding colors. It will also display the default color selection table to assist the user in the selection process.
- ANNOTE(--)
- Annotation text. Allows the user to add up to 62 characters of annotation at the bottom of the output classified map image. If not specified, this area on the output image will contain the first 62 characters of the input image name.
- INDLTF(--)
- Input Display and Lookup Table File. It should contain the lookup table to be used to color the classes in the image. Only used if the NCLASS parameter is defaulted to 0.
- DLTFENTR(--)
- Display and Lookup Table File Entry. Name of the lookup table entry in the Display and Lookup Table file.
Color Table
1: black 2: dkblue 3: blgreen 4: ltblue 5: dkgreen 6: medgreen 7: ltgreen 8: olive 9: purple 10: magenta 11: maroon 12: red 13: brown 14: orange 15: yellow 16: gray 17: pink 18: tan 19: sand 20: peach 21: dkgray 22: violet 23: medblue 24: aqua 25: white 26: spare 27: spare 28: spare 29: spare 30: spare 31: spare 32: spare ('spare' numbers are currently white)
1 type in [class name,color number]: NOSE,12 2 type in [class name,color number]: CLASS2,14 3 type in [class name,color number]: EYES,9
CLASSMAP creates a three-band image. Three classes, labeled as NOSE, CLASS2, and EYES are colored RED, ORANGE, and PURPLE, respectively. Remaining classes, if any, will be colored black.
CLASSMAP produces (per run) one size of display out of a possible five "reserve" display sizes. The active area of a film is a subset of the actual physical film size, and is the current maximum subarea in which a display may be exposed. Four of the reserve sizes that CLASSMAP uses, when transferred to film, use the maximum active area allowable for each film at the various micron settings.The size of the remaining after accounting for the area taken up by map, is the area remaining after accounting for the area taken up by annotation, color palette, and tick marking. Since the embedded image sizes are rather arbitrary, the selection of which reserve size to produce is made automatically by CLASSMAP. The user is able to influence that selection by using a window option and/or a TRUNOPT option. The automatic selection process and how it is influenced by the window option or TRUNOPT parameter is described below.
TRUNOPT = FILL (with a possible window option): l. Produces a reserve size where the input image size or the window of the input image is the same as or one step smaller than the reserve embedded image size. 2. If the input image size is smaller than the reserve embedded image size, the input image is placed in the upper-left corner of the embedded image area. The rest of the area contains fill. TRUNOPT = TRUNC (with a possible window option): 1. Produces a reserve size where the input image size (as determined from the data definition record) or the size specified by the window option is the same as or larger than the embedded image reserve size. 2. Places as much of the input image as possible into the embedded image area, starting at the upper-left corner of the input image or at the upper-left corner of the window of the input image. The remainder of the input image is truncated.The classes in the input image should range from 1 to 32. Each class is associated with a color (or more specifically the red, green, and blue components of that color) by means of a look-up table (LUT). This LUT is read from the Display and Lookup Table File, INDLTF. If INDLTF is not specified CLASSMAP uses a default table. This default table is listed in the User's Note 5.
If a non-zero value is specified for NCLASS, CLASSMAP will prompt the user NCLASS times for class names and their corresponding colors. Each class name may contain up to seven characters including blanks. A color selection table (the default assignments) is provided to assist the user in specifying colors. In this case, the parameters INDLTF and DLTFENTR are ignored. If NCLASS is defaulted (left at 0), CLASSMAP uses the names: CLASS1, CLASS2, etc, and colors either the default lookup table or a user-specified DLTF file. Class names appear in the color palette region of the output image. Class names assignment is limited to 32.
Input image must be a single band image. If a multi-band image is entered, only the first band will be used.
An invalid color number (> 32 or < 0) was specified Try again with the correct color number.
Classname and/or color number was entered improperly. Reenter data using commas as separators.
No intersection was found between the two window specifications.
This is a warning message that the user entered color and/or class specification incorrectly more than 3 times.
Input image entered is not of type byte. Rerun the program with an appropriate image.
Unable to read user specified lookup table. Reenter.
Picture description table contains invalid data.
If Display Lookup Table file is specified, the entry into the table must also be specified.
CLASSMAP cannot be run in batch mode when the parameter NCLASS is set to specify values interactively.
# of pixels # of lines
----------- ----------
1. 512 512
2. 1024 1024
3. 2048 2048
4. 4096 4096
5. 8192 8192
Table 1
Default Color Lookup Table
COLOR RED GREEN BLUE
BLACK 0 0 0
DKBLUE 0 0 255
BLGREEN 0 255 187
LTBLUE 0 221 255
DKGREEN 0 144 0
MEDGREEN 0 255 0
LTGREEN 148 255 148
OLIVE 176 255 0
PURPLE 187 0 153
MAGENTA 255 0 255
MAROON 148 0 0
RED 255 0 0
BROWN 128 72 72
ORANGE 255 96 0
YELLOW 255 255 0
GRAY 148 148 148
PINK 255 127 150
TAN 191 127 0
SAND 217 153 76
PEACH 221 170 85
DKGRAY 102 102 119
VIOLET 255 0 200
MEDBLUE 0 136 255
AQUA 0 255 255
WHITE 255 255 255
SPARE 255 255 255