Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions


ISIS 2

Documentation
Tutorials
Technical Documents
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.

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

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

Example 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

Parameter Name: TO

Converts from PDS format to a Isis cube.