The ESA Climate Toolbox is designed to provide access to CCI data from the ESA Climate Data Centre. Also, it contains functions to operate on this data.
The ESA Climate Toolbox and all necessary dependencies are available on conda-forge, and can be installed using the conda package manager. The conda package manager itself can be obtained in the miniconda distribution. Once conda is installed, the ESA Climate Toolbox can be installed like this:
$ conda create --name ect --channel conda-forge esa-climate-toolbox $ conda activate ect
The name of the environment may be freely chosen.
The ESA Climate Toolbox can also be installed into an existing conda environment. To do so, execute this command with the existing environment activated:
$ conda install --channel conda-forge xcube-cci
Any necessary dependencies will be installed or updated if they are not already installed in a compatible version.
If you want to install the ESA Climate Toolbox directly from the git repository (for example in order to use an unreleased version or to modify the code), you can do so as follows:
$ git clone https://github.com/esa-cci/esa-climate-toolbox.git $ cd esa-climate-toolbox $ conda env create $ conda activate ect $ pip install -e .
You can run the unit tests for the ESA Climate Toolbox by executing
To create a test coverage report, you can use
coverage run --include='esa-climate-toolbox/**' --module pytest coverage html
This will write a coverage report to
Jupyter notebooks demonstrating the use of the ESA Climate Toolbox can be found
notebooks/ subdirectory of the repository.
To release the
esa-climate-toolbox, please follow the steps outlined in the
xcube Developer Guide.