cf.Field.insert_measure

Field.insert_measure(item, key=None, axes=None, copy=True, replace=True)[source]

Insert a cell measure object into the field.

Parameters:
item: cf.CellMeasure

The new cell measure object.

key: str, optional

The identifier for the item. By default a new, unique identifier will be generated.

axes: sequence of str, optional

The ordered list of axes for the item. Each axis is given by its identifier. By default the axes are assumed to be 'dim0' up to 'dimM-1', where M-1 is the number of axes spanned by the item.

copy: bool, optional

If False then the item is not copied before insertion. By default it is copied.

replace: bool, optional

If False then do not replace an existing cell measure object of domain which has the same identifier. By default an existing cell measure object with the same identifier is replaced with item.

Returns:
out:

The identifier for the item.

Examples:
>>>