For the latest updates, see the Changelog.
1/8/2017: Version 1.2.7 released. Python 3.6 compatibility, and fix for vector missing_values.
12/10/2016: Version 1.2.6 released. Bug fixes for Enum data type, and _FillValue/missing_value usage when data is stored in non-native endian format. Add get_variables_by_attributes to MFDataset. Support for python 2.6 removed.
4/15/2016: Version 1.2.4 released. Bugs in handling of variables with specified non-native "endian-ness" (byte-order) fixed (issue #554). Build instructions updated and warning issued to deal with potential backwards incompatibility introduced when using HDF5 1.10.x (see Unidata/netcdf-c/issue#250).
3/10/2016: Version 1.2.3 released. Various bug fixes.
All text attributes in
NETCDF4 formatted files are now written as type
NC_CHAR, unless they contain unicode characters that
cannot be encoded in ascii, in which case they are written as
all unicode strings were written as
NC_STRING. This change preserves compatibility
with clients, like Matlab, that can't deal with
setncattr_string method was added to force attributes to be written as
1/1/2016: Version 1.2.2 released. Mostly bugfixes, but with two new features.
support for the new
NETCDF3_64BIT_DATAformat introduced in netcdf-c 4.4.0. Similar to
NETCDF3_64BIT_OFFSET), but includes 64 bit dimension sizes (> 2 billion), plus unsigned and 64 bit integer data types. Uses the classic (netcdf-3) data model, and does not use HDF5 as the underlying storage format.
Dimension objects now have a
sizeattribute, which is the current length of the dimension (same as invoking
lenon the Dimension instance).
The minimum required python version has now been increased from 2.5 to 2.6.
10/15/2015: Version 1.2.1 released. Adds the ability to slice Variables with unsorted integer sequences, and integer sequences with duplicates.
9/23/2015: Version 1.2.0 released. New features:
Groupmethod for retrieving variables that have matching attributes.
Support for Enum data types.
7/28/2015: Version 1.1.9 bugfix release.
5/14/2015: Version 1.1.8 released. Unix-like paths can now be used in
v = nc.createVariable('/path/to/var1', ('xdim', 'ydim'), float)
will create a variable named 'var1', while also creating the groups 'path' and 'path/to' if they do not already exist.
g = nc.createGroup('/path/to')
now acts like
mkdir -p in unix, creating groups 'path' and '/path/to',
if they don't already exist. Users who relied on
failing when the group already exists will have to modify their code, since
nc.createGroup will now return the existing group instance.
Dataset.__getitem__ was also added.
now returns a group instance, and
nc['/path/to/var1'] now returns a variable instance.
3/19/2015: Version 1.1.7 released. Global Interpreter Lock (GIL) now released when extension
module calls C library for read operations. This speeds up concurrent reads when using threads.
Users who wish to use netcdf4-python inside threads should read http://www.hdfgroup.org/hdf5-quest.html#gconc
regarding thread-safety in the HDF5 C library. Fixes to
setup.py now ensure that
pip install netCDF4
export USE_NCCONFIG=0 will use environment variables to find paths to libraries and include files,
instead of relying exclusively on the nc-config utility.
Make sure HDF5 and netcdf-4 are installed, and the
nc-configutility is in your Unix PATH. If
setup.cfgdoes not exist, copy
setup.cfg, and make sure the line with
python setup.py build, then
python setup.py install(with
To run all the tests, execute
cd test && python run_all.py.
See the online docs for more details.