Difference between revisions of "Test Cases"

From WikiROMS
Jump to navigationJump to search
 
(2 intermediate revisions by one other user not shown)
Line 2: Line 2:


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 [[Subversion|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|build script]]) and run each ROMS test case.
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 [[Subversion|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|build script]]) and run each ROMS test case.
<span class="twilightBlue">test/                                Main test directory
    /DAMEE_4/                        North Atlantic DAMEE, 3/4&deg; resolution
            /Data/                    Input data directory
                  /netcdf3            Input data, classic NetCDF format
                  /netcdf4            Input data, NetCDF-4/HDF5 format
            /scoord11                Vertical coordinates: [[Variables#Vtransform|Vtransform]]=1, [[Variables#Vstretching|Vstretching]]=1
            /scoord22                Vertical coordinates: [[Variables#Vtransform|Vtransform]]=2, [[Variables#Vstretching|Vstretching]]=2
   
   
     /External                         Variable info files common to all tests
<span class="twilightBlue">test/                                    Main test directory
    /DAMEE_4/                            North Atlantic DAMEE, 3/4&deg; resolution
            /Data/                      Input data directory
                  /netcdf3                Input data, classic NetCDF format
                  /netcdf4                Input data, NetCDF-4/HDF5 format
            /scoord11                    Vertical coordinates: [[Variables#Vtransform|Vtransform]]=1, [[Variables#Vstretching|Vstretching]]=1
            /scoord22                    Vertical coordinates: [[Variables#Vtransform|Vtransform]]=2, [[Variables#Vstretching|Vstretching]]=2
     /External                           Variable info files common to all tests
   
   
     /WC13/                           California Current System, 1/3&deg; resolution
     /WC13/                               California Current System, 1/3&deg; resolution
           /ARRAY_MODES                 Array modes of representer matrix
           /ARRAY_MODES                   Array modes of representer matrix
           /Data                       Input data directory
           /Data                           Input data directory
           /Functionals                 Analytical functions
           /Functionals                   Analytical functions
           /I4DVAR                     Incremental strong constraint 4D-Var
           /I4DVAR                         Incremental strong constraint 4D-Var
           /I4DVAR_impact              I4DVAR observation impact analysis
           /I4DVAR_analysis_impact        I4DVAR observation impact analysis
           /Normalization               Error covariance model
           /Normalization                 Error covariance model
           /PSAS                        Physical-space Statistical Analysis System
           /RBL4DVAR                      Restricted B-preconditioned Lanczos 4D-Var
           /PSAS_impact                PSAS observation impact analysis
           /RBL4DVAR_analysis_impact      RBL4DVAR observation impact analysis
           /PSAS_sensitivity            PSAS observation sensitivity analysis
           /RBL4DVAR_analysis_sensitivity  RBL4DVAR observation sensitivity analysis
           /R4DVAR                      Indirect representer 4D-Var
           /RBL4DVAR_forecast_impact      RBL4DVAR forecast impact analysis  
          /R4DVAR_impact              R4DVAR observation impact analysis
           /RBL4DVAR_forecast_sensitivity  RBL4DVAR forecast sensitivity analysis
           /R4DVAR_sensitivity          R4DVAR observation sensitivity analysis
           /plotting                       Scripts to plot WC13 results
           /plotting                   Scripts to plot WC13 results
   
   
     /basin                            Big Bad Basin test case
     /basin                            Big Bad Basin test case
Line 38: Line 37:
   
   
     /canyon                          Idealized 2D/3D Canyon
     /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
     /double_gyre/                    Generalized Stability Theory Tests
Line 56: Line 66:
     /inlet_test/                      Waves-ocean (SWAN/ROMS) two-way coupling
     /inlet_test/                      Waves-ocean (SWAN/ROMS) two-way coupling
                 /Data                  Input data directory
                 /Data                  Input data directory
                /Forward              Nonlinear forward model
                /Refined              Refined grid applications
 
     /kelvin                          Kelvin Wave Test
     /kelvin                          Kelvin Wave Test
   
   
     /lab_canyon                      Lab Canyon (polar coordinates) Test
     /lab_canyon                      Lab Canyon (polar coordinates) Test
 
     /lake_jersey/                    Lake Jersey Test for Nesting alorithms
     /lake_jersey/                    Lake Jersey Test for Nesting algorithms
                 /Data                Input data directory
                 /Data                Input data directory
                /Forward              Nonlinear forward model
                /Refined              Refined grid applications               
   
   
     /lmd_test                        K-Profile Parameterization Test
     /lmd_test                        K-Profile Parameterization Test
Line 92: Line 102:
==Idealized Applications==
==Idealized Applications==


Currently, there are several idealized applications in ROMS to test its algorithms.  Mostly all of these applications are initialized and forced with analytical expressions in [[Functionals]]. It is recommended to the beginner user to run some of them to gain experience and explore ROMS capabilities.
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'''
* '''Process-oriented Applications'''
Line 119: Line 129:
** [[A4DVAR_TOY_CASE | 4DVAR Data Assimilation Toy over a Periodic Channel]]
** [[A4DVAR_TOY_CASE | 4DVAR Data Assimilation Toy over a Periodic Channel]]
** [[DOUBLE_GYRE_CASE | Double-Gyre Test]]
** [[DOUBLE_GYRE_CASE | Double-Gyre Test]]
* '''Nesting Applications'''
** [[DOGBONE_TEST_CASE | DOGBONE]]: options for idealize nesting grids (Composite/Refinement) Test
** [[LAKE_JERSEY_CASE | LAKE_JERSEY]]: options for lake Jersey nesting test case


* '''Sediment Applications'''
* '''Sediment Applications'''
Line 138: Line 152:


==Realistic Applications==
==Realistic Applications==
* '''Ajoint-based Applications'''
** [[4DVar_Tutorial_Introduction | WC13]]: options for California current system, 1/3 degree resolution
* '''Climatological'''
** [[DAMEE_4_CASE | DAMEE_4]]: options for North Atlantic DAMEE application, 3/4 degree


==Contributed Applications==
==Contributed Applications==

Latest revision as of 16:10, 17 August 2020

ROMS/TOMS 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.

  • 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

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

Contributed Applications