Home

User Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Contributor Documentation

Getting Started
Learn More
Explore in Detail
Get Inspired

Quick Links

Software Manual
AstroDiscuss
GitHub
API Reference

Documentation Versions

Public Release
8.1.0
8.0.0
7.2.0
7.1.0
7.0.0
6.0.0
3.9.0
3.5.0

ISIS 2

Documentation
Tutorials
Technical Documents
USGS

ISIS Application Documentation

std2isis

Standard View | TOC | Home

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

Description
Categories
Groups
Examples
History

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 ISIS 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 ISIS image file.

Categories

Related Objects and Documents

Applications

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

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

Files: TO

Description

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

Type cube
File Mode output
Pixel Type real

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).

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

Special Pixels: NULLMIN

Description

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

Type double
Inclusions
  • SETNULLRANGE

Special Pixels: NULLMAX

Description

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

Type double
Inclusions
  • SETNULLRANGE

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

Special Pixels: HRSMIN

Description

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

Type double
Inclusions
  • SETHRSRANGE

Special Pixels: HRSMAX

Description

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

Type double
Inclusions
  • SETHRSRANGE

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

Special Pixels: LRSMIN

Description

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

Type double
Inclusions
  • SETLRSRANGE

Special Pixels: LRSMAX

Description

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

Type double
Inclusions
  • SETLRSRANGE

Examples

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.

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.