cf.Domain.insert_ref

Domain.insert_ref(ref, key=None, copy=True, replace=False)

Insert a coordinate reference object into the domain in place.

Parameters:

ref : cf.CoordinateReference

The new coordinate reference object.

key : str, optional

The identifier for the new coordinate reference object. By default a unique identifier will be generated.

copy : bool, optional

If False then the coordinate reference object is not copied before insertion. By default it is copied.

replace : bool, optional

If True then replace an existing coordinate reference object with the same identifier. By default an exception is raised if there is an existing coordinate reference object with the same identifier.

Returns:

out : str

The internal identifier of the new coordinate reference object.

Examples:

>>>