GRASS logo

NAME

p.iirs.correct - Thermal emission correction for Chandrayaan-2 IIRS Level-2 radiance (Verma et al. 2022).

KEYWORDS

imagery, hyperspectral, thermal correction, Chandrayaan-2, IIRS, Moon, planetary

SYNOPSIS

p.iirs.correct
p.iirs.correct --help
p.iirs.correct [-g] input=name output=name [solar_flux=string] [emissivity=float] [wave_lo=float] [wave_hi=float] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-g
Create output imagery group (adds all reflectance bands to the named output group via i.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=name [required]
IIRS L2 radiance imagery group (256 bands from ISSDC ENVI file)
All 256 IIRS bands must be present in group order (band 1 = 712 nm). Import via r.in.gdal from ISSDC ENVI cube and add bands to imagery group with i.group.
output=name [required]
Output raster base name
Produces <output>.b001..<output>.bNNN thermally-corrected reflectance maps (800-5000 nm subset) plus <output>.temp temperature raster.
solar_flux=string
Solar irradiance spectrum file (optional)
Two-column ASCII file: wavelength_nm, solar_irradiance. Must cover all 256 IIRS bands (712-5010 nm). If omitted, the bundled IIRS solar reference spectrum is used.
emissivity=float
Surface emissivity (0-1)
Assumed constant emissivity for the Planck thermal component. Default 0.95 follows Verma et al. (2022) for the lunar regolith.
Default: 0.95
wave_lo=float
Lower wavelength bound (nm) for temperature retrieval window
Temperature is estimated by Planck-function inversion across [wave_lo, wave_hi]. Default 4500-4874 nm is the thermal region used in Verma et al. (2022).
Default: 4500
wave_hi=float
Upper wavelength bound (nm) for temperature retrieval window
Default: 4874

Table of contents

DESCRIPTION

p.iirs.correct applies the thermal emission correction algorithm of Verma, Chauhan & Chauhan (2022) to a Chandrayaan-2 Imaging Infrared Spectrometer (IIRS) Level-2 radiance imagery group, producing thermally corrected reflectance and a per-pixel surface temperature map.

The algorithm:

  1. Estimates surface temperature per pixel by inverting the Planck function in the 4500–4874 nm thermal window (configurable via wave_lo=/wave_hi=).
  2. Computes the blackbody thermal emission spectrum at that temperature.
  3. Subtracts the thermal component from the measured radiance and divides by the solar irradiance to obtain reflectance: R = π(L − ε·B_T) / F_solar.
  4. Applies empirical per-band correction coefficients (Verma et al. 2022, Table S1, 240 values for the 800–5000 nm output window).
  5. Smooths each spatial pixel's spectrum with a 3-point moving average.

The first 7 and last 2 of the 256 IIRS bands are discarded (known detector-edge artefacts). Only the 800–5000 nm output window is written.

INPUT DATA

IIRS Level-2 data is distributed by the Indian Space Research Organisation (ISRO) through the ISSDC portal (issdc.gov.in) and requires user registration. Files are in ENVI format. Import one cube with r.in.gdal, then collect all 256 bands into an imagery group with i.group:

# Split all 256 bands on import
r.in.gdal -r input=ch2_iirs_nbl_20191012T0722_v01.img output=iirs_rad

# Collect into group (bands are named iirs_rad.1 .. iirs_rad.256)
i.group group=iirs_rad \
    input=$(g.list type=raster pattern="iirs_rad.*" separator=,)

OUTPUT FILES

Map Content
<output>.b001 … <output>.bNNN Thermally-corrected reflectance, one map per band (800–5000 nm)
<output>.temp Per-pixel surface temperature (K), coloured bcyr

When -g is set, all reflectance maps are also collected into an imagery group named <output>.

PARAMETERS

Parameter Default Description
input= required Imagery group with 256 IIRS L2 radiance bands
output= required Output raster base name
solar_flux= bundled Two-column ASCII file: wavelength_nm, irradiance (256 rows)
emissivity= 0.95 Surface emissivity assumed constant (lunar regolith default)
wave_lo= 4500 Lower bound (nm) of the temperature retrieval window
wave_hi= 4874 Upper bound (nm) of the temperature retrieval window

FLAGS

Flag Effect
-g Create output imagery group containing all reflectance bands

NOTES

EXAMPLE

# Import and group a full IIRS scene
r.in.gdal -r input=ch2_iirs_nbl_20191012T0722_orbit_00399_v01.img \
    output=iirs_rad
i.group group=iirs_rad \
    input=$(g.list type=raster pattern="iirs_rad.*" separator=,)

# Thermal correction with defaults (emissivity=0.95, bundled solar flux)
p.iirs.correct input=iirs_rad output=iirs_corr -g

# Inspect temperature
r.univar map=iirs_corr.temp
d.rast iirs_corr.temp

# Use 3 µm hydration feature: band depth around 2800 nm in the output group
p.mineral.indices input=iirs_corr body=moon indices=bd2800

REFERENCES

Verma, P.A., Chauhan, M., & Chauhan, P. (2022). Lunar surface temperature estimation and thermal emission correction using Chandrayaan-2 imaging infrared spectrometer data for H₂O & OH detection using 3 µm hydration feature. Icarus, 383, 115075. https://doi.org/10.1016/j.icarus.2022.115075

SEE ALSO

p.in.archive, p.mineral.indices, p.spec.pca, i.group, r.in.gdal

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.iirs.correct source code (history)

Accessed: Sunday Nov 15 11:05:59 2026


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

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