Skip to content

Absorption Module Methods & Types ​

Downloading HITRAN Data ​

Use artifact("CO2"), artifact("H2O"), and related artifact names to resolve packaged HITRAN .par files. See HITRAN Data Management and the Library for the canonical artifact helpers.

Reading HITRAN Files ​

Use read_hitran to select molecule/isotopologue records and spectral windows from HITRAN .par files.

Defining Models with Cross-Section Parameters ​

Use make_hitran_model for line-by-line cross sections and make_interpolation_model for lookup-table interpolation workflows.

Computing Absorption Cross-Sections ​

Use absorption_cross_section(model, ν, pressure, temperature) to evaluate the selected line-shape or interpolation model on a wavenumber grid.

Types ​

Hitran Data Structure Type ​

vSmartMOM.Absorption.HitranTable Type
julia
struct HitranTable{FT}

A struct, which provides all HITRAN line parameters needed to compute absorption cross sections

See https://hitran.org/docs/definitions-and-units/ for details

Fields

  • mol: The molecular species identification (ID) number

  • iso: The isotopologue ID number

  • νᵢ: The wavenumber of the spectral line transition (cm-1) in vacuum

  • Sᵢ: The spectral line intensity (cm−1/(molecule·cm−2)) at Tref=296K

  • Aᵢ: The Einstein-A coefficient (s-1) of a transition

  • γ_air: The air-broadened half width at half maximum (HWHM) (cm−1/atm) at Tref=296K and reference pressure pref=1atm

  • γ_self: The self-broadened half width at half maximum (HWHM) (cm−1/atm) at Tref=296K and reference pressure pref=1atm

  • E″: The lower-state energy of the transition (cm-1)

  • n_air: The coefficient of the temperature dependence of the air-broadened half width

  • δ_air: The pressure shift (cm−1/atm) at Tref=296K and pref=1atm of the line position with respect to the vacuum transition wavenumber νij

  • global_upper_quanta: The electronic and vibrational quantum numbers and labels for the upper state of a transition

  • global_lower_quanta: The electronic and vibrational quantum numbers and labels for the lower state of a transition

  • local_upper_quanta: Rotational, hyperfine and other quantum numbers and labels for the upper state of a transition

  • local_lower_quanta: Rotational, hyperfine and other quantum numbers and labels for the lower state of a transition

  • ierr: Ordered list of indices corresponding to uncertainty estimates of transition parameters

  • iref: Ordered list of reference identifiers for transition parameters

  • line_mixing_flag: A flag indicating the presence of additional data and code relating to line-mixing

  • g′: The upper state degeneracy

  • g″: The lower state degeneracy

source

Broadening Function Types ​

The primary broadening models are Doppler, Lorentz, and Voigt. The canonical docstrings are grouped in the Library.

Complex Error Function Types ​

vSmartMOM.Absorption.HumlicekErrorFunction Type

Humlicek only formulation for Complex Error Function

source
vSmartMOM.Absorption.HumlicekWeidemann32VoigtErrorFunction Type

Mix of Humlicek and Weidemann (N=32) Error Function, suggested for Voigt function

source
vSmartMOM.Absorption.HumlicekWeidemann32SDErrorFunction Type

Mix of Humlicek and Weidemann (N=32) Error Function, suggested for Speed Dependent Voigt function

source
vSmartMOM.Absorption.CPF12ErrorFunction Type

Humlicek with a single rational approximation.

source
vSmartMOM.Absorption.ErfcHumliErrorFunctionVoigt Type

Mix of Humplicek and erfc Special Function for Voigt

source
vSmartMOM.Absorption.ErfcHumliErrorFunctionSD Type

Mix of Humplicek and erfc Special Function for Voigt

source
vSmartMOM.Absorption.ErfcErrorFunction Type

erfc Special Function for Voigt

source

Cross-Section Model Types ​

vSmartMOM.Absorption.HitranModel Type
julia
struct HitranModel{FT}

A struct which provides all model parameters needed for cross-section calculations using HITRAN data

Fields

  • hitran: Struct with hitran data

  • broadening: Broadening function (Doppler/Lorentz/Voigt)

  • wing_cutoff: Wing cutoff [cm-1]

  • vmr: VMR of gas itself [0-1]

  • CEF: Complex Error Function to Use

  • architecture: Computer Architecture on which Model is run

source
vSmartMOM.Absorption.InterpolationModel Type
julia
struct InterpolationModel{FT}

A struct which provides all model parameters needed for cross-section calculations using an Interpolator

Fields

  • itp: The interpolator

  • mol: The molecular species identification (ID) number

  • iso: The isotopologue ID number

  • ν_grid: Wavelength grids

  • p_grid: Wavelength grids

  • t_grid: Wavelength grids

source