ISIS 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 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.
CategoriesRelated 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: 02/21/2025 19:28:14 |
Parameter GroupsFiles
Color Model Options
Special Pixels
|
| 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: 02/21/2025 19:28:14 |
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: |
|
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 |
|
Special Pixels: NULLMIN
Description
Minimum valid value. Anything below this value will be set to LRS.
| Type | double |
|---|---|
| Inclusions |
|
Special Pixels: NULLMAX
Description
Maximum valid value. Anything above this value will be set to HRS.
| Type | double |
|---|---|
| Inclusions |
|
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 |
|
Special Pixels: HRSMIN
Description
Minimum valid value. Anything below this value will be set to LRS.
| Type | double |
|---|---|
| Inclusions |
|
Special Pixels: HRSMAX
Description
Maximum valid value. Anything above this value will be set to HRS.
| Type | double |
|---|---|
| Inclusions |
|
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 |
|
Special Pixels: LRSMIN
Description
Minimum valid value. Anything below this value will be set to LRS.
| Type | double |
|---|---|
| Inclusions |
|
Special Pixels: LRSMAX
Description
Maximum valid value. Anything above this value will be set to HRS.
| Type | double |
|---|---|
| Inclusions |
|
Example 1Converting 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
Input Image
Output Images
|
![Convert the image input.png to the Isis Cube argb.cub](javascript:popUpNewWindow ("assets/images/autoGui.jpg",614, 750))
![Input Image](javascript:popUpNewWindow ("assets/images/input.png",492, 492))
![Output Image in Black-and-White](javascript:popUpNewWindow ("assets/images/gray_argb.png",492, 492))
![Output Image in Color](javascript:popUpNewWindow ("assets/images/rgb.png",492, 492))
![Output Image in Color with Band 4 in Blue](javascript:popUpNewWindow ("assets/images/argb.png",492, 492))
| 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: 02/21/2025 19:28:14 |
Example 2Converting 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
Input Image
Output Image
|
![Convert the image input.png to the Isis Cube gray.cub](javascript:popUpNewWindow ("assets/images/grayGui.jpg",614, 750))
![Output Image](javascript:popUpNewWindow ("assets/images/gray.png",492, 492))
| 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: 02/21/2025 19:28:14 |
Example 3Converting 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
Input Image
Output Images
|
![Convert the image input.png to the Isis Cube rgb.cub](javascript:popUpNewWindow ("assets/images/colorGui.jpg",614, 750))
| 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: 02/21/2025 19:28:14 |