Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


mdis2pds

Printer Friendly View | TOC | Home

Exports a Messenger cube back into PDS format

Overview Parameters

Description

mdis2pds will process a Messenger MDIS cube and export it to PDS/CDR format. The resulting file will have a PDS compliant label and data object according to the SIS document. mdis2pds assumes the input file has at least been run through mdis2isis and mdiscal. This will ensure that proper values of the PRODUCT_ID and SOURCE_PRODUCT_ID are included in the output CDR label.

Categories


History

Christopher Austin2008-08-12 Original version
Christopher Austin2008-08-14 Shortened and optimized the code handling the histograms. Removed the 32 bit strech.
Christopher Austin2008-08-22 Fixed for correct source. Previously was using incorrect comparison data.
Kris Becker2008-09-03 Modified sources of some of the keywords for the translation. Honors existing software name and versions if they exist; only include the High Instrument Saturation count in the SATURATED_PIXEL_COUNT label keyword where before it included all special pixels.
Kris Becker2008-09-08 Corrected the determination of minimum/maximum data ranges when using the histogram. The issue involves specifying MAXPER=100.0 and it not producing the entire valid range of data. This may result in HRS pixels. It has been changed to use the full valid data range in as computed from the Histogram.
Kris Becker2008-09-19 Fixed N/A quoting, misplaced units and data values that exceeded 20 characters. Also quoted the SOFTWARE_VERSION_ID and FILTER_NUMBER keyword values. Added units to RETICLE_POINT_* keywords where missing.
Steven Lambright2011-03-31 The DarkStripMean keyword can now be "N/A"
Kris Becker2011-06-15 Added ORBIT_NUMBER to translation table for inclusion in output RDR (CDR) file.
Kris Becker2011-07-21 Added quotes to the SITE_ID keyword.

Parameter Groups

Files

Name Description
FROM Input Messenger cube
TO Final output filename.

Stretch

Name Description
TYPE Select the type of stretch
MIN Lower bound of the stretch
MAX Upper bound of the stretch
MINPER Minimum DN valid percentage
MAXPER Mazimum DN valid percentage

Output Controls

Name Description
BITS Number of bits for the output DN
X

Files: FROM


Description

Input filename of a messenger cube file to be exported into a cdr image.

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

Files: TO


Description

Output filename, by default the filename will be generated from the input filename.

Type filename
File Mode output
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 stretch Automatically calculate stretch from the input cube. No strecth will be used if BITS equals 32, MINPER equals 0.0, and MAXPER equals 100.0.

Exclusions

  • MIN
  • MAX
MANUALUser defined stretch Enables the user defined stretch for the output IMG.

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 32
Minimum 8 (inclusive)
Maximum 32 (inclusive)
Close Window