ISIS 3 Application Documentation
Exports a cube to raw format
Description
This program will export an Isis cube to a greyscale raw formatted file.
The raw image may be output into an 8-bit, 16-bit unsigned, 16-bit signed
or 32-bit raw image. This raw image can be in BSQ, BIL, or BIP format, and
can include or exclude Null, Lrs, Lis, His, and/or Hrs specific DN values.
If no special pixel parameters are selected, then the special pixels are
mapped in the following manner; Low Saturation values and Null values are
made black and High Saturation values are made white.
In order to ensure acceptable contrast in the output file, three stretch
options are given 1) no stretch 2) linear, and 3) manual.
A custom maximum and minimum DN value can be specified for 8-bit as well as
16-bit unsigned and 16-bit signed raw outputs. For example, if a range of
0 to 1023 is selected in a 16-bit unsigned raw image, the DNs are stretched
to an effective 10-bit format.
Categories
Applications
History
| Tracie Sucharski | 1994-10-31 |
Original version
|
| Tracie Sucharski | 2002-08-06 |
Ported to Isis 3.0
|
| Tracie Sucharski | 2002-11-12 |
Correction made to number of bytes for writing data and changed
max for unsigned 16-bit data from 65536 to 65535.
|
| Kim Sides | 2003-05-13 |
Added application test
|
| Stuart Sides | 2003-05-16 |
Modified schema location from astogeology... to isis.astrogeology..."
|
| Jeff Anderson | 2003-08-27 |
Changed default extension handling mechanism
|
| Drew Davidson | 2005-06-14 |
Rewrote to support changes in underlying ProcessExport class
|
| Drew Davidson | 2005-06-15 |
Added code to export multiple bands
|
| Jeff Anderson | 2006-05-15 |
Modified to allow histogram percentage to be selected for
linear stretch option
|
| Steven Lambright | 2007-06-15 |
Updated documentation to follow current standards
|
| Steven Koechle | 2007-09-18 |
Fixed problem where the valid data range overlapped the null value.
|
| Christopher Austin | 2007-12-17 |
Created options to ouput BIL and BIP formats, making BSQ the default, as
well as added preserve special pixel (NULL) option.
|
| Christopher Austin | 2008-06-10 |
Created the options LRS, LIS, HIS, HRS, as well as OMIN and OMAX. Also
remade the GUI, and redid much of the documentation.
|
| Christopher Austin | 2008-07-07 |
Clarified some documentation and updated comments.
|
|
Parameter Groups
Files
|
Name
|
Description
|
| FROM |
Input cube to export
|
| TO |
Output raw file
|
Output Settings
|
Name
|
Description
|
| BITTYPE | Bit type of output file |
| OMIN |
The minimum output DN value including special pixels.
|
| OMAX |
The maximum output DN value including special pixels.
|
| NULL | Dedicates the minimum DN value for null pixels. |
| LRS | Dedicates a DN value for LRS pixels. |
| LIS | Dedicates a DN value for LIS pixels. |
| HIS | Dedicates a DN value for HIS pixels. |
| HRS | Dedicates a DN value for HRS pixels. |
Stretch Options
Output Data Storage Order
|
Name
|
Description
|
| ENDIAN | Endianness of the output bytes |
| STORAGEORDER | Storage order of output file. |
|
Files:
FROM
Description
Use this parameter to select the filename and band to export. For
example, file.cub+5 will select band 5
|
Type
| cube |
|
File Mode
| input |
|
Filter
|
*.cub
|
Files:
TO
Description
Use this parameter to specify the name of the output raw file.
If you do not include an extension of .raw it will be added.
|
Type
| filename |
|
File Mode
| output |
Output Settings:
BITTYPE
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
|
| 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
|
|
Output Settings:
OMIN
Description
If left blank, the minimum DN value used will default to the smallest
value possible for the provided bittype. Otherwise, the provided
value will be the minimum DN used (including special pixels).
|
Type
| double |
|
Internal Default
|
NULL
|
Output Settings:
OMAX
Description
If left blank, the maximum DN value used will default to the largest
value possible for the provided bittype. Otherwise the provided
value will be the maximum DN used (including special pixels).
|
Type
| double |
|
Internal Default
|
NULL
|
Output Settings:
NULL
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 |
Output Settings:
LRS
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 |
Output Settings:
LIS
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 |
Output Settings:
HIS
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 |
Output Settings:
HRS
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 |
Stretch Options:
STRETCH
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
|
LINEAR
|
|
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
|
| MANUAL | Manual stretch |
This option allows you to pick your own stretch. You must
enter a value for MINIMUM and MAXIMUM input pixel.
Exclusions
Inclusions
|
|
Stretch Options:
MINIMUM
Description
The minimum input pixel value which will be mapped to black.
|
Type
| double |
|
Less Than
| MAXIMUM
|
Stretch Options:
MAXIMUM
Description
The maximum input pixel value which will be mapped to white.
|
Type
| double |
|
Greater Than
| MINIMUM
|
Stretch Options:
MINPERCENT
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
|
Stretch Options:
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
|
Output Data Storage Order:
ENDIAN
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.
|
|
Output Data Storage Order:
STORAGEORDER
Description
Sets the storage order of the raw ouput file to either BSQ, BIL, or
BIP.
|
Type
| string |
|
Default
|
BSQ
|
|
Option List:
|
|
Option |
Brief |
Description |
| BSQ | Sets storage order to BSQ |
Sets the output storage order to Band Sequential.
|
| BIL | Sets storage order to BIL |
Sets the output storage order to Band Interleaved by Line.
|
| BIP | Sets storage order to BIP |
Sets the output storage order to Band Interleaved by Pixel.
|
|