Skip to content

CloudDrift accelerates the use of Lagrangian data for atmospheric, oceanic, and climate sciences.

License

Notifications You must be signed in to change notification settings

Cloud-Drift/clouddrift

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Repository files navigation

CloudDrift

CI Documentation Status codecov Binder Available on conda-forge Available on pypi Code style: black NSF-2126413 Hits

CloudDrift is a Python package that accelerates the use of Lagrangian data for atmospheric, oceanic, and climate sciences. It is funded by NSF EarthCube through the EarthCube Capabilities Grant No. 2126413.

Read the documentation or explore the Jupyter Notebook Examples.

Getting started

Install CloudDrift

You can install the latest release of CloudDrift using pip or conda.

Latest official release:

pip:

In your virtual environment, type:

pip install clouddrift
Conda:

First add conda-forge to your channels in your Conda configuration (~/.condarc):

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

then install CloudDrift:

conda install clouddrift

Development branch:

If you need the latest development version, you can install it directly from this GitHub repository.

pip:

In your virtual environment, type:

pip install git+https://github.com/cloud-drift/clouddrift
Conda:
conda env create -f environment.yml

with the environment file located in the main repository.

Run the tests

To run the tests, you need to first download the CloudDrift source code from GitHub:

git clone https://github.com/cloud-drift/clouddrift
cd clouddrift/

and create the virtual environment.

With pip:

python3 -m venv .venv
source .venv/bin/activate
pip install .

With Conda:

conda env create -f environment.yml
conda activate clouddrift

Then, run the tests like this:

python -m unittest tests/*.py

Installing CloudDrift on unsupported platforms

One or more dependencies of CloudDrift may not have pre-built wheels for platforms like IBM Power9 or Raspberry Pi. If you are using pip to install CloudDrift and are getting errors during the installation step, try installing CloudDrift using Conda. If you still have issues installing CloudDrift, you may need to install system dependencies first. Please let us know by opening an issue and we will do our best to help you.

Using CloudDrift

Start by reading the documentation.

Example Jupyter notebooks that showcase the library, as well as scripts to process various Lagrangian datasets, can be found in clouddrift-examples.

Found an issue or need help?

Please create a new issue here and provide as much detail as possible about your problem or question.