Home
About ISIS
Support
Download

ISIS 3

Documentation
Tutorials
Technical Documents

ISIS 2

Documentation
Tutorials
Technical Documents

Search

USGS

ISIS 3 Application Documentation


std2isis

Printer Friendly View | TOC | Home

Imports a cube from PNG, JPEG, JP2, BMP or TIFF format

Overview Parameters Example 1 Example 2 Example 3

Description

This program will import several standard image formats to an Isis cube. The input image formats may include PNG, JPEG, JP2, TIFF, BMP, and GIF. Not all formats are available as the program implementation depends on the Qt library by TrollTech. This is not true of JPEG2000 files (JP2). It has support in the ISIS3 library. By default, the number of bands in the output cube will be one, three, and four when the input image is all gray, RGB, and RGB with an alpha channel, respectively. The user can, however, specify the color mode manually. The JP2 file can have any number of bands up to 16384. The output from a JP2 file will be a multi-spectral ISIS3 image file.

Categories


Related Objects and Documents

Applications


History

Steven Lambright2007-07-18 Original version
Steven Koechle2007-08-29 Added special pixel ranges and updated example images
Travis Addair2009-12-01 Added support for RGB and ARGB imports.
Travis Addair2009-12-03 Added AUTO option for automatically determining MODE.
Travis Addair2009-12-04 Changed example and added two new examples.
Janet Barrett2010-01-24 Added support for JPEG2000 files.
Kimberly Oyama2014-01-17 Updated the default app test to make sure the history group is in the resulting cube label. References #1894.

Parameter Groups

Files

Name Description
FROM Input image file to import
TO Output image

Color Model Options

Name Description
MODEMode for determining color model

Special Pixels

Name Description
SETNULLRANGECreate special pixel values
NULLMIN Minimum valid value
NULLMAX Maximum valid value
SETHRSRANGECreate special pixel values
HRSMIN Minimum valid value
HRSMAX Maximum valid value
SETLRSRANGECreate special pixel values
LRSMIN Minimum valid value
LRSMAX Maximum valid value
X

Files: FROM


Description

Use this parameter to select the filename to import.

Type filename
File Mode input
Filter *.PNG *.JPG* .JPEG *.BMP *.TIF *.TIFF *.GIF *.JP2
Close Window
X

Files: TO


Description

Use this parameter to specify the name of the output cube.

Type cube
File Mode output
Pixel Type real
Close Window
X

Color Model Options: MODE


Description

This parameter specifies the image mode for the output cube. If GRAYSCALE, a single one-band cube will be created. If RGB, a three-band cube is created. Finally, if ARGB is selected, then a four-band cube will be created where the four bands correspond to first Red, second Green, third Blue, and last Alpha.

Type string
Default AUTO
Option List:
Option Brief Description
AUTOAutomatically determine output mode Checks to see if the image is a grayscale image, and if not, if it has an alpha channel, and sets the output mode accordingly.
GRAYSCALEGrayscale mode A single-channel image.
RGBRGB mode A three-channel image (red, green, and blue).
ARGBARGB mode A four-channel image (red, green, blue, and alpha).
Close Window
X

Special Pixels: SETNULLRANGE


Description

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type boolean
Default NO
Inclusions
  • NULLMIN
  • NULLMAX
Close Window
X

Special Pixels: NULLMIN


Description

Minimum valid value. Anything below this value will be set to LRS.

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: NULLMAX


Description

Maximum valid value. Anything above this value will be set to HRS.

Type double
Inclusions
  • SETNULLRANGE
Close Window
X

Special Pixels: SETHRSRANGE


Description

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type boolean
Default NO
Inclusions
  • HRSMIN
  • HRSMAX
Close Window
X

Special Pixels: HRSMIN


Description

Minimum valid value. Anything below this value will be set to LRS.

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: HRSMAX


Description

Maximum valid value. Anything above this value will be set to HRS.

Type double
Inclusions
  • SETHRSRANGE
Close Window
X

Special Pixels: SETLRSRANGE


Description

