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


mdis2pds

Standard View | TOC | Home

Exports a Messenger cube back into PDS format

Description
Categories
Groups
History


Description

The mdis2pds program will process a Messenger MDIS cube and export it to CDR type PDS product. The output file will have a PDS compliant label and a data object that contains the keywords described in the MDIS CDR/RDR SIS document (see link below). The input file must have been imported and calibrated using the ISIS programs mdis2isis and mdiscal, respectively. This will ensure that the proper values of the PRODUCT_ID and SOURCE_PRODUCT_ID are included in the output CDR label.

Categories


Related Objects and Documents

Applications

Documents


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 Maximum DN valid percentage

Output Controls

Name Description
BITS Number of bits for the output DN

Files: FROM

Description

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

Type cube
File Mode input
Filter *.cub

Files: TO

Description

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

Type filename
File Mode output

Stretch: TYPE

Description

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

Type string
Default AUTOMATIC
Option List:
Option Brief Description
AUTOMATICAutomatically calculate stretch Automatically calculate stretch from the input cube. No stretch 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

Stretch: MIN

Description

Lower bound for the manually specified stretch.

Type double

Stretch: MAX

Description

Upper bound for the manually specified stretch.

Type double

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

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

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 to this number of bits. The output data type will be automatically chosen 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)

History

Christopher Austin2008-08-12 Original version
Christopher Austin2008-08-14 Shortened and optimized the code handling the histograms. Removed the 32 bit stretch.
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 were 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.
Jeannie Backer2015-09-01 Added MESS:EC_FACTOR keyword to output label. Increased software version number to 1.1. Made code more compliant with ISIS coding standards. Added PDS format template for the output CDR product. Fixes #2333