eradiate.radprops.US76ApproxRadProfile
eradiate.radprops.US76ApproxRadProfile#
- class eradiate.radprops.US76ApproxRadProfile(thermoprops=_Nothing.NOTHING, has_absorption=True, has_scattering=True, absorption_data_set=None)[source]#
Bases:
eradiate.radprops._core.RadProfileRadiative 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. IfTrue, the absorption coefficient is computed. Else, the absorption coefficient is not computed and instead set to zero.has_scattering (
bool, default:True) – Scattering switch. IfTrue, 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. IfNone, 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
Warning
This class does not support
ckdmodes.Notes
The
us76module 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 thespectra-us76_u86_4absorption 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 thespectra-us76_u86_4dataset. 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_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
- eval_dataset_mono(w)[source]#
Return a dataset that holds the radiative properties of the corresponding atmospheric profile in monochromatic modes.
- 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.
- 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_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.
- property levels#
Return level altitudes.
- property thermoprops#
Return thermophysical properties.