API

fixnc.create_variable(data, dimensions, hasunlimdim=False, datatype='float32', FillValue=None, attributes={})

Creates dictionary that can be added as a variable to the netCDF file.

Create dictionary that contains information necessary for creation of the netCDF variable.

Parameters:
  • data (array-like) – Numpy array, array-like object that contains the actual data values.
  • dimensions (tuple) – tuple with dimension names, like (‘time’, ‘lat’, ‘lon’). dimensions should exist in the source file, or should be added in the ncfile object.
  • hasunlimdim (bool) – True if variable have unlimited dimension, otherwise False. !!NOTE!! At present unlimited dimension in your new variable has to be the same size as in the original data (e.g. number of time steps). This should be changed.
  • datatype (datatype) – numpy datatype as a string, like “float32”.
  • FillValue (number, optional) – If your data should have one, otherwise None
  • attributes (OrderedDict) – Orderd dictionary with attributes and their values.
Returns:

Ordered dictionary that can be used to add data to netCDF file.
Return type:

OrderedDict
fixnc.dump_variable(var, filename)

Use pickle to dump OrderedDict to the file.

Parameters:
  • var (OrderedDict) – OrderedDict, supposedly produced by create_variable function.
  • filename (str) – name of the file.
Returns:

True is succes.
Return type:

bool
fixnc.load_variable(filename)

Use pickle load OrderedDict from the file to the variable.

Parameters:filename (str) – name of the file.
Returns:
Return type:OrderedDict
class fixnc.ncfile(ifile)

Main class of the fixnc.

This class is initiated with original netCDF file object created by Dataset from the netCDF4 package. The properties of the file are copied to the attributes of the class and cna be then saved together with data of the original file. The purpose is to be able to fix metadata in the netCDF file, like dimension names, attributes and so on, but to save the rest of the structure of the original file as much as possible.

Initial version of the class is based on the code from netCDF4 library https://github.com/Unidata/netcdf4-python/blob/master/netCDF4/utils.py

Parameters:ifile (Dataset) – Instance of the Dataset class from the netCDF4 library.
add_attr(var, attr, value)

Add attribute to the variable.

Parameters:
  • var (str) – Name of the variable.
  • attr (str) – Name of the new attribute.
  • value (str) – Value of the new attribute.
add_dim(name, size, isunlimited=False)

Add dimension.

Parameters:
  • name (str) – Name of the dimension.
  • size (int) – Size of the dimension.
  • isunlimited (bool) – Flag to indicate if the dimension is unlimited or not.
add_gattr(attr, value)

Add global attribute.

Parameters:
  • attr (str) – Name of the new global attribute.
  • value (str) – Value of the new global attribute.
add_var(varname, var)

Add variable.

Parameters:
  • varname (str) – Name of the new variable.
  • var (OrderedDict) – Should be OrderedDict, prepared with create_variable function.
change_attr(var, attrname, newvalue)

Change the value of the attribute in specified variable.

The name of the attribute stays the same.

Parameters:
  • var (str) – Variable, that should have an attribute with attrname.
  • attrname (str) – Name of the attribute.
  • newvalue (str) – New value of the attribute.
change_data(var, data)

Change data values in the existing variable.

Should be exactly the same shape as original data. Data should be numpy array, or array-like object.

Parameters:
  • var (str) – Name of the variable.
  • data (array-like) – Array with new data values of the variable. The size should be the same as for the original data.
change_dtype(var, dtype)

Change data type values in the existing variable.

Should be exactly the same shape as original data. Data should be numpy array, or array-like object.

Parameters:
  • var (str) – Name of the variable.
  • dtype (numpy dtype, e.g. npumpy.dtype('float16')) – Array with new data values of the variable. The size should be the same as for the original data.
change_gattr(attrname, newvalue)

Change the value of existing global attribute.

The name of the global attribute stays the same.

Parameters:
  • attrname (str) – Name of the global attribute.
  • newvalue (str) – New value of the global attribute.
del_attr(var, attr)

Delete attribute from the variable.

Parameters:
  • var (str) – Name of the variable.
  • attr (str) – Name of the attribute to delete.
del_var(var)

Delete variable.

Parameters:var (str) – Name of the variable.
rename_attr(var, oldname, newname)

Rename existing attribute of the variable.

The value of the attribute stays the same.

Parameters:
  • var (str) – Variable, that should have an attribute with oldname.
  • oldname (str) – Old name of the attribute.
  • newname (str) – New name of the attribute.
rename_dim(oldname, newname, renameall=True)

Rename existing dimension.

Parameters:
  • oldname (str) – Name of existing dimension.
  • newname (str) – New name for the dimension.
  • renameall (bool) – If renameall is True, rename corresponding dimensions in the variables as well.
rename_dim_invar(var, oldname, newname)

Rename dimension in the variable.

Parameters:
  • var (str) – Variable, that should have dimension with oldname.
  • oldname (str) – Old name of the dimension.
  • newname (str) – New name of the dimension.
rename_gattr(oldname, newname)

Rename existing global attribute.

The value of the attribute stays the same.

Parameters:
  • oldname (str) – Old name of the global attribute.
  • newname (str) – New name of the global attribute.
rename_var(oldname, newname)

Rename existing variable.

Attributes, dimensions and data stays the same.

Parameters:
  • oldname (str) – Old name of the variable.
  • newname (str) – New name of the variable.
reorder_dims(neworder)

Reorder dimensions.

Parameters:neworder (list) – List with dimension names, positioned in the desired order.
reorder_vars(neworder)

Reorder variables.

Parameters:neworder (list) – List with name of the variables, positioned in the desired order.
save(fname)

Save the file to the disk.

Create netCDF file from the ncfile object.

Parameters:fname (str) – File name.
fixnc.reorder(odict, neworder)

Reorder values in the OrderedDict

Reorder Ordered Dictionary according to the list of keys provided in neworder.

Parameters:
  • odict (OrderedDict) –
  • neworder (list) – list with keys from the odict, positioned in the new order.
Returns:

Ordered dictionary with key-value pairs reordered according to the neworder.
Return type:

OrderedDict