GRASS logo

NAME

p.atcorr.hapke - Apply Hapke-model atmospheric correction to a planetary raster.
Removes the effect of a thin planetary atmosphere (Mars, Titan) using one of four ISIS3-derived atmospheric scattering models (Isotropic1, Isotropic2, Anisotropic1, Anisotropic2). Requires per-pixel geometry backplanes from p.phocube.

KEYWORDS

Planetary, Photometric Analysis, atmospheric correction, Hapke, Mars

SYNOPSIS

p.atcorr.hapke
p.atcorr.hapke --help
p.atcorr.hapke input=name output=name incidence=name emission=name phase=name [model=string] [tau=float] [wha=float] [hnorm=float] [bha=float] [rho=float] [ah=float] [ab=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
incidence=name [required]
Incidence angle backplane [deg]
emission=name [required]
Emission angle backplane [deg]
phase=name [required]
Phase angle backplane [deg]
model=string
Atmospheric scattering model
Options: isotropic1, isotropic2, anisotropic1, anisotropic2
Default: isotropic1
tau=float
Atmospheric optical depth (tau) — Mars dust: 0.28–1.5
Default: 0.28
wha=float
Atmospheric dust single-scatter albedo (wha)
Default: 0.95
hnorm=float
Atmospheric shell thickness / planet radius
Default: 0.05
bha=float
Anisotropy parameter bha (Anisotropic models only)
Default: 0.85
rho=float
Surface albedo / reference albedo ratio rho
Default: 1.0
ah=float
Directional hemispheric albedo Ah (from photometric model)
Default: 0.5
ab=float
Bi-hemispheric albedo Ab
Default: 0.3

Table of contents

DESCRIPTION

p.atcorr.hapke applies atmospheric correction to a planetary raster using one of four Hapke radiative-transfer models from the p_atmosmodel library. The correction removes the contribution of atmospheric scattering and absorption, yielding a surface-leaving radiance factor I/F.

Atmospheric models:

Model Description
Isotropic1 Isotropic scattering, first-order approximation
Isotropic2 Isotropic scattering, Chandrasekhar H-function (second order)
Anisotropic1 Anisotropic (Henyey-Greenstein) scattering, first order
Anisotropic2 Anisotropic scattering, H-function (second order)

Parameters:

NOTES

The En and Ei integral tables are computed once per (tau, wha) pair and cached; changing only geometry parameters does not trigger recomputation.

For Mars, typical values are τ ≈ 0.3–1.5 (dust storm), ωₐ ≈ 0.9.

EXAMPLES

Apply Isotropic2 atmospheric correction to a MOC-NA image:

p.atcorr.hapke input=moc_na_dn \
    incidence=moc_incidence emission=moc_emission \
    model=Isotropic2 tau=0.5 wha=0.92 output=moc_atcorr

REFERENCES

SEE ALSO

p.photomet, p.albedo

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.atcorr.hapke source code (history)

Accessed: Sunday Nov 15 11:05:54 2026


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

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