Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search

USGS

Isis 3 Application Documentation


pds2isis

Printer Friendly View | TOC | Home

Import PDS image cube into Isis format cube

Overview Parameters Example 1

Description

This program will import a PDS image into an Isis cube.

The special pixel ranges that may be entered, can align back-to-back. i.e. Null Range = ( 0.0 3.0 ) and LIS Range = ( 3.0, 5.0 ) When this is done, certain special pixels take precedence over others in the following order: Null HRS LRS HIS LIS Therefore, in the above example, the actual raw value of 3.0 would be translated into a Null pixel, since Null is listed before LIS in the priority list.


Categories


History

Kris Becker1997-05-01 Original version
Stuart Sides2003-05-15 Wrote for Isis 3.
Stuart Sides2003-05-16 Modified schema location from astrogeology... to isis.astrogeology..."
Stuart Sides2003-06-04 Fixed Makefile
Stuart Sides2003-10-10 Converted to use new IsisImport instead of IsisPdsImport
Stuart Sides2004-02-20 Converted to use the new IsisImportPds class and added import labels to the output cube.
Brendan George2006-09-28 Documentation fixes
Stuart Sides2007-01-25 Added ability to transfers Isis2 instrument and bandbin information.
Tracie Sucharski2007-04-10 Added LatitudeType2 group to translation table to handle CTX cubes. Additonal changes to projection translation tables for other possible values for Longitude direction, latitude type. If the min or max longitude values are greater than 180, change longitude domain to 360. Only call TranslateIsis2Labels if pds file is an Isis2 cube.
Steven Lambright2007-08-07 Added support for copying some PDS labels, if they exist, into the output.
Steven Koechle2007-08-29 Added special pixel ranges. Added examples.
Steven Lambright2008-05-13 Removed references to CubeInfo
Christopher Austin2008-09-15 Fixed problem with special pixel range functionality and documentation. Added HIS and LIS range options.

Parameter Groups

Files

Name Description
FROM Input PDS file
IMAGE Detached data file
TO Output Isis cube

Special Pixels

Name Description
SETNULLRANGEPixel values in the given range are converted to Null
NULLMIN Minimum Null value
NULLMAX Maximum Null value
SETHRSRANGEPixel values in the given range are converted to HRS
HRSMIN Minimum HRS value
HRSMAX Maximum HRS value
SETHISRANGEPixel values in the given range are converted to HIS
HISMIN Minimum HIS value
HISMAX Maximum HIS value
SETLRSRANGEPixel values in the given range are converted to LRS
LRSMIN Minimum LRS value
LRSMAX Maximum LRS value
SETLISRANGEPixel values in the given range are converted to LIS
LISMIN Minimum LIS value
LISMAX Maximum LIS value
X

Files: FROM


Description

Use this parameter to select the PDS filename. This file must contain the PDS labels, however the image data can be detached and will be automatically obtained from the PDS image pointer keyword. If the pointer is incorrect then use the IMAGE parameter to specify the file containing the binary image data.

Type filename
File Mode input
Filter *.lbl *.img
Close Window
X

Files: IMAGE


Description

Use this parameter if the pointer to the image data in the detached label (FROM) is incorrrect.

Type filename
File Mode input
Internal Default Cube data embedded with label or file pointer in label file.
Filter *.img
Close Window
X

Files: TO


Description

Use this parameter to select the output filename

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

Special Pixels: SETNULLRANGE


Description

If this option is used, the input raw pixels inside and including the NULLMIN and NULLMAX will be converted to Null pixels. 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 Null value. Anything from this value to NULLMAX will be converted to Null.

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: NULLMAX


Description

Maximum Null value. Anything from this value to NULLMIN will be converted to Null.

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: SETHRSRANGE


Description

If this option is used, the input raw pixels inside and including the HRSMIN and HRSMAX will be converted to HRS pixels. 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 HRS value. Anything from this value to HRSMAX will be converted to HRS.

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: HRSMAX


Description

Maximum HRS value. Anything from this value to HRSMIN will be converted to HRS.

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: SETHISRANGE


Description

If this option is used, the input raw pixels inside and including the HISMIN and HISMAX will be converted to HIS pixels. 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
  • HISMIN
  • HISMAX
Close Window
X

Special Pixels: HISMIN


Description

Minimum HIS value. Anything from this value to HISMAX will be converted to HIS.

Type double
Inclusions
  • SETHISRANGE
Close Window
X

Special Pixels: HISMAX


Description

Maximum HIS value. Anything from this value to HISMIN will be converted to HIS.

Type double
Inclusions
  • SETHISRANGE
Close Window
X

Special Pixels: SETLRSRANGE


Description

If this option is used, the input raw pixels inside and including the LRSMIN and LRSMAX will be converted to LRS pixels. 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 LRS value. Anything from this value to LRSMAX will be converted to LRS.

Type double
Inclusions
  • SETLRSRANGE
Close Window
X

Special Pixels: LRSMAX


Description

Maximum LRS value. Anything from this value to LRSMIN will be converted to LRS.

Type double
Inclusions
  • SETLRSRANGE
Close Window
X

Special Pixels: SETLISRANGE


Description

If this option is used, the input raw pixels inside and including the LISMIN and LISMAX will be converted to LIS pixels. 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
  • LISMIN
  • LISMAX
Close Window
X

Special Pixels: LISMIN


Description

Minimum LIS value. Anything from this value to LISMAX will be converted to LIS.

Type double
Inclusions
  • SETLISRANGE
Close Window
X

Special Pixels: LISMAX


Description

Maximum LIS value. Anything from this value to LISMIN will be converted to LIS.

Type double
Inclusions
  • SETLISRANGE
Close Window

Example 1

Using pds2isis with default parameters

Description

The use of pds2isis to ingest PDS data and output Isis3 cubes.

Command Line

pds2isis from= input.img to= out.cub
This example shows the use of pds2isis create an Isis3 cube.

GUI Screenshot

pds2isis gui

Example GUI

Screenshot of the GUI with parameters

Data File

Links open in a new window.
PDS format input file. This is the PDS labels and data

Output Image

The cube image after conversion

Final output image after the conversion

Parameter Name: TO

Converts from PDS format to a Isis3 cube.