GRASS logo

NAME

p.photomet - Apply photometric correction to a planetary raster.
Normalises a planetary raster to standard photometric conditions (i=e=g=0) using per-pixel geometry backplanes produced by p.phocube. Supported models: Lambert, LommelSeeliger, LunarLambert, Minnaert, HapkeHen, HapkeLeg, LunarLambertMcEwen.

KEYWORDS

Planetary, Photometric Analysis, photometry, Hapke, Minnaert

SYNOPSIS

p.photomet
p.photomet --help
p.photomet input=name output=name model=string incidence=name emission=name phase=name [k=float] [l=float] [wh=float] [hh=float] [b0=float] [hg1=float] [hg2=float] [theta=float] [bh=float] [ch=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
model=string [required]
Photometric model
Options: lambert, lommelseeliger, lunarlambert, minnaert, hapkehen, hapkeleg, lunarlambertmcewen
Default: minnaert
incidence=name [required]
Incidence angle raster [degrees] from p.phocube
emission=name [required]
Emission angle raster [degrees] from p.phocube
phase=name [required]
Phase angle raster [degrees] from p.phocube
k=float
Minnaert exponent K [0.5–1.0] (Minnaert model)
Default: 1.0
l=float
LunarLambert mixing weight L [0–1]
Default: 1.0
wh=float
Hapke single-scatter albedo ω (0,1]
Default: 0.5
hh=float
Hapke opposition surge width h
Default: 0.0
b0=float
Hapke opposition surge amplitude B₀
Default: 0.0
hg1=float
Hapke HG asymmetry coeff hg1 (-1,1) (HapkeHen)
Default: 0.0
hg2=float
Hapke HG 2nd coeff hg2 [0,1] (HapkeHen)
Default: 0.0
theta=float
Hapke macroscopic roughness angle Θ [0,90°]
Default: 0.0
bh=float
Hapke Legendre coeff b1 [-1,1] (HapkeLeg)
Default: 0.0
ch=float
Hapke Legendre coeff b2 [-1,1] (HapkeLeg)
Default: 0.0

Table of contents

DESCRIPTION

p.photomet normalises a calibrated planetary raster to standard photometric conditions (incidence i = emission e = phase g = 0°) using per-pixel geometry backplanes produced by p.phocube. The correction divides the measured radiance factor I/F by the photometric function evaluated at the actual geometry and multiplies by the function evaluated at the reference geometry.

Supported photometric models:

Model Formula (simplified)
Lambert μ₀ / π
LommelSeeliger μ₀ / (μ₀ + μ)
LunarLambert L·μ₀/π + (1−L)·μ₀/(μ₀+μ)
Minnaert A₀ · μ₀ᵏ · μᵏ⁻¹
HapkeHen Full Hapke with Henyey-Greenstein phase function
HapkeLeg Full Hapke with Legendre polynomial phase function
LunarLambertMcEwen Empirical lunar model (McEwen 1991)

where μ₀ = cos(i), μ = cos(e), g = phase angle.

NOTES

Hapke model parameters: wh (single-scatter albedo ω, 0–1), hh (opposition surge width h), b0 (opposition surge amplitude B₀), theta (macroscopic roughness θ̄, degrees), hg1, hg2 (Henyey-Greenstein asymmetry parameters), bh, ch (Legendre coefficients).

Pixels where μ₀ ≤ 0 or μ ≤ 0 (limb/terminator) are set to NULL.

EXAMPLES

LunarLambert correction with mixing weight L=0.5:

p.photomet input=ctx_dn \
    incidence=ctx_incidence emission=ctx_emission phase=ctx_phase \
    model=LunarLambert l=0.5 output=ctx_ll

Full Hapke (Henyey-Greenstein) correction for a Mars surface:

p.photomet input=hrsc_nd3 \
    incidence=hrsc_i emission=hrsc_e phase=hrsc_g \
    model=HapkeHen wh=0.52 hh=0.06 b0=1.5 theta=20.0 \
    hg1=0.213 hg2=0.4 output=hrsc_hapke

REFERENCES

SEE ALSO

p.phocube, p.photrim, p.albedo, p.atcorr.hapke

AUTHOR

Yann Chemin

SOURCE CODE

Available at: p.photomet source code (history)

Accessed: Sunday Nov 15 11:06:04 2026


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

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