Isis 3 Application Documentation
Exports a cube to PNG, JPEG, TIFF format
Description
This program will export an Isis cube to one of several popular standard
formats. The formats may include PNG, JPEG, TIFF, BMP, and GIF. Not all
formats are available as the program implementation depends on the Qt
library by TrollTech. This program required 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 of 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.
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
|
|
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 type
|
Name
|
Description
|
| FORMAT | Format of output image |
| QUALITY | Specify output image quality |
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 type:
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)
|
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
|