joseki.profiles.mipas_2007

MIPAS atmosphere thermophysical profiles.

[Remedios et al. (2007)](bibliography.md#Remedios+2007) define a set of 5 “standard atmospheres” representing the atmosphere at different latitudes and seasons or times of day:

  • midlatitude day

  • midlatitude night

  • polar winter

  • polar summer

  • tropical

MIPAS standard atmospheres were intended to provide an updated set of pro- files for characteristic atmospheric states such as the [AFGL Atmospheric constituent profiles](bibliography.md#Anderson+1986).

Attributes

CFC_FORMULAE

INSTITUTION

K

REFERENCE

SOURCE

URL

URL_DATE

logger

Classes

Identifier

MIPAS atmosphere thermophysical profile identifier enumeration.

MIPASMidlatitudeDay

MIPAS midlatitude day reference atmosphere.

MIPASMidlatitudeNight

MIPAS Midlatitude night reference atmosphere.

MIPASPolarSummer

MIPAS Polar summer reference atmosphere.

MIPASPolarWinter

MIPAS Polar winter reference atmosphere.

MIPASTropical

MIPAS Tropical reference atmosphere.

Functions

get_dataset(identifier)

Read MIPAS reference atmosphere data files into an xarray.Dataset.

parse_content(lines)

Parse lines.

parse_units(s)

Parse units.

parse_values_line(s)

Parse a line with numeric values.

parse_var_line(s)

Parse a line with the declaration of a variable and its units.

parse_var_name(n)

Parse variable name.

read_file_content(identifier)

Read data file content.

to_chemical_formula(name)

Convert to chemical formula.

to_dataset(identifier[, z, method, conserve_column])

Helper for Profile.to_dataset method

translate_cfc(name)

Convert chlorofulorocarbon name to corresponding chemical formula.

Module Contents

class joseki.profiles.mipas_2007.Identifier(*args, **kwds)[source]

Bases: enum.Enum

MIPAS atmosphere thermophysical profile identifier enumeration.

MIDLATITUDE_DAY = 'midlatitude_day'
MIDLATITUDE_NIGHT = 'midlatitude_night'
POLAR_SUMMER = 'polar_summer'
POLAR_WINTER = 'polar_winter'
TROPICAL = 'tropical'
class joseki.profiles.mipas_2007.MIPASMidlatitudeDay[source]

Bases: joseki.profiles.core.Profile

MIPAS midlatitude day reference atmosphere.

to_dataset(z=None, interp_method=None, conserve_column=False, **kwargs)[source]

Return the profile as a dataset.

Parameters:

  • z (Optional[pint.Quantity]) – Altitude grid. If the profile can be evaluated at arbitrary altitudes, this parameter is passed to the evaluating method for that profile. If the profile is defined on a fixed altitude grid, this parameter is used to interpolate the profile on the specified altitude grid.

  • interp_method (Optional[Mapping[str, str]]) – Interpolation method for each variable. If None, the default interpolation method is used. Interpolation may be required if the profile is defined on a fixed altitude grid, and the altitude grid is not the same as the one used to define the profile. Interpolation may also not be required, e.g. if the profile is defined by analytical function(s) of the altitude variable.

  • conserve_column (bool) – If True, ensure that column densities are conserved during interpolation.

  • kwargs (Any) – Parameters passed to lower-level methods.

Returns:

Atmospheric profile.

Return type:

xarray.Dataset

class joseki.profiles.mipas_2007.MIPASMidlatitudeNight[source]

Bases: joseki.profiles.core.Profile

MIPAS Midlatitude night reference atmosphere.

to_dataset(z=None, interp_method=None, conserve_column=False, **kwargs)[source]

Return the profile as a dataset.

Parameters:

  • z (Optional[pint.Quantity]) – Altitude grid. If the profile can be evaluated at arbitrary altitudes, this parameter is passed to the evaluating method for that profile. If the profile is defined on a fixed altitude grid, this parameter is used to interpolate the profile on the specified altitude grid.

  • interp_method (Optional[Mapping[str, str]]) – Interpolation method for each variable. If None, the default interpolation method is used. Interpolation may be required if the profile is defined on a fixed altitude grid, and the altitude grid is not the same as the one used to define the profile. Interpolation may also not be required, e.g. if the profile is defined by analytical function(s) of the altitude variable.

  • conserve_column (bool) – If True, ensure that column densities are conserved during interpolation.

  • kwargs (Any) – Parameters passed to lower-level methods.

Returns:

Atmospheric profile.

Return type:

xarray.Dataset

class joseki.profiles.mipas_2007.MIPASPolarSummer[source]

Bases: joseki.profiles.core.Profile

MIPAS Polar summer reference atmosphere.

to_dataset(z=None, interp_method=None, conserve_column=False, **kwargs)[source]

Return the profile as a dataset.

Parameters:

  • z (Optional[pint.Quantity]) – Altitude grid. If the profile can be evaluated at arbitrary altitudes, this parameter is passed to the evaluating method for that profile. If the profile is defined on a fixed altitude grid, this parameter is used to interpolate the profile on the specified altitude grid.

  • interp_method (Optional[Mapping[str, str]]) – Interpolation method for each variable. If None, the default interpolation method is used. Interpolation may be required if the profile is defined on a fixed altitude grid, and the altitude grid is not the same as the one used to define the profile. Interpolation may also not be required, e.g. if the profile is defined by analytical function(s) of the altitude variable.

  • conserve_column (bool) – If True, ensure that column densities are conserved during interpolation.

  • kwargs (Any) – Parameters passed to lower-level methods.

Returns:

Atmospheric profile.

Return type:

xarray.Dataset

class joseki.profiles.mipas_2007.MIPASPolarWinter[source]

Bases: joseki.profiles.core.Profile

MIPAS Polar winter reference atmosphere.

to_dataset(z=None, interp_method=None, conserve_column=False, **kwargs)[source]

Return the profile as a dataset.

Parameters:

  • z (Optional[pint.Quantity]) – Altitude grid. If the profile can be evaluated at arbitrary altitudes, this parameter is passed to the evaluating method for that profile. If the profile is defined on a fixed altitude grid, this parameter is used to interpolate the profile on the specified altitude grid.

  • interp_method (Optional[Mapping[str, str]]) – Interpolation method for each variable. If None, the default interpolation method is used. Interpolation may be required if the profile is defined on a fixed altitude grid, and the altitude grid is not the same as the one used to define the profile. Interpolation may also not be required, e.g. if the profile is defined by analytical function(s) of the altitude variable.

  • conserve_column (bool) – If True, ensure that column densities are conserved during interpolation.

  • kwargs (Any) – Parameters passed to lower-level methods.

Returns:

Atmospheric profile.

Return type:

xarray.Dataset

class joseki.profiles.mipas_2007.MIPASTropical[source]

Bases: joseki.profiles.core.Profile

MIPAS Tropical reference atmosphere.

to_dataset(z=None, interp_method=None, conserve_column=False, **kwargs)[source]

Return the profile as a dataset.

Parameters:

  • z (Optional[pint.Quantity]) – Altitude grid. If the profile can be evaluated at arbitrary altitudes, this parameter is passed to the evaluating method for that profile. If the profile is defined on a fixed altitude grid, this parameter is used to interpolate the profile on the specified altitude grid.

  • interp_method (Optional[Mapping[str, str]]) – Interpolation method for each variable. If None, the default interpolation method is used. Interpolation may be required if the profile is defined on a fixed altitude grid, and the altitude grid is not the same as the one used to define the profile. Interpolation may also not be required, e.g. if the profile is defined by analytical function(s) of the altitude variable.

  • conserve_column (bool) – If True, ensure that column densities are conserved during interpolation.

  • kwargs (Any) – Parameters passed to lower-level methods.

Returns:

Atmospheric profile.

Return type:

xarray.Dataset

joseki.profiles.mipas_2007.get_dataset(identifier)[source]

Read MIPAS reference atmosphere data files into an xarray.Dataset.

Parameters:

identifier (Identifier) – Atmospheric profile identifier.

Returns:

Atmospheric profile.

Return type:

xarray.Dataset

joseki.profiles.mipas_2007.parse_content(lines)[source]

Parse lines.

Parameters:

lines (List[str])

Return type:

Dict[str, pint.Quantity]

joseki.profiles.mipas_2007.parse_units(s)[source]

Parse units.

Parameters:

s (str)

Return type:

str

joseki.profiles.mipas_2007.parse_values_line(s)[source]

Parse a line with numeric values.

Parameters:

s (str)

Return type:

List[str]

joseki.profiles.mipas_2007.parse_var_line(s)[source]

Parse a line with the declaration of a variable and its units.

Parameters:

s (str)

Return type:

Tuple[str, str]

joseki.profiles.mipas_2007.parse_var_name(n)[source]

Parse variable name.

Parameters:

n (str)

Return type:

str

joseki.profiles.mipas_2007.read_file_content(identifier)[source]

Read data file content.

Parameters:

identifier (Identifier) – Atmospheric profile identifier. See [Identifier](reference.md#src.joseki.profiles.mipas_2007.Identifier) for possible values.

Returns:

file content, URL, URL date.

Return type:

str

joseki.profiles.mipas_2007.to_chemical_formula(name)[source]

Convert to chemical formula.

Parameters:

name (str) – Molecule name.

Returns:

Molecule formula.

Return type:

str

Notes

If molecule name is unknown, returns name unchanged.

joseki.profiles.mipas_2007.to_dataset(identifier, z=None, method=None, conserve_column=False, **kwargs)[source]

Helper for Profile.to_dataset method

Parameters:
Return type:

xarray.Dataset

joseki.profiles.mipas_2007.translate_cfc(name)[source]

Convert chlorofulorocarbon name to corresponding chemical formula.

Parameters:

name (str) – Chlorofulorocarbon name.

Returns:

Chlorofulorocarbon chemical formula.

Raises:

ValueError – If the name does not match a known chlorofulorocarbon.

Return type:

str

joseki.profiles.mipas_2007.CFC_FORMULAE
joseki.profiles.mipas_2007.INSTITUTION = 'EOS, Space Research Centre, Leicester, U.K.'
joseki.profiles.mipas_2007.K
joseki.profiles.mipas_2007.REFERENCE = 'Remedios, John J. et al. “MIPAS reference atmospheres and comparisons to V4.61/V4.62 MIPAS...
joseki.profiles.mipas_2007.SOURCE = 'Combination of model and observational data'
joseki.profiles.mipas_2007.URL = 'https://eodg.atm.ox.ac.uk/RFM/atm/'
joseki.profiles.mipas_2007.URL_DATE = '2022-12-12'
joseki.profiles.mipas_2007.logger