mdisddr

mdisddr will process a Messenger MDIS NAC or WAC image cube and export it to PDS/DDR format. The resulting file will have a PDS compliant label and data object according to the description in SIS document, mdis_crd_rdrsis.pdf. This file can be found in the PDS data archive CDROM under the document directory. mdisddr assumes the input file has been run through at a minimum mdis2isis and spiceinit. This will ensure that proper values of the PRODUCT_ID and SOURCE_PRODUCT_ID are included in the output DDR label.

The Derived Data Record (DDR) data set consists of files that parallel CDRs in their directory structure. Each DDR has 5 layers of data containing geometric information (latitude, longitude, incidence angle, emission angle, phase angle) as 32-bit PC_REAL or IEEE_REAL. This information is derived from pixel spatial coordinates and associated SPICE files. A DDR label is attached and points to a single multiband image in the DDR. x, y dimensions = 1024/(MESS:FPU_BIN * MESS:PIXELBIN)

The sequence of processing that creates a DDR is as follows. Gimbal positions are extracted from the gimbal C kernel. Using that and other SPICE kernels, the equipotential surface intercept is calculated for each spatial pixel. The angles of this pixel relative to the equatorial plane and reference longitude constitute the latitude and longitude of the pixel. For that latitude and longitude, solar incidence, emission, and phase angles are determined. This is the order in which the bands are written to the output PDS image file.

Description

Input filename of a MESSENGER cube file to be exported into a PDS DDR image. The minimum requirement is that it must be initalized with SPICE (using the spiceinit application).

Description

Output filename, by default the filename will be generated from the input file contents using the PRODUCT_ID. The user can specify the name if desired here, but to ensure consistancy with SIS specifications, the name of the file will be derived by the program. See the OPATH parameter for additional options of where the output file will be written.

The format of the derived filename will be of the form DN0131770878M_DE_0.IMG where 'D' indicates it is a derived data product, the second letter will be 'N' for MDIS/NAC or 'W' for MDIS/WAC instrument; the next ten characters will be numbers indicating the mission elasped time (MET) of the image; the following character is the filter - 'M' for monochrome or the NAC, letters 'A' -'L' for WAC filters; the two characters after the first underscore is always 'DE' indicating it is a derived data type; and the last number after the second underscore is the version number. The customary IMG extension is standard for most all PDS image data products.

Description

This parameter is provided to be used instead of the TO parameter if the filename convention is to be followed. If TO is not given, then output filename is derived internally according to the description in the SIS and the output file is placed in the OPATH directory. The default is to write it to the current directory.

Description

This parameter is used to select one of two ways to stretch output pixels. The are AUTOMATIC or MANUAL.

Description

Lower bound for the manually specified stretch.

Description

Upper bound for the manually specified stretch.

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.