pds2isis

This program converts a PDS or ISIS2 formatted file to an ISIS3 cube format. The standard PDS image is defined in the "FROM" parameter, and not the "IMAGE" parameter. If the PDS file has a detached label file and an image file, both are required to exist in the working directory. If the label is detached, the detached label filename is defined as the input file for the "FROM" parameter. The "IMAGE" parameter does not need to be defined, unless the program fails to find the image file specifed in the label file upon the program's execution. The default settings normally work for most PDS products, but occasionally the user may need to modify the default values in order to obtain an image that meets their specific requirements.

The incoming special pixel values in the PDS file are assigned equivalent values for special pixels in ISIS. The order of precedence for special pixels in ISIS from highest to lowest priority is the following:

1. NULL
2. HRS
3. LRS
4. HIS
5. LIS

If any incoming pixel value falls within two different special pixel types, the special pixel with the higher priority is assigned. The user may also specify a range of pixel values to be assigned to the different special pixels. If the range of pixel values defined by the user for the different special pixels overlap, the special pixel with the highest priority is assigned. For example, if NULLMIN=0.0, NULLMAX=3.0, LISMIN=3.0, and LISMAX=5.0, the actual raw value 3.0 can be assigned as a NULL or LIS, but is translated to NULL because NULL has a higher priority than LIS.

It should be noted if any incoming pixel values are equal to one of the ISIS special pixel values for the corresponding bit type, those pixels will be special in the output cube. The special pixel values for each bit type can be found here. This is most commonly an issue with 8-bit data. If you are working with an 8-bit image and need either 0 or 255, either convert the data to 16-bit or use Stretch after ingestion.

The conversion of images from ISIS2 to ISIS3 follows the same rules as PDS images, except that the label information is propagated to the output file.

The best option to convert files from ISIS2 to ISIS is to maintain all the input file settings, and do not change the bit type or change any incoming pixel values to special pixels. When an ISIS2 Level1 image is imported into ISIS3, it is important to note the label information is not propagated from the ISIS2 to the ISIS cube file. For an ISIS2 Level2 image or mosaic file, a limited set of label information is transferred to the ISIS labels that include the "Instrument," "BandBin," and "Mapping" groups.

The example ingests a PDS formatted file, and outputs an ISIS cube file using the default settings for the program.

pds2isis from=input.img to=out.cub

Pds2isis GUI

Example GUI Screenshot shows the pds2isis GUI with the parameter settings.

The PDS formatted input file	This is a PDS image with attached labels.

The ISIS image cube after conversion

The ISIS output cube file Parameter Name: TO This screenshot displays the ouput of the pds2isis application.