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

hideal2pds

Printer Friendly View | TOC | Home

Export an Isis mosaicked ideal cube from a HiRISE image to a PDS product containing related spice data.

Overview Parameters

Description 

      This application takes an Isis cube from the HiRISE instrument that
      has been jitter corrected and mosaicked and exports it to a PDS product
      with detached label and spice tables.

      The following output files will be created using the file name passed in by the user.
      
    
        
  1. 
          PDS image file with the extension .img
        
    2. 
        
  2. 
          PDS label file with the extension .lbl
        
    3. 
        
  3. 
          PDS binary ck table file with the suffix _INSTRUMENT_POINTING_TABLE.dat
        
    4. 
        
  4. 
          PDS binary spk table file with the suffix _INSTRUMENT_POSITION_TABLE.dat
        
    5. 
        
  5. 
          PDS binary body rotation table file with the suffix _BODY_ROTATION_TABLE.dat
        
    6. 
        
  6. 
          PDS binary sun position table file with the suffix _SUN_POSITION_TABLE.dat
        
    7. 
      


      The output PDS image will be unsigned word 16 bit type, MSB, BSQ format
      and the resolution will be in meters.

      Note that the IMAGE_JITTER_CORRECTED keyword is copied from the input
      cube. If the input cube has been run through an older version of hijitter,
      this value will be set to UNK, since it is not known whether the image
      values have been jitter corrected.

Categories

History

Jeannie Backer2012-11-21 Original Version of hideal2pds. Fixes #678.
Makayla Shepherd2015-10-06 Added stretch parameters. Fixes #1761.
Tyler Wilson2019-02-08 Added an option to control the output bits. min = 8, max =16, default = 10. Fixes #5527.
Timothy Giroux2020-09-08 Output label now has the correct SAMPLE_BIT_MASK value according to bits input. Fixes #3978.
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:11
X

Files: FROM

Description

The Ideal cube from a HiRISE image containing the related spice data to be exported to PDS.

Type cube
File Mode input
Filter *.cub *.lbl
Close Window
X

Files: TO

Description

The file name of the output PDS image. This value will also be used for the name of the detached label and table files.

Type filename
File Mode output
Filter *.img
Close Window
X

Special Keywords: VERSION

Description

This parameter allows the user to specify the value of the standard PDS keyword PRODUCT_VERSION_ID within the output PDS label. This keyword will be located in the Root of the PDS PVL label. This value defaults to 1.0.

Type string
Default 1.0
Close Window
X

Special Keywords: RATIONALE_DESC

Description

This parameter allows the user to specify the value of the standard PDS keyword RATIONALE_DESC within the output PDS label. This keyword will be located in the ROOT of the PDS PVL label. Note that if a keyword value is not entered, the value will be read from the input cube labels. If it does not exist there, the program will throw an ] error.

Type string
Internal Default Preserve Original Rationale Description
Close Window
X

Stretch: TYPE

Description

This parameter is used to select one of two ways to stretch output pixels. The are AUTOMATIC or MANUAL.

Type string
Default AUTOMATIC
Option List:
Option Brief Description
AUTOMATICAutomatically calculate stretchAutomatically calculate stretch

Exclusions

  • MIN
  • MAX
MANUALUser defined stretchUser defined stretch

Exclusions

  • MINPER
  • MAXPER
Close Window
X

Stretch: MIN

Description

Lower bound for the manually specified stretch.

Type double
Close Window
X

Stretch: MAX

Description

Upper bound for the manually specified stretch.

Type double
Close Window
X

Stretch: MINPER

Description

The cumulative percentage value to be mapped to the minimum valid pixel for the specified number of bits. For example: With BITS=10 and MINPER=1.0, the DN which corresponds to the cummulative percent of 1.0 will be mapped to 3, where 0 represents NULL, 1 represents LRS and 2 represents LIS.

Type double
Default 0.0
Minimum 0.0 (inclusive)
Maximum 100.0 (inclusive)
Less Than or Equal MAXPER
Close Window
X

Stretch: MAXPER

Description

The cumulative percentage value to be mapped to the maximum valid pixel for the specified number of bits. For example: With BITS=10 and MINPER=99.0, the DN which corresponds to the cummulative percent of 99.0 will be mapped to 1021, 1021=(2**bits)-1-2. Where 1023 represents HIS and 1022 represents HRS.

Type double
Default 100.0
Minimum 0.0 (inclusive)
Maximum 100.0 (inclusive)
Greater Than or Equal MINPER
Close Window
X

Output Controls: BITS

Description

The number of bits to compress the input data to. The valid data as well as the five special pixel values (NULL, LIS, LRS, HIS, HRS) will be compressed into this number of bits. The output data type will be automaticity choosen using this value. A value of 8 will create unsigned byte output files. Values from 9 to 16 will create unsigned word output files. Unused bits in the unsigned word output file will be set to zero.

Type integer
Default 10
Minimum 8 (inclusive)
Maximum 16 (inclusive)
Close Window