cfdm.core.DomainAncillary


class cfdm.core.DomainAncillary(properties=None, data=None, bounds=None, geometry=None, interior_ring=None, source=None, copy=True, _use_data=True)[source]

Bases: cfdm.core.abstract.propertiesdatabounds.PropertiesDataBounds

A domain ancillary construct of the CF data model.

A domain ancillary construct provides information which is needed for computing the location of cells in an alternative coordinate system. It is referenced by a term of a coordinate conversion formula of a coordinate reference construct. It contains a data array which depends on zero or more of the domain axes.

It also contains an optional array of cell bounds, stored in a Bounds object, recording the extents of each cell (only applicable if the array contains coordinate data), and properties to describe the data.

An array of cell bounds spans the same domain axes as the data array, with the addition of an extra dimension whose size is that of the number of vertices of each cell.

New in version 1.7.0.

Initialization

Parameters:
properties: dict, optional

Set descriptive properties. The dictionary keys are property names, with corresponding values. Ignored if the source parameter is set.

Parameter example:

properties={'standard_name': 'longitude'}

Properties may also be set after initialisation with the set_properties and set_property methods.

data: Data, optional

Set the data array. Ignored if the source parameter is set.

The data array may also be set after initialisation with the set_data method.

bounds: Bounds, optional

Set the bounds array. Ignored if the source parameter is set.

The bounds array may also be set after initialisation with the set_bounds method.

geometry: str, optional

Set the geometry type. Ignored if the source parameter is set.

Parameter example:

geometry='polygon'

The geometry type may also be set after initialisation with the set_geometry method.

interior_ring: InteriorRing, optional

Set the interior ring variable. Ignored if the source parameter is set.

The interior ring variable may also be set after initialisation with the set_interior_ring method.

source: optional

Initialize the properties, geometry type, data, bounds and interior ring from those of source.

copy: bool, optional

If False then do not deep copy input parameters prior to initialization. By default arguments are deep copied.

Inspection

Attributes

construct_type Return a description of the construct type.

Properties

Methods

del_property Remove a property.
get_property Return a property.
has_property Whether a property has been set.
set_property Set a property.
properties Return all properties.
clear_properties Remove all properties.
set_properties Set properties.

Data

Methods

del_data Remove the data.
get_data Return the data.o
has_data Whether a data has been set.
set_data Set the data.

Attributes

data Return the data.

Bounds

Methods

del_bounds Remove the bounds.
get_bounds Return the bounds.
has_bounds Whether or not there are bounds.
set_bounds Set the bounds.

Attributes

bounds Return the bounds.

Miscellaneous

Methods

copy Return a deep copy.

Special

Methods

__deepcopy__ Called by the copy.deepcopy function.