Test Cases
ROMS is distributed with several idealized and realistic applications that can be used for testing, benchmarking, process-oriented studies, accuracy of numerical algorithms, learning and training, and ocean modeling experimentation. They can also be used to evaluate the efficiency, accuracy, and robustness of its numerical and physical algorithms against the solutions produced by other ocean modeling systems. Analytical or semi-analytical solutions exist for some of these test cases and few metrics/scores can be computed to assess model skill. You can obtain these test cases from the repository. This repository gives you guidelines on how to configure and setup your own application. Each example provides all the necessary scripts to compile/link (build script) and run each ROMS test case.
test/ Main test directory
/DAMEE_4/ North Atlantic DAMEE, 3/4° resolution
/Data/ Input data directory
/netcdf3 Input data, classic NetCDF format
/netcdf4 Input data, NetCDF-4/HDF5 format
/scoord11 Vertical coordinates: Vtransform=1, Vstretching=1
/scoord22 Vertical coordinates: Vtransform=2, Vstretching=2
/External Variable info files common to all tests
/WC13/ California Current System, 1/3° resolution
/ARRAY_MODES Array modes of representer matrix
/Data Input data directory
/Functionals Analytical functions
/I4DVAR Incremental strong constraint 4D-Var
/I4DVAR_analysis_impact I4DVAR observation impact analysis
/Normalization Error covariance model
/RBL4DVAR Restricted B-preconditioned Lanczos 4D-Var
/RBL4DVAR_analysis_impact RBL4DVAR observation impact analysis
/RBL4DVAR_analysis_sensitivity RBL4DVAR observation sensitivity analysis
/RBL4DVAR_forecast_impact RBL4DVAR forecast impact analysis
/RBL4DVAR_forecast_sensitivity RBL4DVAR forecast sensitivity analysis
/plotting Scripts to plot WC13 results
/basin Big Bad Basin test case
/benchmark Benchmark Tests (3 grid sizes)
/bio_toy/ One-dimensional (vertical) Biology Toy
/Data Input data directory
/bl_test Boundary Layers Test
/canyon Idealized 2D/3D Canyon
/channel/ Idealized Periodic Uniform Channel
/Data Input data directory
/Forward Nonlinear forward model
/OP GST: Optimal Pertubations
/dogbone/ Idealized Dog Bone Shaped closed basin
/Composite Composite grid nesting test
/Data Input data directory
/Refined Grid refinement nesting test
/Whole Single grid test (no nesting)
/double_gyre/ Generalized Stability Theory Tests
/AFTE Adjoint Finite Time Eigenmodes driver
/Data Input data directory
/FSV Forcing Singular Vector driver
/FTE Finite Time Eigenmodes driver
/Forward Nonlinear forward model
/OP Optimal Pertubations driver
/SOsemi Stochastic Optimals driver
/estuary_test Estuary with Sediment Transport Test
/flt_test Floats Tracking 2D/3D Test
/grav_adj Gravitational Adjustment Test
/inlet_test/ Waves-ocean (SWAN/ROMS) two-way coupling
/Data Input data directory
/kelvin Kelvin Wave Test
/lab_canyon Lab Canyon (polar coordinates) Test
/lake_jersey/ Lake Jersey Test for Nesting algorithms
/Data Input data directory
/Forward Nonlinear forward model
/Refined Refined grid applications
/lmd_test K-Profile Parameterization Test
/riverplume Two River Plume Tests
/seamount Seamount Test
/sed_test Suspended Sediment Test in a Channel
/shoreface/ Shore Face Planar Beach Test
/Data Input data directory
/soliton Equatorial Soliton 2D Test
/test_chan Sediment Test Channel Case
/test_head/ Sediment Test Headland Case
/Data Input data directory
/upwelling Wind-Driven Upwelling, Periodic Channel
/weddell Idealized Weddell Sea, Tides and Ice Shelf
/windbasin Wind-Driven Constant Coriolis Basin Test
Idealized Applications
Currently, there are several idealized applications in ROMS to test its algorithms. Most of these applications are initialized and forced with analytical expressions in Functionals. It is recommended for a novice user to run some of them to gain experience and explore ROMS capabilities.
- Process-oriented Applications
- Big Bad Basin
- Coastal Form Stress Canyon Test
- Gravitational Adjustment Test
- Kelvin Wave Test
- Lab Canyon Test, Polar Coordinates
- Gravitational/Overflow Test
- River Plume Test 1
- River plume Test 2 (Hyatt and Signell)
- Equatorial Rossby Wave Test
- Wind-Driven Upwelling/Downwelling over a Periodic Channel (default)
- Idealized Weddell Sea Shelf Application
- Linear Wind-driven Constant Coriolis Basin
- Algorithm Testing
- Adjoint-based Applications
- Nesting Applications
- DOGBONE: options for idealize nesting grids (Composite/Refinement) Test
- LAKE_JERSEY: options for lake Jersey nesting test case
- Sediment Applications
- ESTUARY_TEST: options for estuary with sediment (suspended) transport test
- LAKE_SIGNELL: options for closed basin (lake) forced with wind
- SED_TEST1: options for suspended sediment in a test channel
- SED_TOY: options for one-dimensional (vertical) sediment toy (empty)
- SHOREFACE: shore face planar beach test case (empty)
- TEST_CHAN: options for sediment test channel case
- TEST_HEAD: options for sediment test headland case
- Model Coupling
- COUPLING_TEST: options for atmosphere-ocean two-way coupling test
- INLET_TEST: options for inlet test case, waves-ocean (SWAN/ROMS) two-way coupling
- TEST_HEAD: options for sediment test headland case
- Benchmarks
Realistic Applications
- Ajoint-based Applications
- WC13: options for California current system, 1/3 degree resolution
- Climatological
- DAMEE_4: options for North Atlantic DAMEE application, 3/4 degree