specpix Documentation

specpix - Replace user specified pixels with special pixel values
"specpix" replaces user specified valid pixel values with special
pixel values. For 8-bit output images, only Null and High
Instrument Saturation values are available, and will be the only
special pixel values in the output cube. Conversion to either type
of low saturation can be specified, but these will be stored as
NULL in the output 8-bit file. High Representation Saturation will
be stored as High Instrument Saturation. For 16-bit and 32-bit
images all five special pixel values will be represented.  Pixels
will be replaced with the FIRST special pixel value that matches
the range that the user specified. Once the replacement has taken
place, the pixel will not be tested for the other ranges.

**NOTE** The "convert" program can be used to replace special
	 pixel values with valid pixel values or other special
	 pixel values.

Programmer: Way Christiansen, 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

Valid range for Null pixels

--

Valid range for Low Repr. Sat.

--

Valid range for High Repr. Sat.

--

Valid range for Low Inst. Sat.

--

Valid range for High Inst. Sat.

--

Output pixel type
 NULL = input type
    1 = 8 bit
    2 = 16 bit
    3 = 32 bit

--

Output min/max data range

--

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
SFROM	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. Any application below can be used for any dimension. To select specific data from any dimension: "10-100(3):11,12,15-20:1-10(2)" = This example will select every third sample starting with sample 10 thru 100. It selects lines 11 and 12, and 15-20. It selects 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.
INNULL	The valid range of pixel values to be replaced with a Null value. If this is specified as the NULL TAE parameter value then no valid pixels will be replaced with a NULL pixel value.
INLRS	The valid range of pixel values to be replaced with the Low Representation Saturation value. If this is specified as the NULL TAE parameter value then no valid pixels will be replaced with an LRS pixel value.
INHRS	The valid range of pixel values to be replaced with the High Representation Saturation value. If this is specified as the NULL TAE parameter value then no valid pixels will be replaced with an HRS pixel value.
INLIS	The valid range of pixel values to be replaced with the Low Instrument Saturation value. If this is specified as the NULL TAE parameter value then no valid pixels will be replaced with an LIS pixel value.
INHIS	The valid range of pixel values to be replaced with the High Instrument Saturation value. If this is specified as the NULL TAE parameter value then no valid pixels will be replaced with an HIS pixel value.
OTYPE	Output pixel data type. Permitted values are: NULL = output type is same as input file pixel type 1 = 8-bit (integer with type conversion parameters) 2 = 16-bit (integer with type conversion parameters) 3 = 32-bit (floating point) When processed data are being written back into the input file, the output pixel type must be the same as the existing pixel type in the input file.
ORANGE	Output pixel data range. If ORANGE is NULL, then the CORE_BASE and CORE_MULTIPLIER in the output file will be set to represent the same range of data as the input file. If OTYPE=1 (8-bit) or OTYPE=2 (16-bit), then the CORE_BASE and CORE_MULTIPLIER in the output file will be set to values that allow representing the specified range of output values. Output values outside this range will be stored as a special "representation saturation" value. The ORANGE parameter is ignored if OTYPE=3 (32-bit) since the CORE_BASE and CORE_MULTIPLIER are not applicable to floating point pixel values. **NOTE** For a more detailed explanation of ORANGE, tutor the orange.pdf.