scopeinpython.rtmz

SCOPE canopy zeaxanthin RTM: the small modification of TOC outgoing radiance due to violaxanthin-to-zeaxanthin conversion in leaves (photoprotection, 500-600nm). Direct port of SCOPEinR/R/RTMz.R (get.RTMz). Structurally close to scopeinpython.rtmf.rtmf() (same geometric-factor setup, same layer-recursion pattern) but works directly in the wavelength domain (no excitation-emission matrix) and returns corrections to be added onto an existing RTMoResult, rather than a self-contained new spectrum.

RTMz: SCOPE canopy zeaxanthin (“Z”) radiative transfer model.

Direct port of SCOPEinR::get.RTMz (SCOPEinR/R/RTMz.R), computing the small modification of TOC outgoing radiance due to the violaxanthin-to-zeaxanthin conversion in leaves (a photoprotection signal, 500-600 nm). Structurally very similar to scopeinpython.rtmf.rtmf() (same geometric-factor setup, same layer-recursion pattern) but simpler: RTMz works directly in the 500-600 nm wavelength domain (no excitation-emission matrix like Mb/Mf – the zeaxanthin signal is a per-wavelength reflectance/transmittance difference, reflZ - refl / tranZ - tran, not a fluorescence redistribution), and produces a correction to be added onto an existing RTMoResult’s Lo_/rso/rdo/rfl/ Eout_ at the 500-600 nm band, rather than a self-contained new spectrum on its own display grid (RTMf’s LoF_ etc).

Verified against SCOPEinR::get.RTMz – see python/docs/verification.rst for the numerical comparison.

class scopeinpython.rtmz.RTMzResult(Lo_delta, rso_delta, rdo_delta, Eout_delta, LoF_)[source]

Bases: object

Corrections to be ADDED to the corresponding 500-600nm slice of an existing RTMoResult (indices _IWLFI = wlZ_native - 400 into any wlS-grid array, or equivalently spectral.wlS[_IWLFI] == _WLZ_NATIVE).

Parameters:
Lo_delta: ndarray
rso_delta: ndarray
rdo_delta: ndarray
Eout_delta: ndarray
LoF_: ndarray
scopeinpython.rtmz.rtmz(spectral, rtmo, canopy, tts, tto, psi, rsoil, refl, tran, reflZ, tranZ, Knu, Knh)[source]

Direct port of SCOPEinR::get.RTMz (see module docstring).

Parameters:
Return type:

RTMzResult