Scattering phase functions#
A phase function describes how a single scattering event redistributes light with scattering angle. MomentRT’s scalar, axisymmetric models use the cosine \(\mu=\cos\theta\) and return probability density per steradian, normalized so that \(2\pi\int_{-1}^{1}p(\mu)\,d\mu=1\). They do not represent polarization or azimuth-dependent scattering.
The implementations live in separate modules under MomentRT.phase_function.
For example, from MomentRT.phase_function.henyey_greenstein import
HenyeyGreenstein imports that implementation directly. The existing
MomentRT.phase_function.HenyeyGreenstein and MomentRT.HenyeyGreenstein
paths remain available.
Available models#
MomentRT.phase_function.HenyeyGreenstein() uses the material’s supplied
anisotropy \(g\) and has normalized Legendre moments
\((1,g,g^2,g^3)\). Pass the phase-function object explicitly to each
material. A spectral material can provide a scalar or wavelength-dependent
anisotropy table.
Every Material and SpectralMaterial requires an explicit
phase_function object. P1 does not use its higher moments, but the object
still records the user’s physical choice.
MomentRT.phase_function.Isotropic() has moments \((1,0,0,0)\).
MomentRT.phase_function.Rayleigh() is the unpolarized scalar Rayleigh
phase function, with moments \((1,0,1/10,0)\). Their first moments are
zero, so material anisotropy may be omitted; if supplied, it must be zero.
Rayleigh and isotropic scattering thus have the same first moment but different
second moments.
MomentRT.phase_function.Tabulated(cosine=..., values=...) takes a
strictly increasing plain cosine grid spanning exactly -1 to 1 and nonnegative
relative density values. It linearly interpolates in cosine, normalizes the
result over 4 pi, and integrates its first three Legendre moments. The table
is fixed across a spectral material’s wavelength range; it does not automatically
compute wavelength-dependent Mie scattering. If an anisotropy is supplied, it
must agree with the table’s calculated first moment.
import numpy as np
import MomentRT
ureg = MomentRT.ureg
phase = MomentRT.phase_function.Tabulated(
cosine=np.array([-1.0, 0.0, 1.0]),
values=np.array([0.4, 1.0, 1.6]),
)
material = MomentRT.Material(
absorption=0.03 / ureg.millimeter,
reduced_scattering=1.0 / ureg.millimeter,
refractive_index=1.4,
phase_function=phase,
)
moments = phase.moments()
print(f"Phase moments: {moments}")
The input values are relative densities per unit solid angle sampled at cosine
values, not a probability histogram per angle. Converting measured or Mie
data requires the correct angular measure and normalization. Tabulation is
only as accurate as the supplied resolution, especially near sharp forward
peaks. A user-defined PhaseFunction subclass can provide its own density
and moments; moments used by the solvers are checked for normalization and
compatibility with a nonnegative distribution on [-1, 1].
How the solvers use moments#
The material’s reduced_scattering is \(\mu_s'=\mu_s(1-g_1)\), where
\(g_1\) is the selected phase function’s first moment. P1 only uses that
coefficient. SP3 and P3 additionally use \(g_2\) and \(g_3\) through
Consequently, changing the phase function while holding \(\mu_s'\) fixed can change SP3/P3 even when the first moment is unchanged. Phase-function selection does not change the solver’s source, boundary, or detector angular assumptions. See Compare scattering phase functions for a runnable comparison and NIST SCATMECH’s phase-function reference for related scalar models.