Radiation

The radiation module contains data structures for holding the radiation variables used in DISORT.

class pyrt.radiation.IncidentFlux(beam_flux=3.141592653589793, isotropic_flux=0.0)[source]

A data structure for holding the incident fluxes.

IncidentFlux creates scalars for the incident beam and isotropic fluxes and performs checks that the input fluxes are valid inputs to DISORT.

Parameters
  • beam_flux (float) – The intensity of the incident beam at the top boundary. Ensure this variable and isotropic_flux have the same units. Note that this is an infinitely wide beam.

  • isotropic_flux (float) – The intensity of the incident beam at the top boundary. Ensure this variable and beam_flux have the same units.

Raises

TypeError – Raised if either input flux cannot be cast into a float.

Return type

None

Notes

If thermal_emission is set to True, this is assumed to have the same units as PLKAVG (which defaults to [\(\frac{\text{W}}{\text{m}^2}\)]) and the corresponding incident flux is umu0 * beam_flux and pi * isotropic_flux. If thermal_emission is set to False, beam_flux and isotropic_flux have arbitrary units, and the output fluxes and intensities are assumed to have the same units as these variables.

property beam_flux: float

Get the input flux of the incident beam at the top boundary.

Notes

In DISORT, this variable is named FBEAM.

property isotropic_flux: float

Get the input flux of isotropic sources at the top boundary.

Notes

In DISORT, this variable is named FISOT.

class pyrt.radiation.ThermalEmission(thermal_emission=False, bottom_temperature=0.0, top_temperature=0.0, top_emissivity=1.0)[source]

A data structure for holding thermal emission variables.

ThermalEmission creates variables needs to include thermal emission in DISORT.

Parameters
  • thermal_emission (bool) –

    Denote whether to use thermal emission. If True, DISORT will include thermal emission and will need the following variables:

    • bottom_temperature

    • top_temperature

    • top_emissivity

    • low_wavenumber (aka WVNMLO)

    • high_wavenumber (aka WVNMHI)

    • temperature (aka TEMPER)

    If False, DISORT will save computation time by ignoring all thermal emission and all of the aforementioned variables.

  • bottom_temperature (float) – The temperature of the bottom boundary [K].

  • top_temperature (float) – The temperature of the top boundary [K].

  • top_emissivity (float) – The emissivity of the top boundary.

Raises
  • TypeError – Raised if bottom_temperature, top_temperature, or top_emissivity cannot be cast to a float.

  • ValueError – Raised if bottom_temperature or top_temperature is negative, or if top_emissivity is not between 0 and 1.

Return type

None

See also

Spectral, Hydrostatic

property bottom_temperature: float

Get the input temperature at the bottom boundary [K].

Notes

In DISORT, this variable is named BTEMP. It is only used by DISORT if thermal_emission is set to True.

property thermal_emission: bool

Get whether thermal emission will be used in the model.

Notes

In DISORT, this variable is named PLANK.

property top_emissivity: float

Get the input emissivity at the top boundary.

Notes

In DISORT, this variable is named TEMIS. It is only used by DISORT if thermal_emission is set to True.

property top_temperature: float

Get the input temperature at the top boundary [K].

Notes

In DISORT, this variable is named TTEMP. It is only used by DISORT if thermal_emission is set to True.