Note
Go to the end to download the full example code.
Ship drift
from datetime import datetime
from opendrift.models.shipdrift import ShipDrift
o = ShipDrift(loglevel=20)
o.add_readers_from_list([
'https://thredds.met.no/thredds/dodsC/cmems/topaz6/dataset-topaz6-arc-15min-3km-be.ncml',
'https://thredds.met.no/thredds/dodsC/mepslatest/meps_lagged_6_h_latest_2_5km_latest.nc',
'https://thredds.met.no/thredds/dodsC/cmems/mywavewam3km/dataset-wam-arctic-1hr3km-be.ncml'
])
13:50:19 INFO opendrift:576: OpenDriftSimulation initialised (version 1.14.7 / v1.14.7-15-g2988cd4)
Seed ship elements at defined position and time Note: beam/length ratio is larger than allowed, but is then clipped internally
o.seed_elements(lon=5.0, lat=63.0, radius=1000, number=1000,
time=datetime.now(),
length=80.0, beam=20.0, height=9.0, draft=4.0)
13:50:19 WARNING opendrift.models.shipdrift:181: Ratio of beam to length should be in range 0.12 to 0.18, given range is 0.25-0.25. Using border value.
13:50:19 INFO opendrift.models.basemodel.environment:203: Adding a global landmask from GSHHG
13:50:24 INFO opendrift.models.basemodel.environment:227: Fallback values will be used for the following variables which have no readers:
13:50:24 INFO opendrift.models.basemodel.environment:230: sea_surface_wave_stokes_drift_x_velocity: 0.000000
13:50:24 INFO opendrift.models.basemodel.environment:230: sea_surface_wave_stokes_drift_y_velocity: 0.000000
13:50:24 INFO opendrift.models.basemodel.environment:230: sea_surface_wave_significant_height: 0.000000
13:50:24 INFO opendrift.models.basemodel.environment:230: sea_surface_wave_mean_period_from_variance_spectral_density_second_frequency_moment: 0.000000
Running model
o.run(steps=24, stop_on_error=True)
13:50:24 INFO opendrift:1814: Storing previous values of element property lon because of condition (('general:coastline_action', 'in', ['stranding', 'previous']), 'or', ('general:seafloor_action', 'in', ['previous']))
13:50:24 INFO opendrift:1814: Storing previous values of element property lat because of condition (('general:coastline_action', 'in', ['stranding', 'previous']), 'or', ('general:seafloor_action', 'in', ['previous']))
13:50:24 INFO opendrift:952: Using existing reader for land_binary_mask to move elements to ocean
13:50:24 INFO opendrift:982: All points are in ocean
13:50:24 INFO opendrift:2111: 2025-12-16 13:50:19.853614 - step 1 of 24 - 1000 active elements (0 deactivated)
13:50:24 INFO opendrift.readers:63: Opening file with xr.open_dataset
13:50:26 INFO opendrift.readers.reader_netCDF_CF_generic:332: Detected dimensions: {'x': 'x', 'y': 'y', 'time': 'time'}
13:50:26 INFO opendrift.readers:63: Opening file with xr.open_dataset
13:50:27 INFO opendrift.readers.reader_netCDF_CF_generic:332: Detected dimensions: {'time': 'time', 'x': 'x', 'y': 'y'}
13:50:27 INFO opendrift.readers:63: Opening file with xr.open_dataset
13:50:28 INFO opendrift.readers.reader_netCDF_CF_generic:332: Detected dimensions: {'y': 'rlat', 'x': 'rlon', 'time': 'time'}
13:50:30 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:30 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:30 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:30 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:32 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:32 INFO opendrift:2111: 2025-12-16 14:50:19.853614 - step 2 of 24 - 1000 active elements (0 deactivated)
13:50:33 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:33 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:33 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:33 INFO opendrift:2111: 2025-12-16 15:50:19.853614 - step 3 of 24 - 1000 active elements (0 deactivated)
13:50:35 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:35 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:36 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:36 INFO opendrift:2111: 2025-12-16 16:50:19.853614 - step 4 of 24 - 1000 active elements (0 deactivated)
13:50:37 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:37 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:38 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:38 INFO opendrift:2111: 2025-12-16 17:50:19.853614 - step 5 of 24 - 1000 active elements (0 deactivated)
13:50:40 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:40 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:40 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:40 INFO opendrift:2111: 2025-12-16 18:50:19.853614 - step 6 of 24 - 1000 active elements (0 deactivated)
13:50:42 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:42 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:43 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:43 INFO opendrift:2111: 2025-12-16 19:50:19.853614 - step 7 of 24 - 1000 active elements (0 deactivated)
13:50:44 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:44 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:45 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:45 INFO opendrift:2111: 2025-12-16 20:50:19.853614 - step 8 of 24 - 1000 active elements (0 deactivated)
13:50:46 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:46 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:47 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:47 INFO opendrift:2111: 2025-12-16 21:50:19.853614 - step 9 of 24 - 1000 active elements (0 deactivated)
13:50:48 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:48 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:49 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:49 INFO opendrift:2111: 2025-12-16 22:50:19.853614 - step 10 of 24 - 1000 active elements (0 deactivated)
13:50:50 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:50 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:51 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:51 INFO opendrift:2111: 2025-12-16 23:50:19.853614 - step 11 of 24 - 1000 active elements (0 deactivated)
13:50:53 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:53 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:54 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:54 INFO opendrift:2111: 2025-12-17 00:50:19.853614 - step 12 of 24 - 1000 active elements (0 deactivated)
13:50:55 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:55 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:56 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:56 INFO opendrift:2111: 2025-12-17 01:50:19.853614 - step 13 of 24 - 1000 active elements (0 deactivated)
13:50:57 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:57 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:50:58 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:50:58 INFO opendrift:2111: 2025-12-17 02:50:19.853614 - step 14 of 24 - 1000 active elements (0 deactivated)
13:51:00 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:00 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:00 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:00 INFO opendrift:2111: 2025-12-17 03:50:19.853614 - step 15 of 24 - 1000 active elements (0 deactivated)
13:51:02 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:02 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:03 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:03 INFO opendrift:2111: 2025-12-17 04:50:19.853614 - step 16 of 24 - 1000 active elements (0 deactivated)
13:51:04 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:04 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:05 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:05 INFO opendrift:2111: 2025-12-17 05:50:19.853614 - step 17 of 24 - 1000 active elements (0 deactivated)
13:51:07 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:07 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:07 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:07 INFO opendrift:2111: 2025-12-17 06:50:19.853614 - step 18 of 24 - 1000 active elements (0 deactivated)
13:51:09 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:09 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:10 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:10 INFO opendrift:2111: 2025-12-17 07:50:19.853614 - step 19 of 24 - 1000 active elements (0 deactivated)
13:51:11 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:11 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:12 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:12 INFO opendrift:2111: 2025-12-17 08:50:19.853614 - step 20 of 24 - 1000 active elements (0 deactivated)
13:51:13 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:13 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:14 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:14 INFO opendrift:2111: 2025-12-17 09:50:19.853614 - step 21 of 24 - 1000 active elements (0 deactivated)
13:51:15 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:15 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:16 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:16 INFO opendrift:2111: 2025-12-17 10:50:19.853614 - step 22 of 24 - 1000 active elements (0 deactivated)
13:51:18 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:18 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:18 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:18 INFO opendrift:2111: 2025-12-17 11:50:19.853614 - step 23 of 24 - 1000 active elements (0 deactivated)
13:51:20 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:20 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:21 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
13:51:21 INFO opendrift:2111: 2025-12-17 12:50:19.853614 - step 24 of 24 - 1000 active elements (0 deactivated)
13:51:23 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:23 WARNING opendrift.readers.interpolation.structured:63: Ensemble data currently not extrapolated towards seafloor
13:51:24 INFO opendrift.models.shipdrift:311: Using Stokes drift direction as wave direction
Print and plot results
print(o)
o.plot(linecolor='orientation')
#o.animation(color='orientation', markersize=20, filename="orientation.gif", legend=['left','right'],colorbar=False,cmap='bwr')
o.animation(color='orientation', legend=['left','right'], markersize=20, colorbar=False, cmap='bwr')

