An xcube plugin that allows generating data cubes from the ESA CCI Open Data Portal.
xcube-cci and all necessary dependencies (including xcube itself) 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, xcube-cci can be installed like this:
$ conda create --name xcube-cci-environment --channel conda-forge xcube-cci
$ conda activate xcube-cci-environment
The name of the environment may be freely chosen.
xcube-cci can also be installed into an existing conda environment. With an existing conda environment activated, execute this command:
$ conda install --channel conda-forge xcube-cci
xcube and any other necessary dependencies will be installed or updated if they are not already installed in a compatible version.
If you want to install xcube-cci 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/xcube-cci.git
$ cd xcube-cci
$ conda env create
$ conda activate xcube-cci
$ pip install --no-deps -e .
You can run the unit tests for xcube-cci by executing
$ pytest
in the xcube-cci
repository. Note that, in order to successfully run the
tests using the current repository version of xcube-cci, you may also need to
install the repository version of xcube rather than its latest conda-forge
release.
To create a test coverage report, you can use
coverage run --include='xcube_cci/**' --module pytest
coverage html
This will write a coverage report to htmlcov/index.html
.
Jupyter notebooks demonstrating the use of the xcube-cds plugin can be found
in the examples/notebooks/
subdirectory of the repository.
To release xcube-cci
, please follow the steps outlined in the
xcube Developer Guide.