If this option is used input raw pixels below minimum and above maximum will be converted to LRS and HRS respectively. Otherwise pixels in the input raw file will be left unchanged in most cases. For example, importing a raw 8-bit file and outputing to a 16-bit or 32-bit real will cause 0 and 255 to be actual values. If left as 8-bit then 0 will be NULL and 255 will be HRS.

Type boolean
Default NO
Inclusions
  • LRSMIN
  • LRSMAX
Close Window
X

Special Pixels: LRSMIN


Description

Minimum valid value. Anything below this value will be set to LRS.

Type double
Inclusions
  • SETLRSRANGE
Close Window
X

Special Pixels: LRSMAX


Description

Maximum valid value. Anything above this value will be set to HRS.

Type double
Inclusions
  • SETLRSRANGE
Close Window

Example 1

Converting an image to an Isis Cube in Automatic mode

Description

This example will show the conversion from a color PNG image to a cube, automatically determining the color mode. Here, the output image will be a four-band ARGB cube, because the input image is both in color, and has an alpha channel.

Command Line

std2isis from=input.png to=argb.cub
Convert the PNG to an Isis Cube, with the default option of automatically determining the color mode

GUI Screenshot

Convert the image input.png to the Isis Cube argb.cub

Example GUI

Screenshot of the GUI for std2isis, ready to convert the image input.png to the Isis Cube argb.cub, with mode left at its default of AUTOMATIC.

Input Image

Input Image

Input Image

The input image, a color PNG in this example.

Output Images

Output Image in Black-and-White

Output Isis Cube with Grayscale

The four-band ARGB output image viewed in black-and-white with a grayscale.

Output Image in Color

Output Isis Cube with RGB

The same four-band ARGB output image viewed in color with RGB filtering (Band 1 = Red, Band 2 = Green, Band 3 = Blue). Note that the image here appears brighter than the original, because qview has auto-stretched the DN values, and can be adjusted back with qview's "stretch" tool. The actual data, however, has not been changed.

Output Image in Color with Band 4 in Blue

Output Isis Cube with RGA

The same four-band ARGB output image viewed in color with RGB filtering as in the previous image, but here Band 4 (the alpha channel) is viewed through the Blue filter.


Example 2

Converting an image to an Isis Cube in Grayscale mode

Description

This example will show the conversion from a color PNG image to a cube, with the color mode set to GRAYSCALE, meaning that the output image will be a single-band black-and-white cube.

Command Line

std2isis from=input.png to=gray.cub mode=grayscale
Convert the image input.png to the Isis Cube gray.cub. In order to get a single-band black-and-white image, we set the mode equal to GRAYSCALE.

GUI Screenshot

Convert the image input.png to the Isis Cube gray.cub

Example GUI

Screenshot of the GUI for std2isis, ready to convert the image input.png to the Isis Cube gray.cub with mode set to GRAYSCALE.

Input Image

Input Image

Input Image

The input image, in this example, the same color PNG from the previous example.

Output Image

Output Image

Output Isis Cube

The is the output Isis Cube peaks.cub generated from this example.


Example 3

Converting an image to an Isis Cube in RGB mode

Description

This example will show the conversion from a color PNG image to a cube, with the color mode set to RGB, meaning that the output image will be a three-band color cube.

Command Line

std2isis from=input.png to=rgb.cub mode=rgb
Convert the image input.png to the Isis Cube rgb.cub. In order to get a three-band color image, we set the mode equal to RGB.

GUI Screenshot

Convert the image input.png to the Isis Cube rgb.cub

Example GUI

Screenshot of the GUI for std2isis, ready to convert the image input.png to the Isis Cube rgb.cub with mode set to RGB.

Input Image

Input Image

Input Image

The input image, in this example, the same color PNG from the first example.

Output Images

Output Image in Black-and-White

Output Isis Cube with Grayscale

The three-band RGB output image viewed in black-and-white with a grayscale.

Output Image in Color

Output Isis Cube with RGB

The same three-band RGB output image viewed in color with RGB filtering (Band 1 = Red, Band 2 = Green, Band 3 = Blue). Once again, the output image appears to be brighter than the original due to qview's auto-stretching, but can be adjusted in qview with the "stretch" tool.