Skip to content

Release Notes

This page contains the release notes for all available SURF-NEMO versions, ordered by release date (from latest to oldest).

v2.0.0 — 2025-06-11 latest

  • Rewrote the SURF code using a modular, object-oriented Python architecture, replacing the previous procedural design.
  • The structured and unstructured components (SURF-NEMO and SURF-SHYFEM) have been unified under common conventions, workflow and execution frameworks
  • Created Docker image designed for seamless installation, execution and cloud/HPC deployment
  • Added automatic download of all the required input data, including CMEMS ocean data (via Copernicus Marine Toolbox), ERA5 atmospheric data (via CDSAPI service) and TPXO8 tidal forcing, GEBCO-2024 bathymetry and GSHHG coastlines.
  • Upgraded NEMO to latest version (5.0 beta).
  • Updated key default schemes, for vertical mixing (Turbulent Kinetic Energy scheme), Vertical coordinate system (z-star coordinates), Horizontal tracer advection (4th order Flux-Corrected Transport scheme).

v1.02 — 2023-17-01

  • Added SLURM/LSF job script templates to enable direct submission of experiments on HPC systems.
  • Added run_getCMEMSdata.py utility script to automatically download CMEMS data via the MOTU API.
  • Added Python scripts for data visualization and analysis using matplotlib and cartopy.
  • Improved extrapolation procedures to handle datasets with NaN values in the final vertical level.
  • Rewrote the main run_exp workflow script from Julia to Python programming language.

v1.01 — 2020-11-08

  • Added regridding functionality for barotropic tide fields (elevation, zonal, and meridional velocity) in run_regriddataTideBC.jl.
  • Implemented tide extraction at lateral open boundaries, also handled in run_regriddataTideBC.jl.
  • Added functionality for rotating ocean velocity components when the parent model is defined on a distorted curvilinear spherical grid. This feature includes the new utilities rotateUV and interpUV in the utilities directory.
  • Introduced several new parameters in the configuration file setParFree.json for additional model flexibility.
  • Split the original main.ncl procedure into five independent macrotasks
  • Rewrote several procedures from the NCL (NCAR Command Language) to Julia, improving performance and simplifying the codebase.

v1.00 — 2019-03-01

This is the first release of the surf_nemo package.