{"id":13948728,"url":"https://github.com/Cloud-Drift/clouddrift","last_synced_at":"2025-07-20T10:32:34.138Z","repository":{"id":60860858,"uuid":"424261992","full_name":"Cloud-Drift/clouddrift","owner":"Cloud-Drift","description":"CloudDrift accelerates the use of Lagrangian data for atmospheric, oceanic, and climate sciences.","archived":false,"fork":false,"pushed_at":"2025-07-10T10:15:39.000Z","size":6465,"stargazers_count":41,"open_issues_count":63,"forks_count":11,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-07-11T04:38:21.987Z","etag":null,"topics":["climate-data","climate-science","data-structures","oceanography","python"],"latest_commit_sha":null,"homepage":"https://clouddrift.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cloud-Drift.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":".zenodo.json"}},"created_at":"2021-11-03T14:43:06.000Z","updated_at":"2025-07-10T10:15:43.000Z","dependencies_parsed_at":"2023-10-23T14:50:57.046Z","dependency_job_id":"beb01b84-762c-4be3-b249-e06212088cf5","html_url":"https://github.com/Cloud-Drift/clouddrift","commit_stats":{"total_commits":388,"total_committers":10,"mean_commits":38.8,"dds":0.595360824742268,"last_synced_commit":"e19953e83fca79789984d996a61723094fbfc170"},"previous_names":[],"tags_count":52,"template":false,"template_full_name":null,"purl":"pkg:github/Cloud-Drift/clouddrift","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cloud-Drift%2Fclouddrift","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cloud-Drift%2Fclouddrift/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cloud-Drift%2Fclouddrift/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cloud-Drift%2Fclouddrift/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cloud-Drift","download_url":"https://codeload.github.com/Cloud-Drift/clouddrift/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cloud-Drift%2Fclouddrift/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264922866,"owners_count":23683701,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["climate-data","climate-science","data-structures","oceanography","python"],"created_at":"2024-08-08T05:01:29.108Z","updated_at":"2025-07-20T10:32:34.129Z","avatar_url":"https://github.com/Cloud-Drift.png","language":"Python","funding_links":[],"categories":["Atmosphere"],"sub_categories":["Atmospheric Dispersion and Transport"],"readme":"# `clouddrift`\n![CI](https://github.com/Cloud-Drift/clouddrift/workflows/CI/badge.svg)\n[![Documentation Status](https://github.com/Cloud-Drift/clouddrift/actions/workflows/docs.yml/badge.svg)](https://cloud-drift.github.io/clouddrift)\n[![codecov](https://codecov.io/gh/Cloud-Drift/clouddrift/branch/main/graph/badge.svg)](https://codecov.io/gh/Cloud-Drift/clouddrift/)\n[![Checked with mypy](http://www.mypy-lang.org/static/mypy_badge.svg)](http://mypy-lang.org/)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![NSF-2126413](https://img.shields.io/badge/NSF-2126413-blue.svg)](https://nsf.gov/awardsearch/showAward?AWD_ID=2126413)\n[![Zenodo DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.11081647.svg)](https://doi.org/10.5281/zenodo.11081647)\n[![JOSS DOI](https://joss.theoj.org/papers/10.21105/joss.06742/status.svg)](https://doi.org/10.21105/joss.06742)\n[![Hits](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2FCloud-Drift%2Fclouddrift\u0026count_bg=%2368C563\u0026title_bg=%23555555\u0026icon=\u0026icon_color=%23E7E7E7\u0026title=hits\u0026edge_flat=false)](https://hits.seeyoufarm.com)\n\n### 📦 Distributions\n[![Available on conda-forge](https://anaconda.org/conda-forge/clouddrift/badges/version.svg?style=flat-square)](https://anaconda.org/conda-forge/clouddrift/)\n[![Available on pypi](https://img.shields.io/pypi/v/clouddrift.svg?style=flat-square\u0026color=blue)](https://pypi.org/project/clouddrift/)\n\n### 👥 Social\n\n**[Join the Email Distribution List](http://eepurl.com/iNt1M2)**\n\n[![Bluesky](https://img.shields.io/badge/Bluesky-0285FF?logo=bluesky\u0026logoColor=fff\u0026style=for-the-badge)](https://bsky.app/profile/clouddrift.bsky.social)\n[![Twitter/X](https://img.shields.io/badge/X-000000?style=for-the-badge\u0026logo=x\u0026logoColor=white)](https://twitter.com/CloudDrift2)\n\n### 📚 Binders and examples\n- [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Cloud-Drift/mosaic-get-started/HEAD) : **MOSAiC get started (🧊 sea ice trajectories)**\n\n- [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Cloud-Drift/gdp-get-started/HEAD) : **GDP get started (🌊 ocean drifter trajectories)**\n\n- [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Cloud-Drift/hurdat2-get-started/HEAD) : **HURDAT2 get started (🌀 cyclone/hurricane trajectories from 1852 - 2022)**\n\n- [HYCOM-OceanTrack](https://github.com/selipot/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](https://registry.opendata.aws/hycom-global-drifters/index.html).\n\n\n`clouddrift` is a Python package that accelerates the use of Lagrangian data for atmospheric, oceanic, and climate sciences.\nIt is funded by [NSF EarthCube](https://www.earthcube.org/info) through the\n[EarthCube Capabilities Grant No. 2126413](https://www.nsf.gov/awardsearch/showAward?AWD_ID=2126413).\n\nRead the [documentation](https://cloud-drift.github.io/clouddrift).\n\n## Using `clouddrift`\n\nStart by reading the [documentation](https://cloud-drift.github.io/clouddrift).\n\nExample Jupyter notebooks that showcase the library, as well as scripts\nto process various Lagrangian datasets, can be found in [gdp-get-started](https://github.com/Cloud-Drift/gdp-get-started), [mosaic-get-started](https://github.com/Cloud-Drift/mosaic-get-started), [hurdat2-get-started](https://github.com/Cloud-Drift/hurdat2-get-started), or [a demo for the EarthCube community workshop 2023](https://github.com/Cloud-Drift/e3-comm-workshop-2023).\n\n## Contributing and scope\n\nWe welcome and invite contributions from the community in any shape or form! Please visit our [Contributing Guide](CONTRIBUTING.md) to get Started 😃\n\nThe scope of `clouddrift` includes:\n\n* Working with contiguous ragged-array data; for example, see the\n  [`clouddrift.ragged`](https://cloud-drift.github.io/clouddrift/_autosummary/clouddrift.ragged.html) module.\n* Common scientific analysis of Lagrangian data, oceanographic or otherwise;\n  for example, see the\n  [`clouddrift.kinematics`](https://cloud-drift.github.io/clouddrift/_autosummary/clouddrift.kinematics.html),\n  [`clouddrift.signal`](https://cloud-drift.github.io/clouddrift/_autosummary/clouddrift.signal.html), and\n  [`clouddrift.wavelet`](https://cloud-drift.github.io/clouddrift/_autosummary/clouddrift.wavelet.html) modules.\n* Processing existing Lagrangian datasets into a common data structure and format;\n  for example, see the [`clouddrift.adapters.mosaic`](https://cloud-drift.github.io/clouddrift/_autosummary/clouddrift.adapters.mosaic.html) module.\n* Making cloud-optimized ragged-array datasets easily accessible; for example,\n  see the [`clouddrift.datasets`](https://cloud-drift.github.io/clouddrift/_autosummary/clouddrift.datasets.html) module.\n\nIf you have an idea that does not fit into the scope of `clouddrift` but you think\nit should, please open an issue to discuss it.\n\n## Getting started\n\n### Install `clouddrift`\n\nYou can install the latest release of `clouddrift` using [pip](https://pypi.org/project/clouddrift/) or [conda](https://anaconda.org/conda-forge/clouddrift).\n\n#### Latest official release:\n##### pip:\n\nIn your virtual environment, type:\n\n```\npip install clouddrift\n```\n\nTo install optional dependencies needed by the `clouddrift.plotting` module,\ntype:\n\n```\npip install clouddrift[plotting]\n```\n\n##### Conda:\n\nFirst add `conda-forge` to your channels in your Conda configuration (`~/.condarc`):\n\n```\nconda config --add channels conda-forge\nconda config --set channel_priority strict\n```\n\nthen install `clouddrift`:\n\n```\nconda install clouddrift\n```\n\nTo install optional dependencies needed by the `clouddrift.plotting` module,\ntype:\n\n```\nconda install matplotlib cartopy\n```\n\n#### Development branch:\n\nIf you need the latest development version, you can install it directly from this GitHub repository.\n\n##### pip:\n\nIn your existing virtual environment, you can use `pip` as follows.\n1. Get the code:\n\n```bash\ngit clone https://github.com/cloud-drift/clouddrift\ncd clouddrift/\n```\n\n2. Install dependencies and local version of `clouddrift`:\n```bash\npip install .\n```\n\n##### Conda:\n\nUsing `conda`, you can proceed as follows.\n\n1. Get the code:\n\n```bash\ngit clone https://github.com/cloud-drift/clouddrift\ncd clouddrift/\n```\n\n2. Create an environment as specified in the yml file with the required library dependencies:\n```bash\nconda env create -f environment.yml # creates a new env with the dependencies\n```\n\n2a. Make sure you **created** the environment by activating it:\n```bash\nconda activate clouddrift\n```\n\n3. Finally, install the local version of `clouddrift`:\n```bash\npip install .\n```\n\n### Installing `clouddrift` on unsupported platforms\n\nOne or more dependencies of `clouddrift` may not have pre-built wheels for\nplatforms like IBM Power9 or Raspberry Pi.\nIf you are using pip to install `clouddrift` and are getting errors during the\ninstallation step, try installing `clouddrift` using Conda.\nIf you still have issues installing `clouddrift`, you may need to install system\ndependencies first.\nPlease let us know by opening an\n[issue](https://github.com/Cloud-Drift/clouddrift/issues/new) and we will do our\nbest to help you.\n\n## Found an issue or need help?\n\nPlease create a new issue [here](https://github.com/Cloud-Drift/clouddrift/issues/new)\nand provide as much detail as possible about your problem or question.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCloud-Drift%2Fclouddrift","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCloud-Drift%2Fclouddrift","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCloud-Drift%2Fclouddrift/lists"}