Home

Quick Links

Software Manual
GitHub
API Reference

Documentation Versions

Latest Release
Dev
8.3.0
8.2.0
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0
USGS

ISIS Application Documentation

raw2isis

Standard View | TOC | Home

Import raw cube into Isis format

Description
Categories
Groups
Examples
History

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

Parameter Groups

Files

Name Description
FROM Input raw file
TO Output Isis cube

Raw file dimensions

Name Description
SAMPLESNumber of samples in raw image
LINESNumber of lines in raw image
BANDSNumber of bands in raw image
SKIPNumber of bytes to skip before reading data

Data specifications

Name Description
BITTYPEBit type of input data
BYTEORDER Byte order of data

Special Pixels

Name Description
SETNULLRANGECreate special pixel values
NULLMIN Minimum valid value
NULLMAX Maximum valid value
SETHRSRANGECreate special pixel values
HRSMIN Minimum valid value
HRSMAX Maximum valid value
SETLRSRANGECreate special pixel values
LRSMIN Minimum valid value
LRSMAX Maximum valid value

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.

Type integer

Raw file dimensions: LINES

Description

This defines the number of lines in the raw image.

Type integer

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.

Type integer
Default 1

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.

Type integer
Default 0

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
UNSIGNEDBYTE8 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
  • NULLMIN
  • NULLMAX

Special Pixels: NULLMIN

Description

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

Type double
Inclusions
  • SETNULLRANGE

Special Pixels: NULLMAX

Description

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

Type double
Inclusions
  • SETNULLRANGE

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
  • HRSMIN
  • HRSMAX

Special Pixels: HRSMIN

Description

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

Type double
Inclusions
  • SETHRSRANGE

Special Pixels: HRSMAX

Description

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

Type double
Inclusions
  • SETHRSRANGE

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
  • LRSMIN
  • LRSMAX

Special Pixels: LRSMIN

Description

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

Type double
Inclusions
  • SETLRSRANGE

Special Pixels: LRSMAX

Description

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

Type double
Inclusions
  • SETLRSRANGE

Examples

Example 1

Using raw2isis with default parameters

Description

The use of raw2isis to ingest raw data and output Isis 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 Isis cube.

GUI Screenshot

raw2isis gui
raw2isis gui

Example GUI

Screenshot of the GUI with parameters

Data File

Raw input file. This is the raw data

Output Image

The cube image after conversion
The cube image after conversion

Final output image after the conversion

Parameter Name: TO

Converts from PDS format to a Isis cube.

History

Tracie L Sucharski1994-07-21 Original version
Tracie L Sucharski2002-07-25 Ported to Isis 3.0
Tracie L Sucharski2003-01-28 Move from Utility to Import/Export category.
Jeff Anderson2003-02-03 Move from Import/Export to Import and Export category.
Kim Sides2003-05-13 Added application test
Stuart Sides2003-05-16 Modified schema location from astogeology... to isis.astrogeology..."
Stuart Sides2003-07-29 Modified filename parameters to be cube parameters where necessary
Tracie Sucharski2003-08-22 Modified to use the new IsisImport object, which simplified the code.
Stuart Sides2003-10-10 Modified call to StartProcess to match new IsisImport class.
Jeff Anderson2004-02-06 Modified due to refactor of IsisImport class
Jeff Anderson2004-05-18 Updated documentation
Drew Davidson2005-06-27 Updated application test
Steven Koechle2007-08-29 Added ability to change special pixel ranges. Added example.
Christopher Austin2008-08-28 Added the UNSIGNEDWORD option for param BITTYPE.
U.S. Department of the Interior | U.S. Geological Survey
ISIS | Privacy & Disclaimers | Astrogeology Research Program
To contact us, please post comments and questions on the USGS Astrogeology Discussion Board
To report a bug, or suggest a feature go to: ISIS Github
File Modified: 02/24/2025 16:09:21