This class is a basic ancestor to all classes that represent netCDF objects, specifically groups, dimensions, variables and the user-defined types in a netCDF file. More useful classes use this class as ancestor.
The fields in this class are common among all netCDF objects. In addition, this class manages the attributes for its descendent classes.
idNumeric identifier of the netCDF object.
nameThe name of the netCDF object.
attributesdata.frame with the attributes of the netCDF object.
new()Create a new netCDF object. This class should not be instantiated directly, create descendant objects instead.
NCObject$new(id, name)idNumeric identifier of the netCDF object.
nameCharacter string with the name of the netCDF object.
print_attributes()This function prints the attributes of the netCDF object to the console. Through object linkages, this also applies to the CF data variables and axes, which each link to a netCDF object.
NCObject$print_attributes(width = 50L)widthThe maximum width of each column in the data.frame when
printed to the console.
attribute()This method returns an attribute of a netCDF object.
NCObject$attribute(att, field = "value")attAttribute name whose value to return.
fieldThe field of the attribute to return values from. This must be "value" (default) or "type".
If the field argument is "type", a character string. If field
is "value", a single value of the type of the attribute, or a vector
when the attribute has multiple values. If no attribute is named with a
value of argument att NA is returned.
set_attribute()Add an attribute. If an attribute name already exists, it
will be overwritten.
NCObject$set_attribute(name, type, value)nameThe name of the attribute. The name must begin with a letter and be composed of letters, digits, and underscores, with a maximum length of 255 characters. UTF-8 characters are not supported in attribute names.
typeThe type of the attribute, as a string value of a netCDF data type.
valueThe value of the attribute. This can be of any supported type, including a vector or list of values. Matrices, arrays and like compound data structures should be stored as a data variable, not as an attribute and they are thus not allowed. In general, an attribute should be a character value, a numeric value, a logical value, or a short vector or list of any of these. Values passed in a list will be coerced to their common mode.
Self, invisibly.
append_attribute()Append the text value of an attribute. If an attribute
name already exists, the value will be appended to the existing
value of the attribute. If the attribute name does not exist it will
be created. The attribute must be of "NC_CHAR" or "NC_STRING" type; in
the latter case having only a single string value.
NCObject$append_attribute(name, value, sep = "; ", prepend = FALSE)nameThe name of the attribute. The name must begin with a letter and be composed of letters, digits, and underscores, with a maximum length of 255 characters. UTF-8 characters are not supported in attribute names.
valueThe character value of the attribute to append. This must be a character string.
sepThe separator to use. Default is "; ".
prependLogical to flag if the supplied value should be placed
before the existing value. Default is FALSE.
Self, invisibly.
delete_attribute()Delete an attribute. If an attribute name is not present
this method simply returns.
NCObject$delete_attribute(name)nameThe name of the attribute to delete.
Self, invisibly.
write_attributes()Write the attributes of this object to a netCDF file.
NCObject$write_attributes(nc, nm)ncThe handle to the netCDF file opened for writing.
nmThe NC variable name or "NC_GLOBAL" to write the attributes to.
Self, invisibly.
clone()The objects of this class are cloneable with this method.
NCObject$clone(deep = FALSE)deepWhether to make a deep clone.