Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

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.

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.

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 samples in the raw image.
Type integer

This defines the number of lines in the raw image.
Type integer

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
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

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

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

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

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

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

Example 1

Using raw2isis with default parameters

The use of raw2isis to ingest raw data and output Isis cubes.

Command Line

This example shows the use of raw2isis create an Isis cube.
raw2isis from= input.raw to= out.cub samples=126 lines=126 bands=2 bittype=real

GUI Screenshot

raw2isis gui

Example GUI

raw2isis gui

Screenshot of the GUI with parameters

Data File

Links open in a new window.
Raw input file. This is the raw data

Output Image

The cube image after conversion

Final output image after the conversion

The cube image after conversion

Parameter Name: TO

Converts from PDS format to a Isis cube.