Parcels
This branch contains version 4 of Parcels. Change to
v3-supportto see v3 (which is currently in maintainence mode) 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 Copernicus Marine Service. See here for the script to create this animation yourself.
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 API reference of the methods and classes.
Contributors
All contributions are welcome! See the development page in our documentation to see how to get involved. Image made with contrib.rocks.
3 maintainers
Metadata
3 maintainers
Release files for parcels 4.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| parcels-4.0.1.tar.gz | 12.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| parcels-4.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.9 MB
Release files / parcels-4.0.1.tar.gz
| Download URL | parcels-4.0.1.tar.gz |
|---|---|
| Size | 12.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
11b91c8e4fecc86172046370a214654f7e13d20f5be052bfecf210b50946a001
|
|
BLAKE2b-256 checksum How to use checksums |
364acc60eeee3acda73b4cc5941a1ef8ae65c04f2aa6276330518aab4b330997
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / parcels-4.0.1-py3-none-any.whl
| Download URL | parcels-4.0.1-py3-none-any.whl |
|---|---|
| Size | 164.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d62c6427e1cbb7f2b2b867e1cb7e81e6cb229a42b18f6640977bac0c8a1ba56c
|
|
BLAKE2b-256 checksum How to use checksums |
2bb695d397bfc6f87a540dbfb39191921c06e3387d5640cb4b42576b30e88977
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency log
