GRASS logo

NAME

p.specpix - Classify pixels into ISIS3 special pixel categories.
Maps pixel DN values into ISIS3/PDS special pixel classes: NULL (missing), LRS (low repr. sat.), LIS (low instr. sat.), HIS (high instr. sat.), HRS (high repr. sat.). Output: 0=valid, 1=NULL, 2=LRS, 3=LIS, 4=HIS, 5=HRS.

KEYWORDS

Planetary, Spectral & Mineral Mapping, special pixels, ISIS3, spectral

SYNOPSIS

p.specpix
p.specpix --help
p.specpix input=name output=name [null_min=float] [null_max=float] [lrs_min=float] [lrs_max=float] [lis_min=float] [lis_max=float] [his_min=float] [his_max=float] [hrs_min=float] [hrs_max=float] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

--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=name [required]
Name of input raster map
output=name [required]
Name for output raster map
null_min=float
NULL minimum DN
Default: 0
null_max=float
NULL maximum DN
Default: 0
lrs_min=float
LRS minimum DN
Default: 1
lrs_max=float
LRS maximum DN
Default: 1
lis_min=float
LIS minimum DN
Default: 2
lis_max=float
LIS maximum DN
Default: 2
his_min=float
HIS minimum DN
Default: 65534
his_max=float
HIS maximum DN
Default: 65534
hrs_min=float
HRS minimum DN
Default: 65535
hrs_max=float
HRS maximum DN
Default: 65535

Table of contents

DESCRIPTION

p.specpix identifies and replaces special pixel values in a calibrated planetary raster. ISIS3-derived products may contain reserved DN values that encode instrument/processing status rather than physical measurements. These values must be removed before scientific analysis.

Special pixel types handled:

Type ISIS3 name Typical DN (uint16)
NULL Isis::Null 0
LRS Low Representation Saturation 1
LIS Low Instrument Saturation 2
HRS High Representation Saturation 65534
HIS High Instrument Saturation 65535

Replacement options: GRASS NULL (default), local neighbourhood mean, or a fixed user-specified DN.

EXAMPLES

Replace all special pixels with GRASS NULL:

p.specpix input=crism_raw output=crism_clean

Replace with neighbourhood mean (3×3 window):

p.specpix input=crism_raw output=crism_clean method=mean size=3

REFERENCES

NOTES

Special-pixel DN thresholds are read from the map's history metadata when populated by p.in.isis, and otherwise default to the ISIS3 standard values for uint16 data. For float-valued calibrated products (post-radiometric correction) only the NULL mask is relevant; LRS/LIS/HRS/HIS encoding does not survive the float conversion.

SEE ALSO

p.in.isis, r.null

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.specpix source code (history)

Accessed: Sunday Nov 15 11:06:08 2026


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

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