dsk2dsk Documentation

dsk2dsk - Determine or set the valid core data range
"dsk2dsk" will determine or set the minimum and maximum valid core
data range of an input cube file and optionally create a new output
file.  The result can be overwritten on the input cube file by
specifying TO=" ".   Note that if this mode is desired, SFROM must
select the entire cube.  An option of this program is to change the
input pixel type from one type to another during propagation to the
output file.

DSK2DSK provides two functions based on the value of the MODE TAE
parameter.  If MODE=GET_RANGE, then DSK2DSK will determine and report
the valid minimum and maximum range of the core data.  If
MODE=SET_RANGE, then DSK2DSK will set the minimum and maximum core data
range to the TAE input parameters CRANGE(1) and CRANGE(2), respectively.
Any value below CRANGE(1) will be set to the Low Representation
Saturation value and any value greater than CRANGE(2) will be set to
the High Representation Saturation value.  Values that fall between
CRANGE(1) and CRANGE(2) will not be altered.  In both modes, the label
keyword values of CORE_MINIMUM and CORE_MAXIMUM in the VOLATILE_INFO
group of the QUBE object are set to the range of values that actually
is contained in the file.

PROGRAMMER: Jim Mathews, 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)

" "

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

--

Output min/max data range

--

Processing mode
  (GET_RANGE or SET_RANGE)

"GET_RANGE"

Min/max core data range
  for MODE=SET_RANGE

--

User comment

" "

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.
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.
MODE	Specifies action to be taken by this program. For MODE=GET_RANGE, the actual minimum and maximum values of core data are determined. For MODE=SET_RANGE, the minimum and maximum core data range is set to the values specified by CRANGE. Any values that fall outside the CRANGE values will be set to Representation saturation values. Any values that lie within the CRANGE values, will be unaltered.
CRANGE	Range of values to be permitted in the core of the cube file when MODE=SET_RANGE is specified.
USERNOTE	Comment from the user. This will be recorded in the ISIS session log file and also in the History entry that is put into the History object of the output file.