cf.Field.coordinate_reference_domain_axes

Field.coordinate_reference_domain_axes(identity=None)[source]

Return the domain axes that apply to a coordinate reference construct.

Parameters
identity: optional

Select the coordinate reference construct by one of:

  • The identity of a coordinate reference construct.

    A construct has a number of string-valued identities

defined by its identities method, and is selected if any of them match the identity parameter. identity may be a string that equals one of a construct’s identities; or a re.Pattern object that matches one of a construct’s identities via re.search.

Note that in the output of a dump method or print call, a metadata construct is always described by one of its identities, and so this description may always be used as an identity value.

  • The key of a coordinate reference construct

  • None. This is the default, which selects the coordinate reference construct when there is only one of them.

Parameter example:

identity='standard_name:atmosphere_hybrid_height_coordinate'

Parameter example:

identity='grid_mapping_name:rotated_latitude_longitude'

Parameter example:

identity='transverse_mercator'

Parameter example:

identity='coordinatereference1'

Parameter example:

identity='key%coordinatereference1'

Parameter example:

identity='ncvar%lat_lon'

Parameter example:

identity=cf.eq('rotated_pole')'

Parameter example:

identity=re.compile('^rotated')

Returns
set

The identifiers of the domain axis constructs that span the data of all coordinate and domain ancillary constructs used by the selected coordinate reference construct.

Examples

>>> f.coordinate_reference_domain_axes('coordinatereference0')
{'domainaxis0', 'domainaxis1', 'domainaxis2'}
>>> f.coordinate_reference_domain_axes(
...     'atmosphere_hybrid_height_coordinate')
{'domainaxis0', 'domainaxis1', 'domainaxis2'}