spectral_propmatAddCIA

Workspace.spectral_propmatAddCIA(self, spectral_propmat: pyarts3.arts.PropmatVector | None = None, spectral_propmat_jac: pyarts3.arts.PropmatMatrix | None = None, select_species: pyarts3.arts.SpeciesEnum | None = None, jac_targets: pyarts3.arts.JacobianTargets | None = None, freq_grid: pyarts3.arts.AscendingGrid | None = None, atm_point: pyarts3.arts.AtmPoint | None = None, abs_cia_data: pyarts3.arts.ArrayOfCIARecord | None = None, T_extrapolfac: pyarts3.arts.Numeric | None = None, ignore_errors: pyarts3.arts.Index | None = None) → None

Add absorption coefficients for HITRAN collision induced absorption (CIA).

This interpolates the cross sections from abs_cia_data. If too few temperature grid-points are available, its polynomial order of interpolation decreases to the maximum allowed. Otherwise, both frequency and temperature are interpolated using third order polynomials.

Given that the interpolation is \(\vec{x}_{ij} = f\left(T, \vec{f}\right)\), where the atm_point temperature is \(T\) and \(f\) is the freq_grid, \(i\) is an index into the abs_cia_data and \(j\) is an index into the underlying CIARecord data structure, the absorption coefficient from CIA is given by

\[vec{\alpha}_\mathbf{CIA} = \sum_i n_{i,0} n_{i,1} \sum_j vec{x}_{ij}\]

where \(n_{i,0}\) and \(n_{i,1}\) are number densities of the two species involved in the CIA.

The input T_extrapolfac sets a limit on the interpolation along the temperature grid of the data. If the temperature grid is \([T_0, T_1, \cdots, T_{n-1}, T_n]\), then this method throws an error if

\[T < T_0 - \Delta T_e \left(T_1 - T_0\right)\]

or

\[T > T_n + \Delta T_e \left(T_n - T_{n-1}\right)\]

where \(\Delta T_e\) is the extrapolation factor given by T_extrapolfac. If this happens to you and you believe you can use the computations anyways, set T_extrapolfac to a very large or infinite value.

The frequnecy grid interpolation is limited to within the range of the available data. Any point in freq_grid outside this range will simply be ignored. The frequency interpolation can thus not fail.

Note

ignore_errors can be set to 1 to suppress runtime errors, but any error will result in NaN values in the output. This is useful if you want to debug your results, but not if you want to use them.

Author: Stefan Buehler, Oliver Lemke

Parameters:

  • spectral_propmat (PropmatVector, optional) – This contains the fully polarized propagation matrix for the current path point. See spectral_propmat, defaults to self.spectral_propmat [INOUT]

  • spectral_propmat_jac (PropmatMatrix, optional) – Partial derivative of the spectral_propmat with regards to jac_targets. See spectral_propmat_jac, defaults to self.spectral_propmat_jac [INOUT]

  • select_species (SpeciesEnum, optional) – Species selection. See select_species, defaults to self.select_species [IN]

  • jac_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See jac_targets, defaults to self.jac_targets [IN]

  • freq_grid (AscendingGrid, optional) – A frequency grid. Unit: Hz. See freq_grid, defaults to self.freq_grid [IN]

  • atm_point (AtmPoint, optional) – An atmospheric point in ARTS. See atm_point, defaults to self.atm_point [IN]

  • abs_cia_data (ArrayOfCIARecord, optional) – HITRAN Collision-Induced Absorption (CIA) Data. See abs_cia_data, defaults to self.abs_cia_data [IN]

  • T_extrapolfac (Numeric, optional) – Temperature extrapolation factor (relative to grid spacing). \(\Delta T_e\) in text above. Defaults to 0.5 [IN]

  • ignore_errors (Index, optional) – Set to 1 to suppress runtime errors (and return NAN values instead). Defaults to 0 [IN]