esa-climate-toolbox
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.
Installation into a new environment with conda
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.
Installation into an existing environment with conda
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.
Installation into an existing environment from the repository
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 .
Testing
You can run the unit tests for the ESA Climate Toolbox by executing
$ pytest
in the esa-climate-toolbox
repository.
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 htmlcov/index.html
.
Use
Jupyter notebooks demonstrating the use of the ESA Climate Toolbox can be found
in the notebooks/
subdirectory of the repository.
Releasing
To release the esa-climate-toolbox
, please follow the steps outlined in the
xcube Developer Guide.