/clouddrift

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

Primary LanguagePythonMIT LicenseMIT

clouddrift

CI Documentation Status codecov Checked with mypy Ruff NSF-2126413 Zenodo DOI JOSS DOI Hits

📦 Distributions

Available on conda-forge Available on pypi

👥 Social

Join the Email Distribution List

Bluesky Twitter/X

📚 Binders and examples

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.

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 gdp-get-started, mosaic-get-started, hurdat2-get-started, or a demo for the EarthCube community workshop 2023.

Contributing and scope

We welcome and invite contributions from the community in any shape or form! Please visit our Contributing Guide to get Started 😃

The scope of clouddrift includes:

If you have an idea that does not fit into the scope of clouddrift but you think it should, please open an issue to discuss it.

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

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

pip install clouddrift[plotting]
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

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

conda install matplotlib cartopy

Development branch:

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

pip:

In your existing virtual environment, you can use pip as follows.

  1. Get the code:
git clone https://github.com/cloud-drift/clouddrift
cd clouddrift/
  1. Install dependencies and local version of clouddrift:
pip install .
Conda:

Using conda, you can proceed as follows.

  1. Get the code:
git clone https://github.com/cloud-drift/clouddrift
cd clouddrift/
  1. Create an environment as specified in the yml file with the required library dependencies:
conda env create -f environment.yml # creates a new env with the dependencies
conda env update -f environment.yml # install dependencies in current environment

2a. Make sure you created the environment by activating it:

conda activate clouddrift
  1. Finally, install the local version of clouddrift:
pip install .

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.

Found an issue or need help?

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