cfdm.Index.nc_clear_dimension_groups

Index.nc_clear_dimension_groups()[source]

Remove the netCDF dimension group hierarchy.

The group hierarchy is defined by the netCDF name. Groups are delimited by / (slash) characters in the netCDF name. The groups are returned, in hierarchical order, as a sequence of strings. If the name is not set, or contains no / characters then an empty sequence is returned, signifying the root group.

An alternative technique for removing the group structure is to set the netCDF dimension name, with nc_set_dimension, with no / characters.

New in version (cfdm): 1.8.6

Returns
tuple of str

The removed group structure.

Examples

>>> f.nc_set_dimension('time')
>>> f.nc_dimension_groups()
()
>>> f.nc_set_dimension_groups(['forecast', 'model'])
>>> f.nc_dimension_groups()
('forecast', 'model')
>>> f.nc_get_dimension()
'/forecast/model/time'
>>> f.nc_clear_dimension_groups()
('forecast', 'model')
>>> f.nc_get_dimension()
'time'
>>> f.nc_set_dimension('/forecast/model/time')
>>> f.nc_dimension_groups()
('forecast', 'model')
>>> f.nc_del_dimension('/forecast/model/time')
'/forecast/model/time'
>>> f.nc_dimension_groups()
()