===========================
--------------------
Reader performance:
--------------------
global_landmask
0:00:00.0 total
0:00:00.0 preparing
0:00:00.0 reading
0:00:00.0 masking
--------------------
https://thredds.met.no/thredds/dodsC/cmems/topaz6/dataset-topaz6-arc-15min-3km-be.ncml
0:00:17.5 total
0:00:00.0 preparing
0:00:17.5 reading
0:00:00.0 interpolation
0:00:00.0 interpolation_time
0:00:00.0 rotating vectors
0:00:00.0 masking
--------------------
https://thredds.met.no/thredds/dodsC/mepslatest/meps_lagged_6_h_latest_2_5km_latest.nc
0:00:18.5 total
0:00:00.0 preparing
0:00:18.4 reading
0:00:00.3 interpolation
0:00:00.0 interpolation_time
0:00:00.0 rotating vectors
0:00:00.0 masking
--------------------
https://thredds.met.no/thredds/dodsC/cmems/mywavewam3km/dataset-wam-arctic-1hr3km-be.ncml
0:00:17.6 total
0:00:00.0 preparing
0:00:17.5 reading
0:00:00.0 interpolation
0:00:00.0 interpolation_time
0:00:00.0 rotating vectors
0:00:00.0 masking
--------------------
Performance:
1:04.1 total time
4.3 configuration
0.0 preparing main loop
0.0 moving elements to ocean
59.8 main loop
0.6 updating elements
0.0 cleaning up
--------------------
===========================
Model: ShipDrift (OpenDrift version 1.14.7)
1000 active ShipObject particles (0 deactivated, 0 scheduled)
-------------------
Environment variables:
-----
land_binary_mask
1) global_landmask
-----
x_sea_water_velocity
y_sea_water_velocity
1) https://thredds.met.no/thredds/dodsC/cmems/topaz6/dataset-topaz6-arc-15min-3km-be.ncml
2) https://thredds.met.no/thredds/dodsC/cmems/mywavewam3km/dataset-wam-arctic-1hr3km-be.ncml
-----
x_wind
y_wind
1) https://thredds.met.no/thredds/dodsC/mepslatest/meps_lagged_6_h_latest_2_5km_latest.nc
-----
sea_surface_wave_mean_period_from_variance_spectral_density_second_frequency_moment
sea_surface_wave_significant_height
sea_surface_wave_stokes_drift_x_velocity
sea_surface_wave_stokes_drift_y_velocity
1) https://thredds.met.no/thredds/dodsC/cmems/mywavewam3km/dataset-wam-arctic-1hr3km-be.ncml
Discarded readers:
Time:
Start: 2025-12-16 13:50:19.853614 UTC
Present: 2025-12-17 13:50:19.853614 UTC
Calculation steps: 24 * 1:00:00 - total time: 1 day, 0:00:00
Output steps: 25 * 1:00:00
===========================
13:51:57 INFO opendrift:4660: Saving animation to /root/project/docs/source/gallery/animations/example_shipdrift_0.gif...
13:52:16 INFO opendrift:3094: Time to make animation: 0:00:20.468649
Total running time of the script: (2 minutes 7.203 seconds)