ISIS Application Documentation
isis2std | Printer Friendly View | TOC | Home |
Exports a cube to PNG, BMP, TIFF, JPEG, or JPEG 2000
Overview | Parameters | Example 1 |
DescriptionThis program exports an ISIS cube to one of several popular standard image formats. The current supported formats are BMP, JPEG, JP2, PNG, and TIFF. This program uses TrollTech's version of the Qt Library to export BMP and JPEG formatted output images. For these format types, due to limitations of Qt, the input file size must not exceed 2 gigabytes and the only valid output bit type is 8-bit. The JPEG2000 (JP2) and TIFF formats do not depend on the Qt library. These formats do not have the 2 GB limitation for input files and the output bit type may be 8-bit, U16-bit or S16-bit. For these formats, the writing routines output are streamed lines from the cube, and little of the image is held in memory at any one time, therefore increasing the processing speed to convert the file. It is recommended that large images are exported to JP2 or TIFF format. For some output image types, users may specify a value for the level of compression represented as a percentage using the QUALITY parameter. The default is no compression (i.e. QUALITY = 100%). For the TIFF format a compression algorithm can be selected. Each of the input cube parameters (FROM, ALPHA, RED, GREEN, and BLUE) requires a single band from an ISIS cube. If a cube contains multiple bands, the user must specify a single band of the input image. To do this, the user must append a plus sign and the band number to be used to the input file name. For example, inputFile.cub+4 indicates that the 4th band in the cube will be used. No band needs to be specified if the cube only has a single band. In addition, if the cube has Mapping labels, the program will produce a world file for use in Arc and/or other GIS packages. The file will have an extension that uses the first and last letters for the image extension and a "w". For example, .tif produces a world file extension of .tfw. To ensure acceptable contrast in the output file, the user may select from three stretch options: linear, piecewise-linear, or manual. Special pixels such as Low Saturation values and Nulls are set to black and High Saturation values are set to white. See the BITTYPE parameter documentation for more information about which output pixel values are assigned for particular input DNs of the various bit types. CategoriesRelated Applications to Previous Versions of ISISThis program replaces the following applications existing in previous versions of ISIS:
Related Objects and DocumentsApplicationsHistory
|
U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 05/27/2022 18:35:21 |
Parameter GroupsFiles
Output Settings
Stretch Options
|
U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 05/27/2022 18:35:21 |
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 |
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 |
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 |
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 |
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 |
Use this parameter to specify the name of the output file.
Type | filename |
---|---|
File Mode | output |
This parameter specifies the image mode. If GRAYSCALE, a single one-band cube is used. If RGB, three one-band cubes are used. If ARGB, four one-band cubes are used.
Type | string | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | GRAYSCALE | ||||||||||||
Option List: |
|
This parameter is used to select the output format. It can be one of PNG, BMP, JPEG, TIF, or JP2. Note that not all formats may be available. It will depend on your installation of the Qt libraries.
In addition, if the cube has Mapping labels, the program will produce a world file for use in Arc and/or other GIS packages. The file will have an extension that uses the first and last letters for the image extension and a "w". For example, .tif produces a world file extension of .tfw.
Type | string | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | PNG | ||||||||||||||||||
Option List: |
|
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) |
This parameter allows the userPackBits is also known as Macintosh RLE. to set the bit type of the output image. Some FORMAT values will only allow 8-bit outputs. 16 bit signed (-32767=black, 32768=white)
Type | string | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | 8BIT | ||||||||||||
Option List: |
|
The compression algorithm used to compress an output TIFF format image. Only used if the format is set to TIFF. The default is no compression. PACKBITS is the most widely supported compression algorithm for the TIFF format.
Type | string | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Default | NONE | |||||||||||||||
Option List: |
|
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: |
|
The minimum input pixel value which will be mapped to black.
Type | double |
---|---|
Less Than | MAXIMUM |
The maximum input pixel value which will be mapped to white.
Type | double |
---|---|
Greater Than | MINIMUM |
The minimum input pixel value which will be mapped to black.
Type | double |
---|---|
Less Than | AMAX |
The maximum input pixel value which will be mapped to white.
Type | double |
---|---|
Greater Than | AMIN |
The minimum input pixel value which will be mapped to black.
Type | double |
---|---|
Less Than | RMAX |
The maximum input pixel value which will be mapped to white.
Type | double |
---|---|
Greater Than | RMIN |
The minimum input pixel value which will be mapped to black.
Type | double |
---|---|
Less Than | GMAX |
The maximum input pixel value which will be mapped to white.
Type | double |
---|---|
Greater Than | GMIN |
The minimum input pixel value which will be mapped to black.
Type | double |
---|---|
Less Than | BMAX |
The maximum input pixel value which will be mapped to white.
Type | double |
---|---|
Greater Than | BMIN |
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 |
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 |
Example 1Example of red/green/blue output of isis2std program. Description
This example creates an output TIFF format file from 3 bands of an ISIS cube, designated
red, green, and blue using a linear stretch and 8-bit output type. A histogram is created
from the input values. Using this histogram, we determine the minimum value to be any DN
in the bottom 0.2% of the data. These DNs will be set to black in the output. Similarly,
the maximum value is any DN in the top 99.8% of the data and these DNs will be set to white.
Command Line
isis2std
red=rgb.cub+1 green=rgb.cub+2 blue=rgb.cub+3 to=rgb.tif mode=rgb format=tiff bittype=8bit stretch=linear minpercent=0.2 maxpercent=99.8
Command line for this example.
GUI ScreenshotInput ImagesData File
Output Image |
U.S. Department of the Interior | U.S. Geological Survey ISIS | Privacy & Disclaimers | Astrogeology Research Program To contact us, please post comments and questions on the USGS Astrogeology Discussion Board To report a bug, or suggest a feature go to: ISIS Github File Modified: 05/27/2022 18:35:21 |