isis2pds

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'.

Not everything is in the PDS 4 Information Model Specification at this time, so if the information about a tag is not in there, it may be necessary to find the options in the appropriate schematron file (.sch) available at: PDS4 Released Schema. For the previous example, the same information can be found in the PDS4 Cartography schematron file .

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.

Description

The cube to be converted to pds format.

Type	cube
File Mode	input
Filter	*.cub

Description

The resulting pds file. For PDS4, a detached label of the same name with the file extension .xml will be created in the same directory.

Type	filename
File Mode	output
Filter	*.img

Description

Changes which version of PDS file format to output in.

Type	string
Default	PDS3
Option List:	Option Brief Description PDS3 Convert ISIS3 cube to PDS3 format Convert ISIS3 cube to PDS3 format. PDS4 Convert ISIS3 cube to PDS4 format Convert ISIS3 cube to PDS4 format. Exclusions LABTYPE CHECKSUM

Description

Changes the type of pds label exported.

Type	string
Default	STREAM
Option List:	Option Brief Description STREAM Streams labels dynamically ISIS default, streams the pds labels out to take up as few bytes as possible. FIXED Exports fixed labels Exports the pds labels in a fixed label format. This fixed size is derived from the number of bytes in each line of the exported cube.

Description

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) Exclusions STRETCH MINPERCENT MAXPERCENT NULL LRS LIS HIS HRS

Description

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.

Type	boolean
Default	true

Description

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.

Type	boolean
Default	false

Description

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.

Type	boolean
Default	false

Description

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.

Type	boolean
Default	false

Description

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.

Type	boolean
Default	false

Description

If set to true, then an MD5 checksum will be generated from the image data and attached to the output image labels.

Type	boolean
Default	false

Description

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. Exclusions MINPERCENT MAXPERCENT Inclusions MINIMUM MAXIMUM

Description

The minimum input pixel value which will be mapped to black.

Type	double
Less Than	MAXIMUM

Description

The maximum input pixel value which will be mapped to white.

Type	double
Greater Than	MINIMUM

Description

The percentage of data in the histogram used to compute the minimum pixel value in the stretch.

Type	double
Default	0.5
Less Than	MAXPERCENT

Description

The percentage of data in the histogram used to compute the maximum pixel value in the stretch.

Type	double
Default	99.5
Greater Than	MINPERCENT

Description

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.

Converting a cube to a pds format image.

isis2pds from=ab102401.lev2.cub to=ab102401.lev2.img

isis2pds GUI

Example GUI Screenshot of GUI with FROM and TO files selected.

Input Image

Input cube image Parameter Name: FROM This is the input cube for the example of isis2pds.

Output pds Image

Output pds image Parameter Name: TO This is the exact same image with exact same DNs, but in the pds format.