toolsrtm.leaf

Leaf optical property models: calctav, PROSPECT-D, PROSPECT-PRO. Direct port of ToolsRTM/R/calctav.R, prospect_DB.R, prospect_PRO.R.

Leaf optical property models: calctav, PROSPECT-D, PROSPECT-PRO.

Direct, function-by-function port of:

  • ToolsRTM/R/calctav.R

  • ToolsRTM/R/prospect_DB.R (PROSPECT-D, exposed here as prospect_d)

  • ToolsRTM/R/prospect_PRO.R (PROSPECT-PRO, exposed here as prospect_pro)

References

Feret J-B, Gitelson AA, Noble SD & Jacquemoud S, 2017. PROSPECT-D: Towards modeling leaf optical properties through a complete lifecycle. Remote Sensing of Environment, 193, 204-215.

Feret, J.B., Berger, K., de Boissieu, F., Malenovsky, Z., 2021. PROSPECT-PRO for estimating content of nitrogen-containing leaf proteins and other carbon-based constituents. Remote Sens. Environ. 252.

Stern F. (1964); Allen W.A. (1973): transmissivity of a dielectric surface (calctav).

toolsrtm.leaf.calctav(alpha, nr)[source]

Transmissivity of a dielectric plane surface, averaged over all directions of incidence and polarizations.

Direct port of ToolsRTM::calctav.

Parameters:

  • alpha (float) – Maximum incidence angle (degrees) defining the solid angle of incident light.

  • nr (array_like) – Refractive index spectrum (or scalar).

Returns:

Transmissivity of a dielectric plane surface, same shape as nr.

Return type:

numpy.ndarray

References

Stern F. (1964), Transmission of isotropic radiation across an interface between two dielectrics, Appl. Opt., 3(1):111-113. Allen W.A. (1973), Transmission of isotropic light across a dielectric surface in two and three dimensions, J. Opt. Soc. Am., 63(6):664-666.

class toolsrtm.leaf.LeafOptics(lambda_, refl, tran)[source]

Bases: object

Output of a leaf RT model: wavelength, reflectance and transmittance.

Parameters:
lambda_: ndarray
refl: ndarray
tran: ndarray
toolsrtm.leaf.prospect_d(N, Cab, Car, Anth, Cbrown, EWT, LMA, alpha=40.0)[source]

PROSPECT-D leaf optical properties model (400-2500 nm, 1 nm step).

Direct port of ToolsRTM::prospect_DB (also called PROSPECT-Dynamic with brown pigments in the R source).

Parameters:

  • N (float) – Leaf structure parameter.

  • Cab (float) – Chlorophyll a+b content (microg/cm2).

  • Car (float) – Carotenoid content (microg/cm2).

  • Anth (float) – Anthocyanin content (microg/cm2).

  • Cbrown (float) – Brown pigment content (arbitrary units).

  • EWT (float) – Equivalent water thickness (g/cm2).

  • LMA (float) – Leaf mass per area (g/cm2).

  • alpha (float, default 40) – Maximum incidence angle for calctav.

Returns:

lambda_ (400-2500 nm), refl, tran.

Return type:

LeafOptics

toolsrtm.leaf.prospect_pro(N, Cab, Car, Anth, Cbrown, EWT, LMA, alpha, Prot, CBC)[source]

PROSPECT-PRO leaf optical properties model (400-2500 nm, 1 nm step).

Direct port of ToolsRTM::prospect_PRO.

Parameters:

  • N (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • Cab (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • Car (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • Anth (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • Cbrown (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • EWT (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • LMA (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • alpha (see prospect_d().) – Note: Anth is expressed in nmol/cm2 for PROSPECT-PRO (vs microg/cm2 for PROSPECT-D), consistent with the R implementation.

  • Prot (float) – Protein content (g/cm2).

  • CBC (float) – Non-protein carbon-based constituent content (g/cm2).

Return type:

LeafOptics

Notes

Mirrors the R behaviour: if LMA > 0 and (Prot > 0 or CBC > 0), LMA is forced to 0 (LMA = Prot + CBC), with a message.

Returns:

lambda_ (400-2500 nm), refl, tran.

Return type:

LeafOptics

Parameters:

  • N (float)

  • Cab (float)

  • Car (float)

  • Anth (float)

  • Cbrown (float)

  • EWT (float)

  • LMA (float)

  • alpha (float)

  • Prot (float)

  • CBC (float)