Isis 3 Application Documentation
Exports a cube to PNG, JPEG, TIFF, JPEG2000 format
Description
This program will export an Isis cube to one of several popular standard
formats. The formats may include PNG, JPEG, TIFF, BMP, GIF, and JP2.
Not all formats are available as the program implementation depends on the
Qt library by TrollTech. The JPEG2000 (JP2) format does not depend on the
Qt library for support. Support for JP2 is handled internally by the ISIS3
library. This program requires the input cube have exactly one band.
Therefore, you must input a cube with exactly one band or a multi-band
cube with a band specifier (e.g., file.cub+4). In addition if the cube
has Mapping labels, the program will produce a world file for use in Arc
and/or other GIS type packages. The file will have an extension that
uses the first and last letters for the image extenstion and a "w". For
example, tif produces a world file extension of tfw.
In order to ensure acceptable contrast in
the output file, three stretch options are given 1) linear,
2) piecewise-linear, and 3) manual.
Special pixels are mapped in the following manner, Low Saturation values
and Null are made black and High Saturation values are made white.
Please note: there is currently a 2GB filesize limit on the output image.
This limit does not apply to output JPEG2000 files. JPEG2000 files can
be output as 8-bit, signed 16-bit, or unsigned 16-bit files.
Categories
Related Applications in Previous Versions of Isis
This application replaces the following
applications existing in previous versions of Isis, which have been deprecated
from the current version of Isis:
- dform
- isis2tif
- isis2jpg
- isis2gisworld
Applications
History
Jeff Anderson | 2005-06-15 |
Original version
|
Drew Davidson | 2005-06-27 |
Added application test
|
Jacob Danton | 2006-02-06 |
Added two new modes (rgb and argb) and updated the appTest.
|
Elizabeth Miller | 2006-05-08 |
Added MIN and MAX percent options
|
Jacob Danton | 2006-05-22 |
Added seperate MINIMUM and MAXIMUM parameters for all channels.
|
Brendan George | 2007-05-03 |
Modified to use Filename class, and added appropriate appTest
|
Steven Lambright | 2007-07-10 |
Modified to give an error if write fails. Memory leak fixed.
|
Jeff Anderson | 2007-08-20 |
Modified so that ISIS Null pixels are written as zeros in the output cube
and low data in the input is written as a one
|
Steven Koechle | 2007-08-22 |
Added a check to see that raw image data will be less than 4GB.
Throw exception if it is too big.
|
Steven Lambright | 2008-05-12 |
Removed references to CubeInfo
|
Kris Becker | 2008-10-17 |
Added QUALITY parameter to set compression levels
|
Christopher Austin | 2008-11-04 |
Fixed checkDataSize() since Qimage has a maximum size of 2 GB, not 4GB.
Added some QT error catching.
|
Steven Koechle | 2009-02-20 |
Documentation Change
|
Janet Barrett | 2010-01-27 |
Added support for JPEG2000 files.
|
|
Parameter Groups
Files
Name
|
Description
|
FROM |
Input cube to export
|
ALPHA |
Input cube to export as the alpha channel
|
RED |
Input cube to export as the red channel
|
GREEN |
Input cube to export as the green channel
|
BLUE |
Input cube to export as the blue channel
|
TO |
Output file
|
MODE | Image mode |
Output Settings
Name
|
Description
|
FORMAT | Format of output image |
QUALITY | Specify output image quality |
BITTYPE | Bit type of output file |
Stretch Options
Name
|
Description
|
STRETCH | Type of stretch |
MINIMUM | Minimum pixel value |
MAXIMUM | Maximum pixel value |
AMIN | Minimum pixel value format the alpha channel |
AMAX | Maximum pixel value for the alpha channel |
RMIN | Minimum pixel value for the red channel |
RMAX | Maximum pixel value for the red channel |
GMIN | Minimum pixel value for the green channel |
GMAX | Maximum pixel value for the green channel |
BMIN | Minimum pixel value for the blue channel |
BMAX | Maximum pixel value for the blue channel |
MINPERCENT | Minimum Percent |
MAXPERCENT | Maximum Percent |
|
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:
ALPHA
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:
RED
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:
GREEN
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:
BLUE
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 image.
Don not include an extension as one will be automatically added.
Type
| filename |
File Mode
| output |
Files:
MODE
Description
This parameter specifies the image mode. If GRAYSCALE, a single one-band cube is used.
If RGB, three one-band cubes are used.
Type
| string |
Default
| GRAYSCALE |
Option List:
|
Option |
Brief |
Description |
GRAYSCALE | Grayscale mode |
A single channel image.
Exclusions
- ALPHA
- RED
- GREEN
- BLUE
- AMIN
- AMAX
- RMIN
- RMAX
- GMIN
- GMAX
- BMIN
- BMAX
|
RGB | RGB mode |
A three channel image (red, green, and blue).
Exclusions
- FROM
- ALPHA
- MINIMUM
- MAXIMUM
- AMIN
- AMAX
|
ARGB | ARGB mode |
A four channel image (alpha, red, green, and blue).
Exclusions
|
|
Output Settings:
QUALITY
Description
This parameter allows the user to specify level of quality
(compression) for the output image. Some output image types may
not utilize this parameter. The range is from 100 (no
compression and highest quality) to 0 (highest compression and
reduced quality). A value of -1 can be given to use the default
settings.
Type
| integer |
Default
| 100 |
Minimum
| -1
(inclusive)
|
Maximum
| 100
(inclusive)
|
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)
Type
| string |
Default
|
8BIT
|
Option List:
|
Option |
Brief |
Description |
8BIT | 8 bit unsigned integer data |
Pixels are in 8-bit unsigned integer data range (0 to 255).
|
U16BIT | 16 bit unsigned integer data |
Pixels are in the 16-bit unsigned integer data range (0 to 65535)
|
S16BIT | 16 bit signed integer data |
Pixels are in 16-bit signed integer data range (-32768 to 32767)
|
|
Stretch Options:
STRETCH
Description
This parameter is used to select one of three ways to stretch
(or map) output pixels. The are LINEAR, PIECEWISE, or MANUAL.
Type
| string |
Default
|
LINEAR
|
Option List:
|
Option |
Brief |
Description |
LINEAR | Linear stretch |
A minimum and maximum are automatically computed based on
the statistics of the selected 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
- MINIMUM
- MAXIMUM
- AMIN
- AMAX
- RMIN
- RMAX
- GMIN
- GMAX
- BMIN
- BMAX
|
PIECEWISE | Piecewise-linear stretch |
This option is similar to the LINEAR option. A minimum and
maximum are automatically computed. Additionally, the median
is computed and it is mapped to the middle gray value (halfway
between white and black). Therefore, it is a piecewise-linear
stretch with input pixels mapped linearly between either 1) the
minimum/median or 2) the median/maximum. This option is useful
for contrast stretching cubes with skewed histograms to ensure
a balanced contrast.
Exclusions
- MINIMUM
- MAXIMUM
- AMIN
- AMAX
- RMIN
- RMAX
- GMIN
- GMAX
- BMIN
- BMAX
|
MANUAL | Manual stretch |
This option allows you to pick your own stretch. You must
enter a value for MINIMUM and MAXIMUM
Exclusions
|
|
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:
AMIN
Description
The minimum input pixel value which will be mapped to black.
Type
| double |
Less Than
| AMAX
|
Stretch Options:
AMAX
Description
The maximum input pixel value which will be mapped to white.
Type
| double |
Greater Than
| AMIN
|
Stretch Options:
RMIN
Description
The minimum input pixel value which will be mapped to black.
Type
| double |
Less Than
| RMAX
|
Stretch Options:
RMAX
Description
The maximum input pixel value which will be mapped to white.
Type
| double |
Greater Than
| RMIN
|
Stretch Options:
GMIN
Description
The minimum input pixel value which will be mapped to black.
Type
| double |
Less Than
| GMAX
|
Stretch Options:
GMAX
Description
The maximum input pixel value which will be mapped to white.
Type
| double |
Greater Than
| GMIN
|
Stretch Options:
BMIN
Description
The minimum input pixel value which will be mapped to black.
Type
| double |
Less Than
| BMAX
|
Stretch Options:
BMAX
Description
The maximum input pixel value which will be mapped to white.
Type
| double |
Greater Than
| BMIN
|
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
|