eradiate.radprops.US76ApproxRadProfile#

class eradiate.radprops.US76ApproxRadProfile(thermoprops=NOTHING, has_absorption=True, has_scattering=True, absorption_data_set=None)[source]#

Bases: eradiate.radprops._core.RadProfile

Radiative properties profile approximately corresponding to an atmospheric profile based on the original U.S. Standard Atmosphere 1976 atmosphere model.

Parameters
  • thermoprops (Dataset, default: us76.make_profile) – Thermophysical properties.

  • has_absorption (bool, default: True) – Absorption switch. If True, the absorption coefficient is computed. Else, the absorption coefficient is not computed and instead set to zero.

  • has_scattering (bool, default: True) – Scattering switch. If True, the scattering coefficient is computed. Else, the scattering coefficient is not computed and instead set to zero.

  • absorption_data_set (str) – Absorption data set file path. If None, the default absorption data sets will be used to compute the absorption coefficient. Otherwise, the absorption data set whose path is provided will be used to compute the absorption coefficient.

Fields
  • has_absorption (bool) – Absorption switch.

  • has_scattering (bool) – Scattering switch.

  • absorption_data_set (str) – Absorption data set file path.

Warning

This class does not support ckd modes.

Notes

  • The us76 module implements the original U.S. Standard Atmosphere 1976 atmosphere model, as defined by the [NNU76] technical report. In the original atmosphere model, the gases are assumed well-mixed below the altitude of 86 kilometers. In the present radiative properties profile, the absorption coefficient is computed using the spectra-us76_u86_4 absorption dataset. This dataset provides the absorption cross section of a specific mixture of N2, O2, CO2 and CH4, the mixing ratio of which are those defined by the U.S. Standard Atmosphere 1976 model for the region of altitudes under 86 kilometers, where these four gas species are well-mixed. As a result, the dataset is representative of the U.S. Standard Atmosphere 1976 model only below 86 kilometers. Since the atmosphere is typically a hundred kilometers high or more in radiative transfer applications, and in order to make the radiative properties profile reach these altitudes, the absorption coefficient is nevertheless computed using the spectra-us76_u86_4 dataset. This approximation assumes that the absorption coefficient does not vary much whether the mixing ratios of the absorbing gas mixture are those below or above 86 km.

  • Furthermore, the U.S. Standard Atmosphere 1976 model includes other gas species than N2, O2, CO2 and CH4. They are: Ar, He, Ne, Kr, H, O, Xe, He and H2. All these species except H2 are absent from the HITRAN spectroscopic database. Since the absorption datasets are computed using HITRAN, the atomic species could not be included in spectra-us76_u86_4. H2 was mistakenly forgotten and should be added to the dataset in a future revision.

  • We refer to the U.S. Standard Atmosphere 1976 atmosphere model as the model defined by the set of assumptions and equations in part 1 of the report, and “numerically” illustrated by the extensive tables in part 4 of the report. In particular, the part 3, entitled Trace constituents, which provides rough estimates and discussions on the amounts of trace constituents such as ozone, water vapor, nitrous oxide, methane, and so on, is not considered as part of the U.S. Standard Atmosphere 1976 atmosphere model because it does not clearly defines the concentration values of all trace constituents at all altitudes, neither does it provide a way to compute them.

  • It seems that the identifier “US76” is commonly used to refer to a standard atmospheric profile used in radiative transfer applications. However, there appears to be some confusion around the definition of that standard atmospheric profile. In our understanding, what is called the “US76 standard atmospheric profile”, or “US76” in short, is not the U.S. Standard Atmosphere 1976 atmosphere model but instead the so-called “U.S. Standard (1976) atmospheric constituent profile model” in a AFGL technical report entitled AFGL Atmospheric Constituent Profiles (0-120km) and published in 1986 by Anderson et al [ACC+86]. Although the “U.S. Standard (1976) atmospheric profile model” of the AFGL’s report is based on the U.S. Standard Atmosphere 1976 atmosphere model (hence the name), it is significantly different when it comes about the gas species concentration profiles. Notably, the “U.S. Standard (1976) atmospheric profile model” of the AFGL’s report include radiatively active gases such as H2O, O3, N2O, and CO, that the U.S. Standard Atmosphere 1976 atmosphere model does not include.

eval_albedo(spectral_ctx)#

Evaluate albedo spectrum based on a spectral context. This method dispatches evaluation to specialised methods depending on the active mode.

Parameters

spectral_ctx (SpectralContext) – A spectral context data structure containing relevant spectral parameters (e.g. wavelength in monochromatic mode, bin and quadrature point index in CKD mode).

Returns

quantity – Evaluated spectrum as an array with length equal to the number of layers.

eval_albedo_ckd(*bindexes, bin_set_id)[source]#

Evaluate albedo spectrum in CKD modes.

Parameters

