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

Printer Friendly View | TOC | Home

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 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/21/2025 19:28:13
X

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
Close Window
X

Files: TO

Description

Use this parameter to select the output filename

Type cube
File Mode output
Filter *.cub
Close Window
X

Raw file dimensions: SAMPLES

Description

This defines the number of samples in the raw image.

Type integer
Close Window
X

Raw file dimensions: LINES

Description

This defines the number of lines in the raw image.

Type integer
Close Window
X

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
Close Window
X

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
Close Window
X

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
Close Window
X

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.
Close Window
X

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
Close Window
X

Special Pixels: NULLMIN

Description

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

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: NULLMAX

Description

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

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

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
Close Window
X

Special Pixels: HRSMIN

Description

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

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: HRSMAX

Description

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

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

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
Close Window
X

Special Pixels: LRSMIN

Description

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

Type double
Inclusions
  • SETLRSRANGE
Close Window
X

Special Pixels: LRSMAX

Description

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

Type double
Inclusions
  • SETLRSRANGE
Close Window