ROMS.jl

<!-- [](https://ci.appveyor.com/project/Alexander-Barth/roms-jl) -->

<!-- [](https://alexander-barth.github.io/ROMS.jl/stable/) -->

[!TIP] For the participants to the JuliaEO Global Workshop on Earth Observation with Julia 2025, the notebooks are available here.

Installation

ROMS.jl requires julia 1.9 or later. Install ROMS.jl with the folling command executed in a julia shell:

using Pkg
Pkg.add(url="https://github.com/Alexander-Barth/ROMS.jl", rev="master")

Data sources

The following data sources have been tested:

• Bathymetry
  • GEBCO
• Initial and boundary condition from:
  • CMEMS
  • HYCOM GOFS
• Atmospheric forcings:
  • ECMWF:
    • Operational forecasts (obtained from the python ECMWF API)
    • ERA 5 (obtained from the Climate Data store using CDSAPI.jl)
  • GFS from the NCAR Research Data Archive

Download scripts for ECMWF data are in examples.

Contributions to add other data sources are welcome!

Documentation

Documentation is available here.

Credits

Thanks to Hernan G. Arango and John Wilkin from the ROMS/TOMS Group for the matlab scripts to process the ECMWF fields and vertical coordinate transformations (released under a MIT/X style license) and Pierrick Penven for the matlab script allowing to smooth the bathymetry (released under the GPL).