Join the Email Distribution List
-
: MOSAiC get started (🧊 sea ice trajectories)
-
-
-
HYCOM-OceanTrack: A repository with notebook examples using
clouddriftwith 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.raggedmodule. - Common scientific analysis of Lagrangian data, oceanographic or otherwise;
for example, see the
clouddrift.kinematics,clouddrift.signal, andclouddrift.waveletmodules. - Processing existing Lagrangian datasets into a common data structure and format;
for example, see the
clouddrift.adapters.mosaicmodule. - Making cloud-optimized ragged-array datasets easily accessible; for example,
see the
clouddrift.datasetsmodule.
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 environment2a. 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.