parcels
Can be used to track passive and active particulates such as water, plankton, plastic and fish.
https://github.com/parcels-code/parcels
Keywords
lagrangian-ocean-modelling ocean-circulation-models particles
Keywords from Contributors
climate-model oceanography climate-science finite-volume gridded-data zarr geometry sphinx ocean-modelling sphinx-doc
Last synced: 1 day ago
JSON representation
Acceptance Criteria
- Revelant topics? true
- External users? true
- Open source license? true
- Active? true
- Fork? false
Repository metadata
Main code for Parcels - a highly customisable Lagrangian simulation framework
- Host: GitHub
- URL: https://github.com/parcels-code/parcels
- Owner: Parcels-code
- License: mit
- Created: 2015-09-29T09:43:00.000Z (almost 11 years ago)
- Default Branch: main
- Last Pushed: 2026-09-02T07:01:01.000Z (2 days ago)
- Last Synced: 2026-09-03T00:17:42.575Z (1 day ago)
- Topics: lagrangian-ocean-modelling, ocean-circulation-models, particles
- Language: Python
- Homepage: https://parcels-code.org
- Size: 154 MB
- Stars: 360
- Watchers: 22
- Forks: 188
- Open Issues: 122
- Releases: 39
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Claude: CLAUDE.md
README.md
Parcels
[!WARNING]
This branch contains version 4 of Parcels which is in active development. Seev3-supportto see v3 or the tags to browse stable versions of Parcels.
Parcels provides a set of Python classes and methods to create customisable particle tracking simulations using gridded output from (ocean) circulation models. Parcels can be used to track passive and active particulates such as water, plankton, plastic and fish.
Animation of virtual particles carried by ocean surface flow in the global oceans. The particles are advected with Parcels in data from the NEMO Ocean Model.
Parcels manuscript and code
The manuscript detailing the first release of Parcels, version 0.9, has been published in Geoscientific Model Development and can be cited as
Lange, M and E van Sebille (2017) Parcels v0.9: prototyping a Lagrangian Ocean Analysis framework for the petascale age. Geoscientific Model Development, 10, 4175-4186. https://doi.org/10.5194/gmd-2017-167
The manuscript detailing version 2.0 of Parcels is available at Geoscientific Model Development and can be cited as:
Delandmeter, P and E van Sebille (2019) The Parcels v2.0 Lagrangian framework: new field interpolation schemes. Geoscientific Model Development, 12, 3571-3584. https://doi.org/10.5194/gmd-12-3571-2019
The manuscript detailing the performance of Parcels v2.4 is available at Computers & Geosciences and can be cited as:
Kehl, C, PD Nooteboom, MLA Kaandorp and E van Sebille (2023) Efficiently simulating Lagrangian particles in large-scale ocean flows — Data structures and their impact on geophysical applications, Computers and Geosciences, 175, 105322. https://doi.org/10.1016/j.cageo.2023.105322
Further information
See parcels-code.org for further information about installing and running the Parcels code, as well as extended documentation of the methods and classes.
Contributors
All contributions are welcome! See the contributing page in our documentation to see how to get involved.
Image made with contrib.rocks.
Citation (CITATION.cff)
cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Van Sebille"
given-names: "Erik"
orcid: "https://orcid.org/0000-0003-2041-0704"
- family-names: "Hodgskin"
given-names: "Nick"
orcid: "https://orcid.org/0009-0003-0778-3183"
- family-names: "Kehl"
given-names: "Christian"
orcid: "https://orcid.org/0000-0003-4200-1450"
- family-names: "Lange"
given-names: "Michael"
orcid: "https://orcid.org/0000-0002-3232-0127"
- family-names: "Delandmeter"
given-names: "Philippe"
orcid: "https://orcid.org/0000-0003-0100-5834"
- name: "The Parcels contributors"
website: "https://github.com/Parcels-code/parcels/graphs/contributors"
title: "Parcels"
version: 3.1.2
doi: 10.5281/zenodo.14845686
date-released: 2025-02-10
url: "https://github.com/Parcels-code/parcels"
Owner metadata
- Name: Parcels
- Login: Parcels-code
- Email:
- Kind: organization
- Description:
- Website: http://parcels-code.org
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/14887518?v=4
- Repositories: 56
- Last ynced at: 2025-10-07T17:15:45.849Z
- Profile URL: https://github.com/Parcels-code
GitHub Events
Total
- Create event: 51
- Delete event: 72
- Discussion event: 7
- Fork event: 1
- Issue comment event: 84
- Issues event: 72
- Pull request event: 107
- Pull request review comment event: 151
- Pull request review event: 125
- Push event: 330
- Watch event: 5
Last Year
- Create event: 51
- Delete event: 72
- Discussion event: 7
- Fork event: 1
- Issue comment event: 84
- Issues event: 72
- Pull request event: 107
- Pull request review comment event: 151
- Pull request review event: 125
- Push event: 330
- Watch event: 5
Committers metadata
Last synced: 2 days ago
Total Commits: 6,700
Total Committers: 82
Avg Commits per committer: 81.707
Development Distribution Score (DDS): 0.566
Commits in past year: 929
Committers in past year: 22
Avg Commits per committer in past year: 42.227
Development Distribution Score (DDS) in past year: 0.586
| Name | Commits | |
|---|---|---|
| Erik van Sebille | e****e@g****m | 2910 |
| Vecko | 3****o | 979 |
| delandmeter | p****r@g****m | 651 |
| Christian Kehl | c****l@u****l | 390 |
| Michael Lange | m****e@i****k | 329 |
| Joe Schoonover | j****e@f****m | 232 |
| Roel Brouwer | 5****r | 162 |
| reint-fischer | G****r@M****l | 135 |
| pre-commit-ci[bot] | 6****] | 117 |
| Reint | 3****r | 105 |
| Daan | d****s@o****m | 65 |
| Raoul Schram | r****m@u****l | 61 |
| Willi Rath | w****h@g****e | 60 |
| dependabot[bot] | 4****] | 42 |
| pdnooteboom | 3****m | 42 |
| jacketless | j****s@g****m | 26 |
| reint-fischer | G****r@m****e | 25 |
| RomanIMMSP | 1****P | 25 |
| Angus Gibson | a****s@a****e | 24 |
| Simnator101 | s****r@g****m | 24 |
| andrew-s28 | a****7@g****m | 22 |
| Guillaume Maze | g****e@i****r | 21 |
| Joel Kronborg | j****g@h****m | 19 |
| paul | p****k@g****m | 16 |
| Michael Denes | m****s@g****m | 15 |
| Noam | n****t@s****k | 14 |
| Erik van Sebille | e****k@i****l | 13 |
| davidwichmann | 3****n | 10 |
| Bas Altena | b****a@u****l | 10 |
| JamiePringle | j****e@u****u | 10 |
| and 52 more... | ||
Committer domains:
- uu.nl: 10
- imperial.ac.uk: 2
- fluidnumerics.com: 2
- lorenz.science.uu.nl: 2
- geomar.de: 1
- mac.home: 1
- agibson.me: 1
- ifremer.fr: 1
- st-annes.ox.ac.uk: 1
- imac-sebille.soliscom.uu.nl: 1
- unh.edu: 1
- ic.ac.uk: 1
- cl-evansebi.cl.ic.ac.uk: 1
- noaa.gov: 1
- ldeo.columbia.edu: 1
- science-bs35.soliscom.uu.nl: 1
- quintoandar.com.br: 1
- node04.cluster.intern: 1
- dyn906-234.eduroam.ic.ac.uk: 1
- miami.edu: 1
- cv-cej4917.cv.ic.ac.uk: 1
- aos-c02q53.princeton.edu: 1
- eoas.ubc.ca: 1
- geomdata.com: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 137
Total pull requests: 248
Average time to close issues: about 2 months
Average time to close pull requests: 7 days
Total issue authors: 16
Total pull request authors: 19
Average comments per issue: 1.53
Average comments per pull request: 0.86
Merged pull request: 164
Bot issues: 3
Bot pull requests: 37
Past year issues: 136
Past year pull requests: 248
Past year average time to close issues: about 2 months
Past year average time to close pull requests: 7 days
Past year issue authors: 16
Past year pull request authors: 19
Past year average comments per issue: 1.52
Past year average comments per pull request: 0.86
Past year merged pull request: 164
Past year bot issues: 3
Past year bot pull requests: 37
Top Issue Authors
- VeckoTheGecko (61)
- erikvansebille (37)
- fluidnumericsJoe (8)
- reint-fischer (5)
- willirath (5)
- wyatt-fluidnumerics (4)
- github-actions[bot] (3)
- noemieplanat (2)
- Dobbermann2 (2)
- michaeldenes (2)
- fluidnumerics-joe (2)
- PeterWolfram (2)
- sruehs (1)
- danliba (1)
- j-atkins (1)
Top Pull Request Authors
- VeckoTheGecko (99)
- erikvansebille (62)
- dependabot[bot] (27)
- reint-fischer (10)
- fluidnumericsJoe (10)
- pre-commit-ci[bot] (10)
- wyatt-fluidnumerics (6)
- fluidnumerics-joe (4)
- michaeldenes (4)
- PeterWolfram (4)
- nilodna (2)
- tibisabau (2)
- sujeito-operator (2)
- joseCarlosAndrade (1)
- aryasalem09 (1)
Top Issue Labels
- v4 (46)
- needs-triage (28)
- bug (28)
- documentation (20)
- good first issue (15)
- v4-roadmap/not-for-v4 (14)
- enhancement (13)
- v4-roadmap/to-be-discussed (11)
- v4-roadmap/musthave (11)
- meta (9)
- feature (8)
- api-design (7)
- performance (6)
- needs investigation (6)
- testing (6)
- hackathon2025 (5)
- topic/output-data (4)
- refactor (4)
- unstructured grids (3)
- automated (3)
- CI/CD (3)
- tracking (3)
- help wanted (3)
- v4-roadmap/4.1 (2)
- upstream issue (2)
- v4-roadmap/plan-to-close (2)
- topic/input-data (2)
- oceanography (2)
- topic/interpolators (2)
- topic/kernels (2)
Top Pull Request Labels
- github_actions (27)
- dependencies (27)
- v4 (3)
- run-upstream (2)
- meta (2)
- 🚧BLOCKED🚧 (1)
- topic/kernels (1)
- CI/CD (1)
- bug (1)
- api-design (1)
- documentation (1)
Dependencies
- parcels
- pooch
- trajan
- actions/checkout v5 composite
- actions/github-script v8 composite
- astral-sh/setup-uv v7 composite
- prefix-dev/setup-pixi v0.9.0 composite
- Parcels-code/pixi-lock/create-and-cache a9aee67fa67426e6b0297fa5bef80600572be153 composite
- Parcels-code/pixi-lock/restore a9aee67fa67426e6b0297fa5bef80600572be153 composite
- actions/cache/restore v4 composite
- actions/cache/save v4 composite
- actions/checkout v4 composite
- actions/checkout v5 composite
- actions/upload-artifact v7 composite
- actions/upload-artifact/merge v7 composite
- codecov/codecov-action v5.5.1 composite
- prefix-dev/setup-pixi v0.9.0 composite
- xarray-contrib/ci-trigger v1 composite
- actions/checkout v5 composite
- actions/download-artifact v8 composite
- actions/setup-python v6 composite
- actions/upload-artifact v7 composite
- conda-incubator/setup-miniconda v3 composite
- pypa/gh-action-pypi-publish v1.12.4 composite
- actions/checkout 3d3c42e5aac5ba805825da76410c181273ba90b1 composite
- actions/download-artifact 3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c composite
- actions/upload-artifact 043fb46d1a93c77aae656e7c1c64a875d1fc6a0a composite
- prefix-dev/setup-pixi f00437f565399d418b0acc85936d12c1fb668347 composite
- scientific-python/issue-from-pytest-log-action 35b4e0a9e06f8e7e261778289cf4b968b722662d composite
- xarray-contrib/ci-trigger 74ddc46fc6ca7509549ac7b660d7a185948c1e74 composite
- xarray-contrib/pixi-lock/create-and-cache 1fab4c17af8243f6ca1321bc941cf2325f46c05d composite
- xarray-contrib/pixi-lock/restore 1fab4c17af8243f6ca1321bc941cf2325f46c05d composite
Score: 10.584663361314853