cf.Field.insert_ref

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

Insert a coordinate reference object into the domain in place.

See also

insert_axis, insert_aux, insert_measure, insert_data, insert_dim

Parameters:
item : cf.CoordinateReference

The new coordinate reference object.

key : str, optional

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

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 coordinate reference object of domain which has the same identifier. By default an existing coordinate reference object with the same identifier is replaced with item.
Returns:
out :

The domain identifier for the item.
Examples: 
>>>