optmat.gas.raman_response_validation

The gases’ Raman responses against measurements (TC-690).

Each function compares one kind of measurement with the responses of optmat.gas.raman_response and returns ResponseComparison records, which the manual page The Raman response tabulates (fused silica’s are in optmat.solid.raman_response_validation). Only published measurements are references, and none of them entered the parameters of the response it tests.

• gas_gains(): steady-state Stokes gains (H2, D2, CH4), from the imaginary part of the response’s transform at the line, so that the neighbouring lines and the anisotropic share count;

• rotational_dephasing(): the decay of the rotational revivals (O2).

Module Attributes

GAIN_MEASUREMENTS

The measured gains (TC-477, TC-478, as on the page Raman lines): the dataset, the gas, the line's J (None for an unresolved band), the pump wavelength (nm; None where the dataset's abscissa is the pump) and the density (amagat).

Functions

dataset(key)	Return a curated dataset.
gas_gains()	Return the measured Stokes gains against the responses'.
quiet(function, *args, **kwargs)	Call a function with the range warnings silenced (the validators' conditions).
rotational_dephasing()	Return the measured decay of the rotational revivals against the responses'.

Classes

ResponseComparison(material, reference, ...)

A measured quantity against a response's prediction.

optmat.gas.raman_response_validation.GAIN_MEASUREMENTS = (('ottusch_1988/gain_H2', 'H2', 1, 532.0, 60.0), ('bischel_1986b/gain_H2', 'H2', 1, None, 20.0), ('ottusch_1988/gain_D2', 'D2', 2, 532.0, 60.0), ('ottusch_1988/gain_CH4', 'CH4', None, 532.0, 115.0))

The measured gains (TC-477, TC-478, as on the page Raman lines): the dataset, the gas, the line’s J (None for an unresolved band), the pump wavelength (nm; None where the dataset’s abscissa is the pump) and the density (amagat). Bischel & Dyer’s are their high-density limit, evaluated at 20 amagat, where it holds to 1 % (their Eq. (8)).

class optmat.gas.raman_response_validation.ResponseComparison(material, reference, label, quantity, unit, expected, sigma, predicted, model='default')

Bases: object

A measured quantity against a response’s prediction.

Attributes:

materialstr

The gas, mixture or solid.

referencestr

The curated dataset (source/dataset) or formula.

labelstr

The condition compared (a line, a pump, a shift).

quantitystr

What is compared.

unitstr

The unit of expected and predicted.

expectedfloat

The measured (or source’s) value.

sigmafloat

Its stated standard uncertainty (NaN where none is stated).

predictedfloat

The response’s value.

modelstr

The response’s model.

expected: float

label: str

material: str

model: str = 'default'

predicted: float

quantity: str

property ratio: float

The prediction over the measurement.

Returns:

float

predicted / expected.

reference: str

sigma: float

unit: str

optmat.gas.raman_response_validation.dataset(key)

Return a curated dataset.

Parameters:

keystr

source/dataset.

Returns:

Dataset

The dataset.

optmat.gas.raman_response_validation.gas_gains()

Return the measured Stokes gains against the responses’.

Returns:

list of ResponseComparison

One per measured gain (cm/GW).

optmat.gas.raman_response_validation.quiet(function, *args, **kwargs)

Call a function with the range warnings silenced (the validators’ conditions).

Parameters:

functioncallable

The function.

*args, **kwargs

Its arguments.

Returns:

R

Its value.

optmat.gas.raman_response_validation.rotational_dephasing()

Return the measured decay of the rotational revivals against the responses’.

Returns:

list of ResponseComparison

Chen et al. 2007’s O2 at 5.1 atm (ps).