GRASS logo

NAME

p.in.isis - Import an ISIS3 cube into GRASS raster map(s).
Reads an ISIS3 .cub file using GDAL's built-in ISIS3 driver. Equivalent to 'r.in.gdal' with additional ISIS3 metadata extraction (target body, band wavelengths, spiceinit status) stored in the raster history.

KEYWORDS

Planetary, Import & Export, import, raster, ISIS3, ISIS

SYNOPSIS

p.in.isis
p.in.isis --help
p.in.isis [-jeg] input=string output=name [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-j
Set the GRASS projection from the ISIS3 cube's map projection
-e
Extend region to fit the imported map
-g
Register output maps in a GRASS imagery group
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

input=string [required]
Path to the ISIS3 cube file (.cub)
output=name [required]
Name for output raster map

Table of contents

DESCRIPTION

p.in.isis imports an ISIS3 cube file (.cub) into one or more GRASS raster maps. ISIS3 cubes store a 512-byte (or multiple thereof) PVL label block followed by pixel data in BSQ, BIL, or BIP organisation. All ISIS3 pixel types are supported: UnsignedByte, SignedWord, UnsignedWord, SignedInteger, Real (32-bit float), Double (64-bit float).

The five ISIS3 special pixel values are mapped to GRASS NULL:

ISIS3 special Meaning
NULL Missing or invalid DN
LRS Low representation saturation
LIS Low instrument saturation
HRS High representation saturation
HIS High instrument saturation

Multi-band cubes produce maps named output.1, output.2, etc. The -g flag registers them in a GRASS imagery group.

NOTES

SPICE-attached cube geometry (CameraStatistics, Mapping groups in the ISIS3 label) is extracted and stored in the output raster's metadata when available.

EXAMPLES

Import an ISIS3 HiRISE RED cube:

p.in.isis input=PSP_001777_1650_RED.cub output=hirise_red
r.info hirise_red

Import a CTX cube and set the region to match:

p.in.isis input=ctx_edr.cub output=ctx_image
g.region raster=ctx_image

REFERENCES

SEE ALSO

p.in.pds3, p.out.isis, p.spiceinit

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.in.isis source code (history)

Accessed: Sunday Nov 15 11:06:00 2026


Main index | Paint index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual