scopeinpython.utils

Small numerical/radiometric helpers used by RTMo: sint (Simpson-like integration), photon-energy conversions, Planck’s law.

Quick example

import numpy as np
from scopeinpython.utils import get_planck, satvap

L = get_planck(np.array([500.0, 800.0]), np.array([5778.0]))   # solar radiance, W/m2/sr/m
print(L)
es = satvap(np.array([20.0]))   # saturated vapour pressure at 20degC
print(es)

Input                              get_planck()              Output
---------------------------        ----------------------    ---------------------------
wl_nm  wavelength(s), nm                                      L  spectral radiance,
Tb     blackbody temperature, K   -------------------->        W m-2 sr-1 m-1 (Planck's law)
em     emissivity (optional)

Small numerical utilities shared across the RTMo pipeline.

Direct ports of SCOPEinR/R/Sint.R, e2phot.R, ephoton.R and Planck.R.

scopeinpython.utils.sint(y, x)[source]

Trapezoidal integration of y over x.

Direct port of SCOPEinR::Sint.

Parameters:
Return type:

float

scopeinpython.utils.get_ephoton(lambda_m, const=None)[source]

Energy content (J) of one photon at wavelength(s) lambda_m (m).

Direct port of SCOPEinR::get.ephoton.

Parameters:

  • lambda_m (ndarray)

  • const (dict | None)

Return type:

ndarray

scopeinpython.utils.get_e2phot(lambda_m, E, const=None)[source]

Number of moles of photons corresponding to E Joules of energy at wavelength(s) lambda (m).

Direct port of SCOPEinR::get.e2phot.

Parameters:
Return type:

ndarray

scopeinpython.utils.get_planck(wl_nm, Tb, em=None)[source]

Blackbody (or greybody) spectral radiance, Planck’s law.

Direct port of SCOPEinR::get.Planck.

Parameters:

  • wl_nm (array_like) – Wavelength(s), nm.

  • Tb (array_like) – Temperature(s), K.

  • em (array_like, optional) – Emissivity (default 1).

Return type:

ndarray

scopeinpython.utils.satvap(Temp)[source]

Saturated vapour pressure at temperature Temp (deg C), in hPa/mbar.

Direct port of SCOPEinR::satvap.

Parameters:

Temp (ndarray)

Return type:

ndarray