JavaScript is not enabled, using print styling. Please note, this may disable the navigation menu.

raw2isis

Import raw cube into Isis format

This program will import a raw image into an Isis cube. Bytes will be swapped if necessary and there is an option to create special pixels.

History

Tracie L Sucharski	1994-07-21	Original version
Tracie L Sucharski	2002-07-25	Ported to Isis 3.0
Tracie L Sucharski	2003-01-28	Move from Utility to Import/Export category.
Jeff Anderson	2003-02-03	Move from Import/Export to Import and Export category.
Kim Sides	2003-05-13	Added application test
Stuart Sides	2003-05-16	Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides	2003-07-29	Modified filename parameters to be cube parameters where necessary
Tracie Sucharski	2003-08-22	Modified to use the new IsisImport object, which simplified the code.
Stuart Sides	2003-10-10	Modified call to StartProcess to match new IsisImport class.
Jeff Anderson	2004-02-06	Modified due to refactor of IsisImport class
Jeff Anderson	2004-05-18	Updated documentation
Drew Davidson	2005-06-27	Updated application test
Steven Koechle	2007-08-29	Added ability to change special pixel ranges. Added example.
Christopher Austin	2008-08-28	Added the UNSIGNEDWORD option for param BITTYPE.

Parameters

Files

Use this parameter to select the raw filename. If multi-band, it is assumed to be in band sequential order.

Type	filename
File Mode	input
Filter	*.raw

Use this parameter to select the output filename

Type	cube
File Mode	output
Filter	*.cub

Raw file dimensions

This defines the number of bands in the raw image. If greater than 1, the image is assumed to be in band sequential order.

Type	integer
Default	1

This defines the number of bytes to skip before the actual image data is read. This would be for raw images with header data.

Type	integer
Default	0

Data specifications

Bit type of data: 8 bit, 16 bit signed, or 32 bit

Type

string

Default

UNSIGNEDBYTE

Option List:

Option	Brief	Description
UNSIGNEDBYTE	8 bit data	Pixels are in 8-bit data range (0 to 255).
UNSIGNEDWORD	16 bit unsigned data	Pixels are in 16 bit unsigned data range (0 to 65535)
SIGNEDWORD	16 bit signed data	Pixels are in 16 bit signed data range (-32767 to 32767)
REAL	32 bit data	Pixels are in the 32 bit floating point data range

Indicates the byte order of the data. Options are LSB (Least Significant Byte firs) or MSB (Most Significant Byte first).

Type

string

Default

LSB

Option List:

Option	Brief	Description
LSB	Least Significant Byte	Least Significant Byte first. Possible architectures include: Intel and Amd.
MSB	Most Significant Byte	Most Significant Byte first. Possible architectures include: Sun and Mac.

Special Pixels

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type	boolean
Default	NO
Inclusions	NULLMIN NULLMAX

Minimum valid value. Anything below this value will be set to LRS.

Type	double
Inclusions	SETNULLRANGE

Maximum valid value. Anything above this value will be set to HRS.

Type	double
Inclusions	SETNULLRANGE

Type	boolean
Default	NO
Inclusions	HRSMIN HRSMAX

Minimum valid value. Anything below this value will be set to LRS.

Type	double
Inclusions	SETHRSRANGE

Maximum valid value. Anything above this value will be set to HRS.

Type	double
Inclusions	SETHRSRANGE

Type	boolean
Default	NO
Inclusions	LRSMIN LRSMAX

Minimum valid value. Anything below this value will be set to LRS.

Type	double
Inclusions	SETLRSRANGE

Maximum valid value. Anything above this value will be set to HRS.

Type	double
Inclusions	SETLRSRANGE

raw2isis

Categories

History

Parameters

Files

Raw file dimensions

Data specifications

Special Pixels

Example 1

Using raw2isis with default parameters

Command Line

GUI Screenshot

Example GUI

Data File

Output Image

Final output image after the conversion

raw2isis

Categories

History

Parameters

Files

FROM Input raw file

TO Output Isis cube

Raw file dimensions

SAMPLES Number of samples in raw image

LINES Number of lines in raw image

BANDS Number of bands in raw image

SKIP Number of bytes to skip before reading data

Data specifications

BITTYPE Bit type of input data

BYTEORDER Byte order of data

Special Pixels

SETNULLRANGE Create special pixel values

NULLMIN Minimum valid value

NULLMAX Maximum valid value

SETHRSRANGE Create special pixel values

HRSMIN Minimum valid value

HRSMAX Maximum valid value

SETLRSRANGE Create special pixel values

LRSMIN Minimum valid value

LRSMAX Maximum valid value

Example 1

Using raw2isis with default parameters

Command Line

GUI Screenshot

Example GUI

Data File

Output Image

Final output image after the conversion