ISIS 3 Application Documentation
Exports a Messenger cube back into PDS format
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 Austin | 2008-08-12 |
Original version
|
Christopher Austin | 2008-08-14 |
Shortened and optimized the code handling the histograms. Removed the
32 bit strech.
|
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 where 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.
|
|
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
|
|
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. The 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 strecth
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 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
|
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
|
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)
|