propmat_clearskyAddFromLookup

Extract gas absorption coefficients from lookup table.

This extracts the absorption coefficient for all species from the lookup table, and adds them to the propagation matrix. Extraction is for one specific atmospheric condition, i.e., a set of pressure, temperature, and VMR values.

Some special species are ignored, for example Zeeman species and free electrons, since their absorption properties are not simple scalars and cannot be handled by the lookup table.

The interpolation order in T and H2O is given by abs_t_interp_order and abs_nls_interp_order, respectively.

Extraction is done for the frequencies in f_grid. Frequency interpolation is controlled by abs_f_interp_order. If this is zero, then f_grid must either be the same as the internal frequency grid of the lookup table (for efficiency reasons, only the first and last element of f_grid are checked), or must have only a single element. If abs_f_interp_order is above zero, then frequency is interpolated along with the other interpolation dimensions. This is useful for calculations with Doppler shift.

For Doppler calculations, you should generate the table with a somewhat larger frequency grid than the calculation itself has, since the Doppler shift will push the frequency grid out of the table range on one side.

Some extrapolation is allowed. For pressure and frequency interpolation the standard extrapolation factor of 0.5 is applied. The factor is the default for temperature and VMR interpolation, but the extrapolation limit can here be adjusted by the extpolfac argument.

Author(s): Stefan Buehler, Richard Larsson

Parameters:

propmat_clearsky (PropagationMatrix, optional) – This contains the absorption coefficients for one point in the atmosphere. See propmat_clearsky, defaults to self.propmat_clearsky [INOUT]
dpropmat_clearsky_dx (ArrayOfPropagationMatrix, optional) – Partial derivative of absorption coefficients. See dpropmat_clearsky_dx, defaults to self.dpropmat_clearsky_dx [INOUT]
abs_lookup (GasAbsLookup, optional) – An absorption lookup table. See abs_lookup, defaults to self.abs_lookup [IN]
abs_lookup_is_adapted (Index, optional) – Flag to indicate whether abs_lookupAdapt() has already been. See abs_lookup_is_adapted, defaults to self.abs_lookup_is_adapted [IN]
abs_p_interp_order (Index, optional) – The interpolation order to use when interpolating absorption. See abs_p_interp_order, defaults to self.abs_p_interp_order [IN]
abs_t_interp_order (Index, optional) – The interpolation order to use when interpolating absorption between. See abs_t_interp_order, defaults to self.abs_t_interp_order [IN]
abs_nls_interp_order (Index, optional) – The interpolation order to use when interpolating absorption between. See abs_nls_interp_order, defaults to self.abs_nls_interp_order [IN]
abs_f_interp_order (Index, optional) – Frequency interpolation order for absorption lookup table. See abs_f_interp_order, defaults to self.abs_f_interp_order [IN]
f_grid (Vector, optional) – The frequency grid for monochromatic pencil beam calculations. See f_grid, defaults to self.f_grid [IN]
rtp_pressure (Numeric, optional) – Pressure at a radiative transfer point. See rtp_pressure, defaults to self.rtp_pressure [IN]
rtp_temperature (Numeric, optional) – Temperature at a radiative transfer point. See rtp_temperature, defaults to self.rtp_temperature [IN]
rtp_vmr (Vector, optional) – Absorption species abundances for radiative transfer calculations. See rtp_vmr, defaults to self.rtp_vmr [IN]
jacobian_quantities (ArrayOfRetrievalQuantity, optional) – The retrieval quantities in the Jacobian matrix. See jacobian_quantities, defaults to self.jacobian_quantities [IN]
abs_species (ArrayOfArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See abs_species, defaults to self.abs_species [IN]
select_abs_species (ArrayOfSpeciesTag, optional) – A select species tag group from abs_species. See select_abs_species, defaults to self.select_abs_species [IN]
extpolfac (Numeric, optional) – Extrapolation factor (for temperature and VMR grid edges). Defaults to 0.5 [IN]
no_negatives (Index, optional) – Boolean. If it is true negative values due to interpolation are set to zero. Defaults to 1 [IN]
verbosity (Verbosity) – ARTS verbosity. See verbosity, defaults to self.verbosity [IN]