python/numpy interface to the netCDF C library.
For the latest updates, see the Changelog.
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
with 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.
3/8/2015: Version 1.1.6 released. Minor bug fixes for regressions introduced in 1.1.5, including incorrect handling of UTC offsets in units string by date2num/num2date. Datetime instances returned by num2date are now time-zone naive, so python-dateutil is no longer required.
3/1/2015: Version 1.1.5 released. Significant improvements to netcdftime and
num2date/date2num - accuracy is now between a millisecond and a microsecond depending
on the time interval and calendar used. use_ncconfig=True
is now the default
in setup.py, so the utility nc-config is used to find the library and
include file paths.
-
clone github repository, or get source tarball (or Windows binary installers) from PyPI.
-
make sure numpy and (required) and Cython (recommended) are installed and you have python 2.5 or newer.
-
make sure HDF5 and netcdf-4 are installed, and the nc-config utility is in your Unix PATH. If setup.cfg does not exist, copy setup.cfg.template to setup.cfg, and make sure the line with
use_ncconfig=True
is un-commented. -
run
python setup.py build
, thenpython setup.py install
(with sudo if necessary). -
To run all the tests, execute
cd test; python run_all.py
.
See the online docs for more details.
Sample ipython notebooks available in the examples directory on reading and writing netcdf data with python.