How to install nctoolkit¶
nctoolkit is available from the Python Packaging Index. To install nctoolkit using pip:
$ pip install numpy $ pip install nctoolkit
If you already have numpy installed, ignore the first line. This is only included as it will make installing some dependencies smoother. nctoolkit partly relies on cartopy for plotting. This has some additional dependencies, so you may need to follow their guide here to ensure cartopy is installed fully. If you install nctoolkit using conda, you will not need to worry about that.
If you install nctoolkit from pypi, you will need to install the system dependencies listed below.
nctoolkit can also be installed using conda, as follows:
$ conda install -c conda-forge nctoolkit
Note that recent releases are not available for Python 3.8 on macOS on conda. This issue is being investigated at the minute, and will hopefully be resolved shortly. In the meantime, if you are using macOS and Python 3.8, it is best to install using pip.
At present this can be slow due to the time taken to resolve dependency versions. If you run into problems just use pip.
To install the development version from GitHub:
$ pip install git+https://github.com/r4ecology/nctoolkit.git
CDO update issue¶
The latest version of CDO is incompatible with nctoolkit at present, due to the switch to C++14 in CDO. This will be rectified in an upcoming version of nctoolkit. For now, if you have version 2.0.0 of CDO installed, you should downgrade it. If you are using conda, just do this:
$ conda install -c conda-forge cdo=1.9.10
$ conda install -c conda-forge cdo $ conda install -c conda-forge nco
CDO is necessary for the package to work. NCO is an optional dependency and does not have to be installed.
If you want to install CDO from source, you can use one of the bash scripts available here.