cfdm.Domain.to_xarray

Domain.to_xarray(group=True)

Convert the Domain to an xarray dataset.

If the cf_xarray package (https://cf-xarray.readthedocs.io) is installed then the cf_xarray accessors that allow some interpretation of CF attributes will be present on xarray.DataArray and xarray.Dataset objects.

Note that ds = f.to_xarray() is identical to ds = cfdm.write(f, fmt='XARRAY'); and multiple domains may be written to the same xarray dataset with cfdm.write (e.g. ds = cfdm.write([f, g], fmt='XARRAY')). Also, cfdm.write allows a mixture of fields and domains to be written to the same xarray dataset.

An xarray dataset can be converted to one or more fields with f = cfdm.read(ds), or domains with f = cfdm.read(ds, domain=True).

Added in version (cfdm): 1.13.2.0

See also

cfdm.write, cfdm.read

Parameter:

group: bool, optional

If False then create a “flat” dataset, i.e. one with only the root group, regardless of any group structure specified by the netCDF interfaces of the domain and its components. If True (the default) then any sub-groups will be created and populated.

Returns:

xarray.Dataset or xarray.DataTree

The equivalent xarray dataset.

If there are no sub-groups of the root group, or if group is False, then an xarray.Dataset is returned.

If there are sub-groups of the root group and group is True, then an xarray.DataTree is returned.