cf.Field.field_ancillaries

Field.field_ancillaries(*identities, **filter_kwargs)[source]

Return field ancillary constructs.

f.field_ancillaries(*identities, **filter_kwargs) is equivalent to f.constructs.filter(filter_by_type=["field_ancillary"], filter_by_identity=identities, **filter_kwargs).

New in version (cfdm): 1.7.0

See also

constructs

Parameters
identities: optional

Select field ancillary constructs that have an identity, defined by their identities methods, that matches any of the given values.

A value may be any object that can match via the == operator, or a re.Pattern object that matches via its search method.

Note that in the output of a dump method or print 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.

Examples:

>>> print(f.field_ancillaries())
Constructs:
{}

>>> print(f.field_ancillaries())
Constructs:
{'fieldancillary0': <CF FieldAncillary: air_temperature standard_error(10, 9) K>}

>>> print(f.field_ancillaries('specific_humuidity standard_error'))
Constructs:
{'fieldancillary0': <CF FieldAncillary: specific_humidity standard_error(10, 9) K>}