ISIS 3 Application Documentation
Import raw cube into Isis format
Overview
Parameters
Example 1
Description
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.
Categories
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.
Parameter Groups
Files
Name
Description
FROM
Input raw file
TO
Output Isis cube
Raw file dimensions
Name
Description
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
Special Pixels
Files :
FROM
Description
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
Files :
TO
Description
Use this parameter to select the output filename
Type
cube
File Mode
output
Filter
*.cub
Raw file dimensions :
SAMPLES
Description
This defines the number of samples in the raw image.
Raw file dimensions :
LINES
Description
This defines the number of lines in the raw image.
Raw file dimensions :
BANDS
Description
This defines the number of bands in the raw image. If
greater than 1, the image is assumed to be in band sequential
order.
Raw file dimensions :
SKIP
Description
This defines the number of bytes to skip before the actual image
data is read. This would be for raw images with header data.
Data specifications :
BITTYPE
Description
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
Data specifications :
BYTEORDER
Description
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 :
SETNULLRANGE
Description
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
Special Pixels :
NULLMIN
Description
Minimum valid value. Anything below this value will be
set to LRS.
Special Pixels :
NULLMAX
Description
Maximum valid value. Anything above this value will be
set to HRS.
Special Pixels :
SETHRSRANGE
Description
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
Special Pixels :
HRSMIN
Description
Minimum valid value. Anything below this value will be
set to LRS.
Special Pixels :
HRSMAX
Description
Maximum valid value. Anything above this value will be
set to HRS.
Special Pixels :
SETLRSRANGE
Description
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
Special Pixels :
LRSMIN
Description
Minimum valid value. Anything below this value will be
set to LRS.
Special Pixels :
LRSMAX
Description
Maximum valid value. Anything above this value will be
set to HRS.
Example 1
Using raw2isis with default parameters
Description
The use of raw2isis to ingest raw data and output Isis3 cubes.
Command Line
raw2isis
from= input.raw
to= out.cub
samples=126
lines=126
bands=2
bittype=real
This example shows the use of raw2isis create an Isis3 cube.
GUI Screenshot
raw2isis gui
Example GUI
Screenshot of the GUI with parameters
Data File
Links open in a new window.
Output Image
The cube image after conversion
Final output image after the conversion
Parameter Name:
TO
Converts from PDS format to a Isis3 cube.
