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 ISIS3. The
order of precedence for special pixels in ISIS from highest to lowest
priority is the following:
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. 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 ISIS3 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 ISIS3 cube file.
For an ISIS2 Level2 image or mosaic file, a limited set of label
information is transferred to the ISIS3 labels that include the "Instrument,"
"BandBin," and "Mapping"
groups.
Modified schema location from "astrogeology" to "isis.astrogeology."
Stuart Sides
2003-06-04
Fixed Makefile.
Stuart Sides
2003-10-10
Converted to use new IsisImport instead of IsisPdsImport.
Stuart Sides
2004-02-20
Converted to use the new IsisImportPds class and added
import labels to the output cube.
Brendan George
2006-09-28
Documentation fixes.
Stuart Sides
2007-01-25
Added ability to transfers Isis2 instrument and bandbin
information.
Tracie Sucharski
2007-04-10
Added LatitudeType2 group to translation table to handle CTX cubes.
Additonal changes to projection translation tables for other possible
values for Longitude direction, latitude type. If the min or max
longitude values are greater than 180, change longitude domain to 360.
Only call TranslateIsis2Labels if pds file is an Isis2 cube.
Steven Lambright
2007-08-07
Added support for copying some PDS labels, if they exist, into the output.
Steven Koechle
2007-08-29
Added special pixel ranges. Added examples.
Steven Lambright
2008-05-13
Removed references to CubeInfo.
Christopher Austin
2008-09-15
Fixed problem with special pixel range functionality and documentation.
Added HIS and LIS range options.
Stuart Sides
2012-08-08
Added translations for BAND_BIN_CENTER, BAND_BIN_WIDTH, and BAND_BIN_FILTER_NUMBER from
NIMS RDR products fixes #1029.
Ella Mae Lee
2012-11-09
Improve the documentation, document capability to import ISIS2 images,
fixes #1172.
Kimberly Oyama
2012-11-21
Added app tests for BIP and BIL formatted input. References #819.
Tyler Wilson
2016-02-25
Added an app test for opening Galileo NIMS qubes saved in VAX format. Modified the filter
tag on FROM parameter in this document to also recognize *.qub files. All changes
relating to converting VAX to IEEE were made in ProcessImport, ProcessImportPds.
References: #2368.
Summer Stapleton
2017-06-27
Added conditional to check whether default offsets and multipliers where changed from their
default values and log them if so.
Specify a PDS file, PDS label file, or ISIS2 cube file. If the
input file is a PDS detached label file and the companion image
file is not in the same directory, use the parameter "IMAGE" to
define the location and filename of the image, otherwise just
enter the label file name.
If this option is set to "yes" or "true", a range of input raw pixels
defined by the NULLMIN and NULLMAX parameters are converted to NULL
pixels. All other valid pixels that do not fall within the ranges
specified for LIS, LRS, HIS, and HRS pixels are transferred to the output file
unchanged. If the bit type of the input
file is changed, the NULL and HRS special
pixels may be incorrectly set to valid pixel values. For example,
if a raw 8-bit file is output to 16 or 32-bit, the pixel values "0"
and "255" may be converted to actual values instead of retaining the
special pixel property. If the output file remains as 8-bit, then "0"
stays as NULL and "255" stays as HRS.
If this option is set to "yes" or "true", a range of input raw pixels
defined by the HRSMIN and HRSMAX parameters are converted to HRS
pixels. All other valid pixels that do not fall within the ranges
specified for LIS, LRS, HIS, and NULL pixels are transferred to the output file
unchanged. If the bit type of the input
file is changed, the NULL and HRS special
pixels may be incorrectly set to valid pixel values. For example,
if a raw 8-bit file is output to 16 or 32-bit, the pixel values "0"
and "255" may be converted to actual values instead of retaining the
special pixel property. If the output file remains as 8-bit, then "0"
stays as NULL and "255" stays as HRS.
If this option is set to "yes" or "true", a range of input raw pixels
defined by the HISMIN and HISMAX parameters are converted to HIS
pixels. All other valid pixels that do not fall within the ranges
specified for LIS, LRS, HRS, and NULL pixels are transferred to the
output file unchanged.
If this option is set to "yes" or "true", a range of input raw pixels
defined by the LRSMIN and LRSMAX parameters are converted to LRS
pixels. All other valid pixels that do not fall within the ranges
specified for LIS, HIS, HRS, and NULL pixels are transferred to the
output file unchanged.
If this option is set to "yes" or "true", a range of input raw pixels
defined by the LISMIN and LISMAX parameters are converted to LIS
pixels. All other valid pixels that do not fall within the ranges
specified for LRS, HIS, HRS, and NULL pixels are transferred to the
output file unchanged.
