Metadata-Version: 2.1
Name: clouddrift
Version: 0.3.1
Summary: Accelerating the use of Lagrangian data for atmospheric, oceanic, and climate sciences
Project-URL: Homepage, https://github.com/Cloud-Drift/clouddrift
Project-URL: Documentation, https://cloud-drift.github.io/clouddrift
Author-email: Shane Elipot <selipot@miami.edu>, Philippe Miron <philippemiron@gmail.com>, Milan Curcic <mcurcic@miami.edu>
License-File: LICENSE
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: awkward>=2.0.0
Requires-Dist: fsspec>=2022.3.0
Requires-Dist: netcdf4>=1.5.8
Requires-Dist: numpy>=1.22.4
Requires-Dist: pyarrow>=8.0.0
Requires-Dist: tqdm>=4.64.0
Requires-Dist: xarray>=2022.3.0
Description-Content-Type: text/markdown

# CloudDrift
![CI](https://github.com/Cloud-Drift/clouddrift/workflows/CI/badge.svg)
[![Documentation Status](https://github.com/Cloud-Drift/clouddrift/actions/workflows/docs.yml/badge.svg)](https://cloud-drift.github.io/clouddrift)
[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Cloud-Drift/clouddrift-examples/main?labpath=notebooks)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![NSF-2126413](https://img.shields.io/badge/NSF-2126413-blue.svg)](https://nsf.gov/awardsearch/showAward?AWD_ID=2126413)
[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FCloud-Drift%2Fclouddrift&count_bg=%2368C563&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false)](https://hits.seeyoufarm.com)

CloudDrift accelerates the use of Lagrangian data for atmospheric, oceanic, and climate sciences.
It is funded by [NSF EarthCube](https://www.earthcube.org/info) through the
[EarthCube Capabilities Grant No. 2126413](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2126413).

## Getting started

### Install CloudDrift

#### pip

You can install CloudDrift using pip via PyPI:

```
pip install clouddrift
```

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

```
pip install git+https://github.com/cloud-drift/clouddrift
```

#### Conda

You can also install CloudDrift using Conda:

```
git clone https://github.com/cloud-drift/clouddrift
cd clouddrift
conda env create --file environment.yml
```

In the future, a conda-forge package will be available to simplify the installation process.

### Run the tests

If you downloaded the CloudDrift source code from GitHub, you can run all tests
like this:

```
python -m unittest tests/*.py
```

## Using CloudDrift

Start by reading the [documentation](https://cloud-drift.github.io/clouddrift).

Example Jupyter notebooks that showcase the library, as well as scripts
to process various Lagrangian datasets, are in
[clouddrift-examples](https://github.com/Cloud-Drift/clouddrift-examples).

## Found an issue or need help?

Please create a new issue [here](https://github.com/Cloud-Drift/clouddrift/issues/new)
and provide as much detail as possible about your problem or question.
