Installation#

You can install the latest release of CloudDrift using pip or Conda. You can also install the latest development (unreleased) version from GitHub.

pip#

In your virtual environment, type:

pip install clouddrift

To install optional dependencies needed by the clouddrift.plotting module, type:

pip install matplotlib-base cartopy

First add conda-forge to your channels in your Conda environment:

conda config --add channels conda-forge
conda config --set channel_priority strict

then install CloudDrift:

conda install clouddrift

To install optional dependencies needed by the clouddrift.plotting module, type:

conda install matplotlib-base cartopy

If you need the latest development version, get it from GitHub using pip:

pip install git+https://github.com/Cloud-Drift/clouddrift

To run the tests, you need to first download the CloudDrift source code from GitHub and install it in your virtual environment:

git clone https://github.com/cloud-drift/clouddrift
cd clouddrift
python3 -m venv venv
source venv/bin/activate
pip install .

Then, run the tests like this:

python -m unittest tests/*.py

A quick how-to guide is provided on the Usage page.