cfdm.Field.nc_set_geometry_variable_groups

Field.nc_set_geometry_variable_groups(groups)[source]

Set the netCDF geometry variable 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 setting the group structure is to set the netCDF variable name, with nc_set_geometry_variable, with the group structure delimited by / characters.

New in version (cfdm): 1.8.6

See also

nc_clear_geometry_variable_groups, nc_geometry_variable_groups

Parameters
groups: sequence of str

The new group structure.

Returns
tuple of str

The group structure prior to being reset.

Examples

>>> f.nc_set_geometry_variable('geometry1')
>>> f.nc_geometry_variable_groups()
()
>>> f.nc_set_geometry_variable_groups(['forecast', 'model'])
>>> f.nc_geometry_variable_groups()
('forecast', 'model')
>>> f.nc_get_geometry_variable()
'/forecast/model/geometry1'
>>> f.nc_clear_geometry_variable_groups()
('forecast', 'model')
>>> f.nc_get_geometry_variable()
'geometry1'

>>> f.nc_set_geometry_variable('/forecast/model/geometry1')
>>> f.nc_geometry__variablegroups()
('forecast', 'model')
>>> f.nc_del_geometry_variable('/forecast/model/geometry1')
'/forecast/model/geometry1'
>>> f.nc_geometry_variable_groups()
()