specmsk Documentation

specmsk - special masking procedure
specmsk - This program was written to serve a
special processing function for the production
of the Clementine multi-spectral cube data.

The algorithm is as follows:

The program assumes that a multi-band image
is being processed. If a pixel in a band
contains a valid value then the corresponding
pixels from the other bands are interrogated.
If any of the pixels from the other bands
contain a null value then the null value
is assigned the "specval" value provided
by user input.


This special value is inserted into the
image array for mosaic purposes. This
flag value will prevent overlapping areas
in a mosaic from being occupied by more
that one input image cube.

The step following a mosaic containing
the "special" pixel values will need
to be removed with the "SPECUNDO" program
after completion of the mosaic assembly.

The SPECVAL should be a value that is
either larger or smaller than any
valid pixel value so that it can
easily be removed by the SPECUNDO
program.

Programmer:  Eric Eliason, U.S.G.S., Flagstaff, AZ

Input cube file name
  (Default extension is .cub)

NONE

Input subcube specifier

--

Output cube file name
  (Default extension is .cub)

NONE

"Special" pixel value inserted
in image array

NONE

Comment for user

" "

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
SFROM	If the divisor band comes from the same cube as the dividend bands, it must be included in the subcube specifier. SFROM specifies the subcube using a single string for all three dimensions of the cube. The order of the three dimensions is always "samples:lines:bands". If a dimension is left blank, all the data for that dimension is selected. The default value of NULL for SFROM selects the entire cube. For example, "10-100(3):11,12,15-20:1-10(2)" will select every third sample starting with sample 10 thru 100; lines 11 and 12, and 15-20; and every other band, starting with band 1 thru 10. There are special characters that can be used for selecting a subcube efficiently, such as "*","#", and "~". For examples type "help sfrom" in TAE. **NOTE** For more examples and explanation of the many features of the SFROM parameter, tutor the sfrom.pdf or refer to Introduction to ISIS, Section 6, of the ISIS User's Manual **
TO	Output cube file name. If the file extension is omitted, then ".cub" will be assumed.
SPECVAL	The "special" pixel value acts as a flag to indicate that a pixel value is null, but has pixels from other bands containing valid valuse. See general help for more information.
USERNOTE	Specifies a comment that will be entered into the output log file and history entry in the output file.