Home
About Isis
Support
Download

Isis 3

Documentation
Tutorials
Technical Documents

Isis 2

Documentation
Tutorials
Technical Documents

Search
USGS

Isis 3 Application Documentation

pds2isis

Standard View | TOC | Home

Import PDS image cube into Isis format cube

Description
Categories
Groups
Examples
History

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

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

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

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

Files: TO

Description

Use this parameter to select the output filename

Type cube
File Mode output
Filter *.cub

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

Special Pixels: NULLMIN

Description

Minimum Null value. Anything from this value to NULLMAX will be converted to Null.

Type double
Inclusions
  • SETNULLRANGE

Special Pixels: NULLMAX

Description

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

Type double
Inclusions
  • SETNULLRANGE

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

Special Pixels: HRSMIN

Description

Minimum HRS value. Anything from this value to HRSMAX will be converted to HRS.

Type double
Inclusions
  • SETHRSRANGE

Special Pixels: HRSMAX

Description

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

Type double
Inclusions
  • SETHRSRANGE

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

Special Pixels: HISMIN

Description

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

Type double
Inclusions
  • SETHISRANGE

Special Pixels: HISMAX

Description

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

Type double
Inclusions
  • SETHISRANGE

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

Special Pixels: LRSMIN

Description

Minimum LRS value. Anything from this value to LRSMAX will be converted to LRS.

Type double
Inclusions
  • SETLRSRANGE

Special Pixels: LRSMAX

Description

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

Type double
Inclusions
  • SETLRSRANGE

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

Special Pixels: LISMIN

Description

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

Type double
Inclusions
  • SETLISRANGE

Special Pixels: LISMAX

Description

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

Type double
Inclusions
  • SETLISRANGE

Examples

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

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.

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.