# cfdm.CellMethod¶

class cfdm.CellMethod(axes=None, method=None, qualifiers=None, source=None, copy=True)[source]

Bases: cfdm.mixin.container.Container, cfdm.core.cellmethod.CellMethod

A cell method construct of the CF data model.

One or more cell method constructs describe how the cell values of the field construct represent the variation of the physical quantity within its cells, i.e. the structure of the data at a higher resolution.

A single cell method construct consists of a set of axes, a “method” property which describes how a value of the field construct’s data array describes the variation of the quantity within a cell over those axes (e.g. a value might represent the cell area average), and descriptive qualifiers serving to indicate more precisely how the method was applied (e.g. recording the spacing of the original data, or the fact that the method was applied only over El Nino years).

New in version (cfdm): 1.7.0

Initialisation

Parameters
axes: (sequence of) str, optional

Set the axes of the cell method construct, specified either by the construct identifiers of domain axis constructs, standard names, or the special string 'area'.

The axes may also be set after initialisation with the set_axes method.

Parameter example:

axes='domainaxis0'

Parameter example:

axes=['domainaxis0']

Parameter example:

axes=('domainaxis0', 'domainaxis1')

Parameter example:

axes='area'

Parameter example:

axes=['domainaxis2', 'time']

method: str, optional

Set the axes of the cell method construct. Either one or more domain axis construct identifiers or standard names.

The method may also be set after initialisation with the set_method method.

Parameter example:

method='mean'

qualifiers: dict, optional

Set descriptive qualifiers. The dictionary keys are qualifier names, with corresponding values.

Qualifiers may also be set after initialisation with the qualifiers and set_qualifier methods.

Parameter example:

qualifiers={'comment': 'sampled instantaneously'}

Parameter example:

qualifiers={'where': 'sea', ''over': 'ice'}

source: optional

Convert source, which can be any type of object, to a CellMethod instance.

All other parameters, apart from copy, are ignored and their values are instead inferred from source by assuming that it has the CellMethod API. Any parameters that can not be retrieved from source in this way are assumed to have their default value.

Note that if x is also a CellMethod instance then cfdm.CellMethod(source=x) is equivalent to x.copy().

copy: bool, optional

If True (the default) then deep copy the input parameters prior to initialisation. By default the parameters are not deep copied.

## Inspection¶

Methods

 dump A full description of the cell method construct. identity Return the canonical identity for the cell method construct. identities Return all possible identities.

Attributes

 construct_type Return a description of the construct type.

## Properties¶

Methods

 del_axes Remove the axes of the cell method. get_axes Return the axes of the cell method. has_axes Whether the axes of the cell method have been set. set_axes Set the axes of the cell method. del_method Remove the method of the cell method. get_method Return the method of the cell method. has_method Whether the method of the cell method has been set. set_method Set the method of the cell method. del_qualifier Remove a qualifier of the cell method. get_qualifier Return a qualifier of the cell method. has_qualifier Whether a qualifier of the cell method has been set. set_qualifier Set a qualifier of the cell method. qualifiers Return all qualifiers of the cell method.

## Miscellaneous¶

Methods

 copy Return a deep copy. creation_commands Returns the commands to create the cell method construct. equals Whether two cell method constructs are the same. sorted Return a new cell method construct with sorted axes.

## Special¶

Methods

 __deepcopy__ Called by the copy.deepcopy function. __repr__ Called by the repr built-in function. __str__ Called by the str built-in function.

## Docstring substitutions¶

Methods

 _docstring_special_substitutions Return the special docstring substitutions. _docstring_substitutions Returns the substitutions that apply to methods of the class. _docstring_package_depth Returns the class {{package}} substitutions package depth. _docstring_method_exclusions Returns method names excluded in the class substitutions.