GRASS logo

NAME

p.in.pds4 - Import a PDS4 planetary data product into GRASS raster map(s).
Reads a PDS4 XML label and its referenced binary data file (Array_2D_Image or Array_3D_Image) and writes GRASS raster maps. Multi-band products create output.1, output.2, etc.

KEYWORDS

Planetary, Import & Export, import, raster, PDS4

SYNOPSIS

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

Flags:

-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 PDS4 XML label file (.xml)
output=name [required]
Name for output raster map

Table of contents

DESCRIPTION

p.in.pds4 imports Array_2D_Image and Array_3D_Image data objects from a PDS4 XML-labelled planetary product into GRASS raster maps. The XML label file (.xml) is parsed to locate the binary data file and the array axes (lines × samples × bands). Calibration via offset and scaling_factor XML attributes is applied:

physical = offset + DN × scaling_factor

Multi-band (Array_3D_Image) products produce maps named output.1, output.2, etc. The -g flag registers them in an imagery group.

NOTES

PDS4 uses UTF-8 XML labels. The internal XML parser handles nested File_Area_Observational and Array_2D_Image / Array_3D_Image elements as defined in the PDS4 Information Model.

Byte order is taken from the <Element_Array><data_type> field; IEEE754MSBSingle, IEEE754MSBDouble, SignedMSB2, UnsignedMSB2 etc. are supported.

EXAMPLES

Import a MESSENGER MDIS NAC PDS4 product:

p.in.pds4 input=EW0211981.xml output=mdis_nac

Import a multi-band Europa Clipper EIS product:

p.in.pds4 -g input=eis_nac_20300101.xml output=eis_cube

REFERENCES

SEE ALSO

p.in.pds3, p.in.isis, r.in.gdal

AUTHOR

Yann Chemin

SOURCE CODE

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

Accessed: Sunday Nov 15 11:06:01 2026


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

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