cfdm.Domain.coordinates¶
-
Domain.
coordinates
(*identities, **filter_kwargs)[source]¶ Return dimension and auxiliary coordinate constructs.
Note that
f.coordinates(*identities, **filter_kwargs)
is equivalent tof.constructs.filter(filter_by_type=["dimension_coordinate", "auxiliary_coordinate"], filter_by_identity=identities, **filter_kwargs)
.. versionadded:: (cfdm) 1.7.0
- . seealso::
auxiliary_coordinates
,constructs
,
- Parameters
- identities: optional
Select dimension and auxiliary coordinate constructs that have an identity, defined by their
identities
methods, that matches any of the given values.If no identities are provided then all dimension and auxiliary coordinate constructs are selected.
A value may be any object that can match via the
==
operator, or are.Pattern
object that matches via itssearch
method.Note that in the output of a
dump
method orprint
call, a construct is always described by an identity that will select it.- filter_kwargs: optional
Keyword arguments as accepted by
Constructs.filter
that define additional construct selection criteria. Also to configure the returned value.New in version (cfdm): 1.8.9.0
- Returns
The selected constructs in a new
Constructs
object, unless modified by any filter_kwargs parameters. The returned object will contain no constructs if none were selected.
Examples
>> f.coordinates() Constructs: }
>> f.coordinates() Constructs: ‘auxiliarycoordinate0’: <AuxiliaryCoordinate: latitude(10, 9) degrees_N>, ‘auxiliarycoordinate1’: <AuxiliaryCoordinate: longitude(9, 10) degrees_E>, ‘auxiliarycoordinate2’: <AuxiliaryCoordinate: long_name=Grid latitude name(10) >, ‘dimensioncoordinate0’: <DimensionCoordinate: atmosphere_hybrid_height_coordinate(1) >, ‘dimensioncoordinate1’: <DimensionCoordinate: grid_latitude(10) degrees>, ‘dimensioncoordinate2’: <DimensionCoordinate: grid_longitude(9) degrees>, ‘dimensioncoordinate3’: <DimensionCoordinate: time(1) days since 2018-12-01 >}
- . seealso::