-
: HURDAT2 get started (🌀 cyclone/hurricane trajectories from 1852 - 2022)
-
HYCOM-OceanTrack: A repository with notebook examples using
clouddrift
with a very large , analysis-ready cloud-optimized, Lagrangian dataset hosted in the cloud: HYCOM OceanTrack: Integrated HYCOM Eulerian Fields and Lagrangian Trajectories Dataset.
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.
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.
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:
- Working with contiguous ragged-array data; for example, see the
clouddrift.ragged
module. - Common scientific analysis of Lagrangian data, oceanographic or otherwise;
for example, see the
clouddrift.kinematics
,clouddrift.signal
, andclouddrift.wavelet
modules. - Processing existing Lagrangian datasets into a common data structure and format;
for example, see the
clouddrift.adapters.mosaic
module. - Making cloud-optimized ragged-array datasets easily accessible; for example,
see the
clouddrift.datasets
module.
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.
You can install the latest release of clouddrift
using pip or conda.
In your virtual environment, type:
pip install clouddrift
To install optional dependencies needed by the clouddrift.plotting
module,
type:
pip install clouddrift[plotting]
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
If you need the latest development version, you can install it directly from this GitHub repository.
In your existing virtual environment, you can use pip
as follows.
- Get the code:
git clone https://github.com/cloud-drift/clouddrift
cd clouddrift/
- Install dependencies and local version of
clouddrift
:
pip install .
Using conda
, you can proceed as follows.
- Get the code:
git clone https://github.com/cloud-drift/clouddrift
cd clouddrift/
- 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
- Finally, install the local version of
clouddrift
:
pip install .
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.
Please create a new issue here and provide as much detail as possible about your problem or question.