scopeinpython.soil

Brightness-Shape-Moisture (BSM) soil reflectance model. Direct port of SCOPEinR/R/BSM.R.

Brightness-Shape-Moisture (BSM) soil reflectance model.

Direct, function-by-function port of SCOPEinR/R/BSM.R.

References

Original Matlab/R version: Christiaan van der Tol. Verhoef & Bach (2007); Jacquemoud, Baret & Hanocq (1992).

class scopeinpython.soil.SoilParams(BSMBrightness, BSMlat, BSMlon)[source]

Bases: object

Soil brightness/shape parameters for BSM (soilpar in the R code).

Parameters:

  • BSMBrightness (float)

  • BSMlat (float)

  • BSMlon (float)

BSMBrightness: float
BSMlat: float
BSMlon: float
class scopeinpython.soil.WettingParams(SMp, SMC=25.0, film=0.015)[source]

Bases: object

Empirical wetting parameters for BSM (emp in the R code).

Parameters:

  • SMp (float)

  • SMC (float)

  • film (float)

SMp: float
SMC: float = 25.0
film: float = 0.015
scopeinpython.soil.get_bsm(soilpar, emp, optipar=None)[source]

Brightness-Shape-Moisture soil reflectance spectrum (400-2400 nm).

Direct port of SCOPEinR::getBSM.

Parameters:

  • soilpar (SoilParams) – BSMBrightness, BSMlat, BSMlon.

  • emp (WettingParams) – SMp, SMC, film.

  • optipar (BSMOptipar, optional) – GSV/Kw/nw spectral basis. Defaults to the bundled optipar2017.ProspectD subset (scopeinpython._data.bsm_optipar()).

Returns:

Wet soil reflectance spectrum, 400-2400 nm (1 nm step).

Return type:

numpy.ndarray, shape (2001,)

scopeinpython.soil.soilwat(rdry, nw, kw, SMp, SMC, film)[source]

Wet soil reflectance from dry soil reflectance, following a Poisson process for the number of water film layers (Verhoef 2012; Yang 2020).

Direct port of SCOPEinR::soilwat.

Parameters:

  • rdry (array_like, shape (nwl,)) – Dry soil reflectance spectrum.

  • nw (array_like, shape (nwl,)) – Refraction index of water spectrum.

  • kw (array_like, shape (nwl,)) – Absorption coefficient of water spectrum.

  • SMp (float) – Soil moisture volume percentage (5-55).

  • SMC (float) – Soil moisture capacity (recommended 25, i.e. 0.25 in [0,1] units used consistently with the R default of 25).

  • film (float) – Effective optical thickness of a single water film (recommended 0.015).

Returns:

Wet soil reflectance spectrum (equals rdry if mu <= 0).

Return type:

numpy.ndarray, shape (nwl,)