ISIS Application Documentation
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
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 |
| AUTOMATIC | Automatically 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
|
| MANUAL | User defined stretch |
Enables the user defined stretch for the output IMG.
Exclusions
|
|
Stretch:
MIN
Description
Lower bound for the manually specified stretch.
Stretch:
MAX
Description
Upper bound for the manually specified stretch.
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
|
|
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
|
|
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 Austin | 2008-08-12 |
Original version
|
| Christopher Austin | 2008-08-14 |
Shortened and optimized the code handling the histograms. Removed the
32 bit stretch.
|
| Christopher Austin | 2008-08-22 |
Fixed for correct source. Previously was using incorrect comparison data.
|
| Kris Becker | 2008-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 Becker | 2008-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 Becker | 2008-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 Lambright | 2011-03-31 |
The DarkStripMean keyword can now be "N/A"
|
| Kris Becker | 2011-06-15 |
Added ORBIT_NUMBER to translation table for inclusion in output RDR (CDR) file.
|
| Kris Becker | 2011-07-21 |
Added quotes to the SITE_ID keyword.
|
| Jeannie Backer | 2015-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
|