Installing

Pip install

To install CliMetLab, just run the following command:

pip install climetlab

The CliMetLab pip package has been tested successfully with the latest versions of its dependencies (build logs).

Conda install

No conda package has been created yet. pip install climetlab can be used in a conda environment.

Note

Mixing pip and conda could create some dependencies issues, we recommend installing as many dependencies as possible with conda, then install CliMetLab with pip, as recommended by the anaconda team.

Troubleshooting

Python 3.8 or above is required

CliMetLab requires Python 3.8 or above (mainly due the dependency numpy). Depending on your installation, you may need to substitute pip to pip3 in the examples below. See the build logs to know on which version of Python CliMetLab is automatically tested.

No matching distribution found for …

If the installation fails with the following error:

Collecting ecmwflibs>=x.x.x (from climetlab)
  Could not find a version that satisfies the requirement ecmwflibs>=0.0.90 (from climetlab) (from versions: )
No matching distribution found for ecmwflibs>=x.x.x (from climetlab)

you will need to make sure that you are using the latest version of pip (>=21.0.0):

% pip install --upgrade pip
% pip install climetlab

WARNING: Retrying (Retry(total=4, connect=None, …

If you are installing CliMetLab (or any other package) wihout internet access. You can get a similar error. This happens for instance on Kaggle when you are not logged it or when your account has not been verified.

WARNING: Retrying (Retry(total=4, connect=None, read=None, redirect=None, status=None))
after connection broken by 'NewConnectionError(': Failed to establish a new connection:
[Errno -3] Temporary failure in name resolution')':....

Module enum has no attribute ‘IntFlag’

If the installation fails with the following error:

AttributeError: module 'enum' has no attribute 'IntFlag'

This means that there is an old version of of the enum package on your system that needs to be removed:

% pip uninstall -y enum34
% pip install climetlab