Program to convert cubes to PDS3 or PDS4 image files.
For PDS4, If available, Instrument and Mapping information will be written to the detached output PDS4 formatted xml label file.
Not all values in the generated PDS4 labels can be determined automatically by ISIS3, and some must be updated by the user (by opening up the xml label output by this application and editing it with a text editor) for the generated label to be PDS4 compliant. The values UNK (unknown) and TBD (to be determined) are used as placeholders in the generated label. TBD values must be replaced by the user for the output label to be PDS4 compliant. Some of these TBDs can only be replaced with one of several specific enumerated values to meet compliancy. These possible values can be found in the PDS 4 Information Model Specification in the Value/Class column of the table for the associated tag or in the index at the end of the document. Searching this page for the name of the field you need to determine a value for is recommended.
For example: For a cube with map-projected data, ISIS3 will populate planar_coordinate encoding_method with a value on its own, but if it did not and instead had "TBD", we would find at planar_coordinate_coding_method that there are 3 possible values: 'Coordinate Pair', 'Distance and Bearing', 'Row and Column'.
UNK is used as a placeholder if any value can be used and still be a valid PDS4-formatted xml header. UNKs can, but are not required to be, replaced by the user with
better information.
Changed to assume that radii without units in the input Isis cube are in meters, map scales without units are in meters/pixel, and
map resolutions without units are in pixels/degree.
Makayla Shepherd and Ian Humphrey
2017-05-17
Added CHECKSUM parameter to optionally generate and attach an MD5 checksum to the exported
image label. This checksum is generated from the image data. Fixes #1013.
Jeannie Backer, Mayayla Shepard, and Kristin Berry
2017-10-27
Added PDS4 output option. Previously, this application converted ISIS3 cubes to PDS3 format only.
Jeannie Backer
2017-11-13
Updated to attach *.img extension to pds4 output data file.
Kristin Berry
2017-11-26
Updated with very basic documentation about the PDS4 output labels.
Bit type of output:
8 bit (0=black, 255=white)
16 bit unsigned (0=black, 65535=white)
16 bit signed (-32767=black, 32768=white)
32 bit (1.17549435e-38=black, 3.40282347e+38=white)
Type
string
Default
32BIT
Option List:
Option
Brief
Description
8BIT
8 bit data
Pixels are in 8-bit data range (0 to 255).
Exclusions
ENDIAN
U16BIT
16 bit unsigned data
Pixels are in the 16-bit data range (0 to 65535)
S16BIT
16 bit signed data
Pixels are in 16 bit signed data range (-32768 to 32767)
32BIT
32 bit data
Pixels are in the 32 bit floating point data range
(-3.40282347e+38 to 3.40282347e+38)
If set to true, the minimum value of the raw output data will be
reserved for null pixels. The actual value used for null pixels will
be denoted in the print.prt file as well as displayed onscreen.
If set to true, then an output DN value is set aside for the LRS input pixels.
The actual DN value used for LRS pixels will be denoted in the print.prt
file as well as displayed onscreen.
If set to true, then an output DN value is set aside for the LIS input pixels.
The actual DN value used for LIS pixels will be denoted in the print.prt
file as well as displayed onscreen.
If set to true, then an output DN value is set aside for the HIS input pixels.
The actual DN value used for HIS pixels will be denoted in the print.prt
file as well as displayed onscreen.
If set to true, then an output DN value is set aside for the HRS input pixels.
The actual DN value used for HRS pixels will be denoted in the print.prt
file as well as displayed onscreen.
This parameter is used to select one of three ways to stretch
(or map) the input pixels. They are NONE, LINEAR, or MANUAL.
Type
string
Default
NONE
Option List:
Option
Brief
Description
NONE
No stretch
No stretch is performed.
Exclusions
MINIMUM
MAXIMUM
MINPERCENT
MAXPERCENT
LINEAR
Linear stretch
A minimum and maximum are automatically computed based on
the statistics of the selected input band. A histogram of the band
is used to pick the minimum at 0.5% of the data and the maximum
at 99.5% of the data. Input pixels less than or equal to the
minimum are stretched to black while pixels greater than the or
equal to the maximum are stretched to white. A linear mapping
occurs between the minimum and maximum.
Exclusions
MINIMUM
MAXIMUM
MANUAL
Manual stretch
This option allows you to pick your own stretch. You must
enter a value for MINIMUM and MAXIMUM input pixel.
This parameter is used to select one whether the output will be
streamed starting with the most significant byte (MSB) or starting
with the least significant bytes (LSB). The choice should be made by
the user depending upon the format read by the system architecture
from which they plan to read the raw data.
Type
string
Default
LSB
Option List:
Option
Brief
Description
LSB
Least significant byte
The least significant byte will be the first byte output.
MSB
Most significant byte
The most significant byte will be the first byte output.
