ISIS Application Documentation
Export an Isis mosaicked ideal cube from a HiRISE image to a PDS product
containing related spice data.
Description
Categories
Groups
History
Description
This application takes an Isis cube from the HiRISE instrument that
has been jitter corrected and mosaicked and exports it to a PDS product
with detached label and spice tables.
The following output files will be created using the file name passed in by the user.
-
PDS image file with the extension .img
-
PDS label file with the extension .lbl
-
PDS binary ck table file with the suffix _INSTRUMENT_POINTING_TABLE.dat
-
PDS binary spk table file with the suffix _INSTRUMENT_POSITION_TABLE.dat
-
PDS binary body rotation table file with the suffix _BODY_ROTATION_TABLE.dat
-
PDS binary sun position table file with the suffix _SUN_POSITION_TABLE.dat
The output PDS image will be unsigned word 16 bit type, MSB, BSQ format
and the resolution will be in meters.
Note that the IMAGE_JITTER_CORRECTED keyword is copied from the input
cube. If the input cube has been run through an older version of hijitter,
this value will be set to UNK, since it is not known whether the image
values have been jitter corrected.
Categories
Parameter Groups
Files
Name
|
Description
|
FROM |
Isis ideal camera cube to be exported to PDS format
|
TO |
Output PDS file name.
|
Special Keywords
Name
|
Description
|
VERSION |
Value for the output PDS keyword PRODUCT_VERSION_ID
|
RATIONALE_DESC |
Value for the output PDS keyword RATIONALE_DESC
|
Stretch
Name
|
Description
|
TYPE |
Select the type of stretch
|
MIN |
Lower bound of the stretch
|
MAX |
Upper bound of the stretch
|
MINPER |
Minimum DN valid percentage
|
MAXPER |
Mazimum DN valid percentage
|
Output Controls
Name
|
Description
|
BITS |
Number of bits for the output DN
|
Files:
FROM
Description
The Ideal cube from a HiRISE image containing the related spice data
to be exported to PDS.
Type
| cube |
File Mode
| input |
Filter
|
*.cub *.lbl
|
Files:
TO
Description
The file name of the output PDS image. This value will also be used
for the name of the detached label and table files.
Type
| filename |
File Mode
| output |
Filter
|
*.img
|
Special Keywords:
VERSION
Description
This parameter allows the user to specify the value of the standard
PDS keyword PRODUCT_VERSION_ID within the output PDS label. This
keyword will be located in the Root of the PDS PVL label. This value
defaults to 1.0.
Special Keywords:
RATIONALE_DESC
Description
This parameter allows the user to specify the value of the standard
PDS keyword RATIONALE_DESC within the output PDS label. This keyword
will be located in the ROOT of the PDS PVL label. Note that if a
keyword value is not entered, the value will be read from the input
cube labels. If it does not exist there, the program will throw an ]
error.
Type
| string |
Internal Default
| Preserve Original Rationale Description |
Stretch:
TYPE
Description
This parameter is used to select one of two ways to stretch output
pixels. The are AUTOMATIC or MANUAL.
Type
| string |
Default
| AUTOMATIC |
Option List:
|
Option |
Brief |
Description |
AUTOMATIC | Automatically calculate stretch | Automatically calculate stretchExclusions
|
MANUAL | User defined stretch | User defined stretchExclusions
|
|
Stretch:
MIN
Description
Lower bound for the manually specified stretch.
Stretch:
MAX
Description
Upper bound for the manually specified stretch.
Stretch:
MINPER
Description
The cumulative percentage value to be mapped to the minimum
valid pixel for the specified number of bits. For example: With BITS=10
and MINPER=1.0, the DN which corresponds to the cummulative
percent of 1.0 will be mapped to 3, where 0 represents NULL, 1
represents LRS and 2 represents LIS.
Type
| double |
Default
|
0.0
|
Minimum
| 0.0
(inclusive)
|
Maximum
| 100.0
(inclusive)
|
Less Than or Equal
|
|
Stretch:
MAXPER
Description
The cumulative percentage value to be mapped to the maximum
valid pixel for the specified number of bits. For example: With BITS=10
and MINPER=99.0, the DN which corresponds to the cummulative
percent of 99.0 will be mapped to 1021, 1021=(2**bits)-1-2.
Where 1023 represents HIS and 1022 represents HRS.
Type
| double |
Default
|
100.0
|
Minimum
| 0.0
(inclusive)
|
Maximum
| 100.0
(inclusive)
|
Greater Than or Equal
|
|
Output Controls:
BITS
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.
Type
| integer |
Default
|
10
|
Minimum
| 8
(inclusive)
|
Maximum
| 16
(inclusive)
|
History
Jeannie Backer | 2012-11-21 |
Original Version of hideal2pds. Fixes #678.
|
Makayla Shepherd | 2015-10-06 |
Added stretch parameters. Fixes #1761.
|
Tyler Wilson | 2019-02-08 |
Added an option to control the output bits. min = 8, max =16, default = 10. Fixes #5527.
|
Timothy Giroux | 2020-09-08 |
Output label now has the correct SAMPLE_BIT_MASK value according to bits input. Fixes #3978.
|