plasticparcels
A Python package for simulating the transport and dispersion of plastics in the ocean.
https://github.com/parcels-code/plasticparcels
Category: Industrial Ecology
Sub Category: Circular Economy and Waste
Keywords from Contributors
lagrangian-ocean-modelling ocean-circulation-models
Last synced: about 2 hours ago
JSON representation
Repository metadata
Repository for PlasticParcels tool
- Host: GitHub
- URL: https://github.com/parcels-code/plasticparcels
- Owner: Parcels-code
- License: mit
- Created: 2023-10-30T10:33:44.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-23T20:08:00.000Z (4 days ago)
- Last Synced: 2026-03-23T23:24:15.868Z (3 days ago)
- Language: Python
- Homepage:
- Size: 52.1 MB
- Stars: 17
- Watchers: 3
- Forks: 7
- Open Issues: 8
- Releases: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
README.md
plasticparcels
plasticparcels is a python package for simulating the transport and dispersion of plastics in the ocean.
The tool is based on the Parcels computational Lagrangian ocean analysis framework (@Lange2017 and @Delandmeter2019), providing a modular and customisable collection of methods, notebooks, and tutorials for advecting virtual plastic particles with a wide range of physical properties. A peer reviewed paper describing plasticparcels can be found here: 
.
Installation
plasticparcels can be installed using conda from the conda-forge channel with the following command:
conda install conda-forge::plasticparcels
Required data
plasticparcels has been developed for use with data from the Copernicus Marine Service, and requires the following data to run:
- Hydrodynamic model data: MOI GLO12 (psy4v3r1)
- Biogeochemical model data: MOI BIO4 (biomer4v2r1)
- Wave data: ECMWF ERA5 Wave (specifically, the variables
mean_wave_period,peak_wave_period,u_component_stokes_drift, andv_component_stokes_drift.) - Wind data: ECMWF ERA5 Wind (specifically, the variables
10m_u_component_of_windand10m_v_component_of_wind)
For downloading the wind and wave data, we recommend using the CDS API.
To run most of the examples, you will need to update the data directories in the relevant settings .json file.
Just like the parcels framework, plasticparcels can be adapted to use other hydrodynamic, biogeochemical, wave, and atmospheric models. If you require assistance, please contact us through the plasticparcels discussions page.
Community contributions and support
Contributing code
We welcome contributions to plasticparcels, especially example workbooks and analyses for our public examples page. To contribute to the project, please submit a pull request.
Requesting features and reporting issues/bugs
If you want to request a new feature, or if you find an issue or bug in the code, please open an issue in the plasticparcels issue tracker.
Seeking support?
If you would like support using plasticparcels, or are have any questions about your plasticparcels simulations, please start a discussion in the plasticparcels discussion page.
Further information
For more information and documentation, see the plasticparcels documentation.
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
- Pull request event: 1
- Discussion event: 1
- Watch event: 3
- Issue comment event: 1
- Push event: 23
- Pull request review event: 2
- Create event: 2
Last Year
- Pull request event: 1
- Discussion event: 1
- Watch event: 3
- Issue comment event: 1
- Push event: 23
- Pull request review event: 2
- Create event: 2
Committers metadata
Last synced: 2 days ago
Total Commits: 360
Total Committers: 4
Avg Commits per committer: 90.0
Development Distribution Score (DDS): 0.289
Commits in past year: 18
Committers in past year: 4
Avg Commits per committer in past year: 4.5
Development Distribution Score (DDS) in past year: 0.333
| Name | Commits | |
|---|---|---|
| michaeldenes | m****s@g****m | 256 |
| Erik van Sebille | e****e@g****m | 79 |
| pre-commit-ci[bot] | 6****] | 14 |
| Vecko | 3****o | 11 |
Issue and Pull Request metadata
Last synced: 3 days ago
Total issues: 0
Total pull requests: 3
Average time to close issues: N/A
Average time to close pull requests: 5 days
Total issue authors: 0
Total pull request authors: 1
Average comments per issue: 0
Average comments per pull request: 0.33
Merged pull request: 1
Bot issues: 0
Bot pull requests: 0
Past year issues: 0
Past year pull requests: 3
Past year average time to close issues: N/A
Past year average time to close pull requests: 5 days
Past year issue authors: 0
Past year pull request authors: 1
Past year average comments per issue: 0
Past year average comments per pull request: 0.33
Past year merged pull request: 1
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
Top Pull Request Authors
- michaeldenes (3)
Top Issue Labels
Top Pull Request Labels
Dependencies
- coverage
- geopandas
- parcels >=3.0.2
- pytest
- shapely
- actions/checkout v4 composite
- actions/upload-artifact v1 composite
- openjournals/openjournals-draft-action master composite
- mamba-org/setup-micromamba v1 composite
- ./.github/actions/install-plasticparcels * composite
- actions/checkout v3 composite
- parcels >= 3.0.2, < 4
- pytest *
Score: 4.605170185988091