Isis 3 Application Documentation
Exports a cube to a PNG, BMP, GIF, TIFF, JPEG, or JPEG 2000
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. Furthermore, Qt can only export Isis cubes less
than 2GB in file size. The JPEG2000 (JP2) and TIFF formats do not depend
on the Qt library, and can export arbitrarily large cubes. Because these
cubes and writing routines are streamed lines at a time, very little of
the image will ever be held in memory at one time, so exporting to JP2 or
TIFF is suggested for large images. TIFFs and JPEG 2000s can also be
output as 8-bit, signed 16-bit, or unsigned 16-bit files.
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.
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.
|
Stuart Sides and Steven Lambright | 2012-04-03 |
Added minimum and maximum input stretch values and output file
name to the output log. fixes #761
|
Travis Addair | 2012-04-03 |
Added support for exporting cubes greater than 2GB to TIFFs.
|
Steven Lambright | 2012-08-28 |
Fixed some problems with the big tiff exports that caused
corrupt outputs. The 2GB limitation should be removed
completely now. References #579.
|
|
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
|