raw2isis Documentation

raw2isis - Transfers raw images into an ISIS cube
RAW2ISIS converts either a single-band or a multi-band raw image into
an ISIS cube.  It either creates a new ISIS cube or inserts the raw
image data into a band of an existing ISIS cube.  RAW2ISIS assumes the
raw image data is in a Band Sequential format and the output ISIS
cube will also be in a BSQ format.  ISIS routines will normally convert
8-bit input values of 0 and 255 into ISIS special pixel values in the
output cube.  The SAT parameter allows you to change this.  See the
description for SAT for more information.

PROGRAMMER: Tracie Sucharski, U.S.G.S., Flagstaff, AZ

Input raw file name

NONE

Output ISIS cube file
(default extension is .cub)

NONE

Input pixel type

NONE

The type of hardware the raw
input file was created on:
Supported hardware types are:
HOST
SUN   (MSB_IEEE)
VAX   (LSB_VAX)
ALPHA (LSB_IEEE)
MSB_IEEE
LSB_IEEE
MSB_VAX (not defined in PDS)
LSB_VAX

"HOST"

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

--

Convert 8-bit input values of
0 and 255 to special pixel
values in output cube

YES

Output pixel data range

--

Number of bytes to skip in
the raw file before reading
image data.

0

Number of samples in raw image

NONE

Number of lines in raw image

NONE

Number of bands in raw image

1

Create a new cube (YES,NO)

YES

Output band number

--

ADDITIONAL NOTES:

Parm	Description
FROM	Input raw or raster file name. There is no default extension.
TO	Output cube file name. If the file extension is omitted, then ".cub" will be assumed.
ITYPE	Input pixel data type. Permitted values are: 1 - 8-bit (unsigned integer) 2 - 16-bit (signed integer) 3 - 32-bit (floating point) RAW2ISIS does not do any conversions for different machine architectures, so the raw file must have the same byte order and floating point format as the resident machine. If the machine architecture is not the same as the resident machine set the CORTYPE parameter to the correct value and run the program CONVERT after running RAW2ISIS. This will put the cube into the correct format.
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)
IN_ARCH	This parameter specifies the type of hardware the raw input file was created on. The supported hardware architectures are MSB and LSB byte storage orders and VAX and IEEE floating point. Some specific platforms names are provided and can be used. If the architecture is known and the specific platform name is not provided as an available option, use one of the generic names. The value of "HOST" will always refer to the platform convert is executing on.
SAT	If SAT=YES and the input raw image is 8-bit, all input values of 0 and 255 will be converted to ISIS special pixel values in the output ISIS cube. If SAT=NO, the input is 8-bit and output is 8-bit, input values of 0 will be set to 1 in the ouput and input values of 255 will be set to 254 in the output. For 16-bit or 32-bit output data, input values of 0 and 255 will be retained in the output cube.
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.
SKIP	The number of bytes in the RAW image to skip before reading image data. This must be taken into consideration if the RAW image file has header information.
NS	Number of samples in the raw image file.
NL	Number of lines in the raw image file.
NBANDS	Number of bands in the raw image file. Multiple bands will be stacked in the output ISIS cube in the order they are in the raw input file.
NEWFILE	Specifies whether a new output file is created (NEWFILE=YES) or an existing file is updated (NEWFILE=NO). Single band input images will be put in the cube file at band 1. Multi-band input images will be stacked in the cube file starting in band 1 and in the order they appear in the raw image.
OBAND	This is the band in the output cube that the raw file will be inserted into. If OBAND=NULL, the input image will be added to the end of the cube. If creating a new cube, it will be put into the first band.