Skip to content

cmip_branded_variable_mapper.mapper#

Mapper from CMIP information to branded variables

In the absence of other references, this is currently our source of truth for this mapping. (https://docs.google.com/document/d/149Tkz37whSQMFVbEYZMYbdqIctHbufpbJ_VMlzHyKuY/edit?tab=t.0).

Functions:

Name Description
map_to_cmip_branded_variable

Map CMIP variable information into a branded variable

map_to_cmip_branded_variable #

map_to_cmip_branded_variable(
    variable_name: str,
    cell_methods: str | None,
    dimensions: tuple[str, ...],
) -> str

Map CMIP variable information into a branded variable

Parameters:

Name Type Description Default
variable_name str

Variable name

 required
cell_methods str | None

Cell methods associated with the variable

 required
dimensions tuple[str, ...]

Dimensions of the variable

 required

Returns:

Type Description
str

Branded variable

Examples:

>>> map_to_cmip_branded_variable(
...     variable_name="tas",
...     cell_methods="area: time: mean",
...     dimensions=("longitude", "latitude", "time", "height2m"),
... )
'tas_tavg-h2m-hxy-u'
>>>
>>> map_to_cmip_branded_variable(
...     variable_name="hfds",
...     cell_methods="area: mean where sea time: mean",
...     dimensions=("longitude", "latitude", "time"),
... )
'hfds_tavg-u-hxy-sea'
Source code in src/cmip_branded_variable_mapper/mapper.py 
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
def map_to_cmip_branded_variable(
    variable_name: str, cell_methods: str | None, dimensions: tuple[str, ...]
) -> str:
    """
    Map CMIP variable information into a branded variable

    Parameters
    ----------
    variable_name
        Variable name

    cell_methods
        Cell methods associated with the variable

    dimensions
        Dimensions of the variable

    Returns
    -------
    :
        Branded variable

    Examples
    --------
    >>> map_to_cmip_branded_variable(
    ...     variable_name="tas",
    ...     cell_methods="area: time: mean",
    ...     dimensions=("longitude", "latitude", "time", "height2m"),
    ... )
    'tas_tavg-h2m-hxy-u'
    >>>
    >>> map_to_cmip_branded_variable(
    ...     variable_name="hfds",
    ...     cell_methods="area: mean where sea time: mean",
    ...     dimensions=("longitude", "latitude", "time"),
    ... )
    'hfds_tavg-u-hxy-sea'
    """
    temporal_label = get_temporal_label(
        cell_methods=cell_methods, dimensions=dimensions
    )
    vertical_label = get_vertical_label(dimensions=dimensions)
    horizontal_label = get_horizontal_label(dimensions=dimensions)
    area_label = get_area_label(cell_methods=cell_methods)

    suffix = "-".join([temporal_label, vertical_label, horizontal_label, area_label])

    return "_".join([variable_name, suffix])