Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

ISIS Documentation

mdis2pds

Exports a Messenger cube back into PDS format

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

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

Parameters

Files

Input filename of a messenger cube file to be exported into a CDR image.
Type cube
File Mode input
Filter *.cub

Output filename, by default the filename will be generated from the input filename.
Type filename
File Mode output

Stretch

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

Lower bound for the manually specified stretch.
Type double

Upper bound for the manually specified stretch.
Type double

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

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

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)