Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
8597f27
Updating pixi
erikvansebille Oct 8, 2026
267e32d
First batch of changes to constructors and kernels
erikvansebille Nov 9, 2026
4dcde46
More fixes to kernels and constructors
erikvansebille Nov 9, 2026
d275fec
Adding time dimension to all nemo test files
erikvansebille Nov 9, 2026
efd668d
First fixes to test_kernels
erikvansebille Nov 9, 2026
ac82741
More fixes to kernels and constructors
erikvansebille Nov 11, 2026
100db44
Reverting adding time-ounter to wind and waves files
erikvansebille Nov 11, 2026
c63534f
Updating pixi
erikvansebille Nov 11, 2026
c398ad6
Fixing test_constructors
erikvansebille Nov 11, 2026
035f87f
Updating make_simple_fieldset
erikvansebille Nov 11, 2026
6a92ae5
Add parquet to .gitignore
erikvansebille Nov 11, 2026
df3c882
Fixing kernels and tests
erikvansebille Nov 12, 2026
2b1de74
Add ipywidgets (for tqdm) to pixi
erikvansebille Nov 12, 2026
6a5e129
Updating copernicusmarine example
erikvansebille Nov 12, 2026
5548370
Use convert.copernicusmarine for bgc
erikvansebille Nov 12, 2026
2c844b5
Add wind to copernicusmarine
erikvansebille Nov 13, 2026
f1537bf
Adding read_particlefile helper
erikvansebille Nov 13, 2026
98902ba
FIx kernels
erikvansebille Nov 13, 2026
6c60ea4
Update constructors
erikvansebille Nov 13, 2026
98da8d8
Update croatian fisheries example to v4
erikvansebille Nov 13, 2026
653e316
Update Greece coast example to v4
erikvansebille Nov 13, 2026
11b808b
Removing specific settings files
erikvansebille Nov 13, 2026
95c88ce
Removing notes about copernicusmarine
erikvansebille Nov 13, 2026
cae841b
Updating example texts
erikvansebille Nov 13, 2026
ef89569
Updating Italy coast example to v4
erikvansebille Nov 13, 2026
bcd46f8
Reverting change to nemo version of stokes
erikvansebille Nov 13, 2026
be903d4
Updating to Parcels v4.0.3
erikvansebille Nov 13, 2026
7e3c5e5
Update example_add_your_own_kernel.ipynb
erikvansebille Nov 13, 2026
efbc533
More v4.0.3 fixes
erikvansebille Nov 13, 2026
685654f
Add cmocean to dependencies
erikvansebille Nov 13, 2026
645697e
Update example_initialisation_maps.ipynb
erikvansebille Nov 13, 2026
872d1a3
Update example_idealised to v4
erikvansebille Nov 14, 2026
5c9610f
Add pandoc and gsw
erikvansebille Nov 14, 2026
aaa755f
Remove old idealised_flow
erikvansebille Nov 14, 2026
7df4063
Removing time_extrapolation option
erikvansebille Nov 14, 2026
d816e16
Replacing custom PolyTEOS10_bsq kernel with gsw functiosn
erikvansebille Nov 14, 2026
d77206e
Updating index page and readme
erikvansebille Nov 14, 2026
341b88f
Changing RK4 to RK2
erikvansebille Nov 14, 2026
0955097
Remove test_download_script
erikvansebille Nov 14, 2026
fbe1869
Updating interpolators
erikvansebille Nov 14, 2026
1480030
Temporary turning off XFreeSlip
erikvansebille Nov 14, 2026
c1f57f0
Simplifying tests
erikvansebille Nov 14, 2026
966b943
Updating kernels
erikvansebille Nov 14, 2026
1faf1f1
Rerun of example_add_your_kernel
erikvansebille Nov 15, 2026
35fc632
Merge branch 'main' into v4ify-plasticparcels
erikvansebille Nov 15, 2026
94a09bb
Adding pre-commit task to pixi
erikvansebille Nov 15, 2026
b025b33
Removing usused unbeachingBySamplingAfterward kernel
erikvansebille Nov 15, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ input_data/
**.DS_store**
**.pyc**
**.zarr
**.parquet
*.egg-info
build
docs/_build/*
Expand Down
17 changes: 1 addition & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,22 +15,7 @@ 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:

**Option A** - Using data streamed from the `copernicusmarine` toolkit.

* `plasticparcels` should work seamlessly with any of the datasets available in the `copernicusmarine` toolkit

**Option B** - Using hydrodynamic, biogeochemical and wind/wave model data from global reanalysis products

* Hydrodynamic model data: [MOI GLO12 (psy4v3r1)](https://www.mercator-ocean.eu/en/solutions-expertise/accessing-digital-data/product-details/?offer=4217979b-2662-329a-907c-602fdc69c3a3&system=d35404e4-40d3-59d6-3608-581c9495d86a)
* Biogeochemical model data: [MOI BIO4 (biomer4v2r1)](https://www.mercator-ocean.eu/en/solutions-expertise/accessing-digital-data/product-details/?offer=8d0c01f3-81c7-0a59-0d06-602fdf63c5b6&system=dc40b324-7de7-0732-880b-5d9dcf7d344a)
* Wave data: [ECMWF ERA5 Wave](https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-single-levels) (specifically, the variables `mean_wave_period`, `peak_wave_period`, `u_component_stokes_drift`, and `v_component_stokes_drift`.)
* Wind data: [ECMWF ERA5 Wind](https://cds.climate.copernicus.eu/cdsapp#!/dataset/reanalysis-era5-single-levels) (specifically, the variables `10m_u_component_of_wind` and `10m_v_component_of_wind`)

For downloading the wind and wave data, we recommend using the [CDS API](https://cds.climate.copernicus.eu/api-how-to).

To run most of the examples, you will need to update the data directories in the relevant settings `.json` file.
`plasticparcels` has been developed for use with data from the Copernicus Marine Service, and requires a [free account](https://marine.copernicus.eu/register-copernicus-marine-service).

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](https://github.com/Parcels-code/plasticparcels/discussions).

Expand Down
12 changes: 11 additions & 1 deletion docs/examples/copernicus_marine.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
{
"use_3D": false,
"allow_time_extrapolation": false,
"verbose_delete": false,
"use_mixing": false,
"use_biofouling": false,
Expand Down Expand Up @@ -65,6 +64,17 @@
"lat": "latitude",
"time": "time"}
},
"wind": {
"dataset_id": {"Wind_U": "cmems_obs-wind_glo_phy_my_l4_0.125deg_PT1H",
"Wind_V": "cmems_obs-wind_glo_phy_my_l4_0.125deg_PT1H"},
"variables": {
"Wind_U": "northward_wind",
"Wind_V": "eastward_wind"},
"dimensions": {"lon": "longitude",
"lat": "latitude",
"time": "time"}
},

"simulation": {
"start_date": null,
"runtime": null,
Expand Down
452 changes: 371 additions & 81 deletions docs/examples/example_Croatian_fisheries.ipynb

Large diffs are not rendered by default.

167 changes: 0 additions & 167 deletions docs/examples/example_Croatian_fisheries_settings.json

This file was deleted.

Loading
Loading