*bindexes (Bindex) – One or several CKD bindexes for which to evaluate the spectrum.

Returns

quantity – Evaluated profile albedo as an array with shape (n_layers, len(bindexes)).

eval_albedo_mono(w)[source]#

Evaluate albedo spectrum in monochromatic modes.

Parameters

w (quantity) – Wavelength values at which the spectrum is to be evaluated.

Returns

quantity – Evaluated profile albedo as an array with shape (n_layers, len(w)).

eval_dataset(spectral_ctx)#

Return a dataset that holds the radiative properties of the corresponding atmospheric profile. This method dispatches evaluation to specialised methods depending on the active mode.

Parameters

spectral_ctx (SpectralContext) – A spectral context data structure containing relevant spectral parameters (e.g. wavelength in monochromatic mode).

Returns

Dataset – Radiative properties dataset.

eval_dataset_ckd(*bindexes, bin_set_id)[source]#

Return a dataset that holds the radiative properties of the corresponding atmospheric profile in CKD modes

Parameters
  • *bindexes (Bindex) – One or several CKD bindexes for which to evaluate spectra.

  • bin_set_id (str) – CKD bin set identifier.

Returns

Dataset – Radiative properties dataset.

eval_dataset_mono(w)[source]#

Return a dataset that holds the radiative properties of the corresponding atmospheric profile in monochromatic modes.

Parameters

w (quantity) – Wavelength values at which spectra are to be evaluated.

Returns

Dataset – Radiative properties dataset.

eval_sigma_a(spectral_ctx)#

Evaluate absorption coefficient spectrum based on a spectral context. This method dispatches evaluation to specialised methods depending on the active mode.

Parameters

spectral_ctx (SpectralContext) – A spectral context data structure containing relevant spectral parameters (e.g. wavelength in monochromatic mode, bin and quadrature point index in CKD mode).

Returns

quantity – Evaluated spectrum as an array with length equal to the number of layers.

eval_sigma_a_ckd(*bindexes, bin_set_id)[source]#

Evaluate absorption coefficient spectrum in CKD modes.

Parameters
  • *bindexes (Bindex) – One or several CKD bindexes for which to evaluate the spectrum.

  • bin_set_id (str) – CKD bin set identifier.

Returns

quantity – Evaluated profile absorption coefficient as an array with shape (n_layers, len(bindexes)).

eval_sigma_a_mono(w)[source]#

Evaluate absorption coefficient spectrum in monochromatic modes.

Parameters

w (quantity) – Wavelength values at which the spectrum is to be evaluated.

Returns

quantity – Evaluated profile absorption coefficient as an array with shape (n_layers, len(w)).

eval_sigma_s(spectral_ctx)#

Evaluate scattering coefficient spectrum based on a spectral context. This method dispatches evaluation to specialised methods depending on the active mode.

Parameters

spectral_ctx (SpectralContext) – A spectral context data structure containing relevant spectral parameters (e.g. wavelength in monochromatic mode, bin and quadrature point index in CKD mode).

Returns

quantity – Evaluated spectrum as an array with length equal to the number of layers.

eval_sigma_s_ckd(*bindexes)[source]#

Evaluate scattering coefficient spectrum in CKD modes.

Parameters

*bindexes (Bindex) – One or several CKD bindexes for which to evaluate the spectrum.

Returns

quantity – Evaluated profile scattering coefficient as an array with shape (n_layers, len(bindexes)).

eval_sigma_s_mono(w)[source]#

Evaluate scattering coefficient spectrum in monochromatic modes.

Parameters

w (quantity) – Wavelength values at which the spectrum is to be evaluated.

Returns

quantity – Evaluated profile scattering coefficient as an array with shape (n_layers, len(w)).

eval_sigma_t(spectral_ctx)#

Evaluate extinction coefficient spectrum based on a spectral context. This method dispatches evaluation to specialised methods depending on the active mode.

Parameters

spectral_ctx (SpectralContext) – A spectral context data structure containing relevant spectral parameters (e.g. wavelength in monochromatic mode, bin and quadrature point index in CKD mode).

Returns

quantity – Evaluated spectrum as an array with length equal to the number of layers.

eval_sigma_t_ckd(*bindexes, bin_set_id)[source]#

Evaluate extinction coefficient spectrum in CKD modes.

Parameters

*bindexes (Bindex) – One or several CKD bindexes for which to evaluate the spectrum.

Returns

quantity – Evaluated profile extinction coefficient as an array with shape (n_layers, len(bindexes)).

eval_sigma_t_mono(w)[source]#

Evaluate extinction coefficient spectrum in monochromatic modes.

Parameters

w (quantity) – Wavelength values at which the spectrum is to be evaluated.

Returns

quantity – Evaluated profile extinction coefficient as an array with shape (n_layers, len(w)).

property levels#

Return level altitudes.

property thermoprops#

Return thermophysical properties.