source: NEMO/trunk/tests/README.rst @ 11734

Last change on this file since 11734 was 11734, checked in by nicolasmartin, 15 months ago

Review README for reference confgiurations

File size: 6.7 KB
Line 
1**********************
2Explore the test cases
3**********************
4
5.. todo::
6
7
8
9The complete and up-to-date set of test cases is available on
10`NEMO test cases Github repository <http://github.com/NEMO-ocean/NEMO-examples>`_.
11
12Download it directly in the ``./tests`` root directory with
13
14.. code-block:: console
15
16   $ git clone http://github.com/NEMO-ocean/NEMO-examples
17
18.. contents::
19   :local:
20
21Procedure
22=========
23
24Compile test cases
25------------------
26
27The compilation of the test cases is very similar to the manner the reference configurations are compiled.
28If you are not familiar on how to compile NEMO, it is first recomended to read :doc:`the instructions <install>`
29
30| In the same manner as the ref. cfg are compiled with '-r' option, test cases can be compile by the use of makenemo with '-a' option.
31| Here an example to compile a copy named WAD2 of the wetting and drying test case (WAD) on the macport_osx architecture on 4 cores:
32
33.. code-block:: console
34
35   $ ./makenemo -n 'WAD2' -a 'WAD' -m 'macport_osx' -j '4'
36
37Run and analyse the test cases
38------------------------------
39
40There no requirement of specific input file for the test_cases presented here. The XIOS xml input files and namelist are already setup correctly.
41For detailed description and Jupyter notebook, the reader is directed on
42the `NEMO test cases repository <http://github.com/NEMO-ocean/NEMO-examples>`_
43
44The description below is a brief advertisement of some test cases.
45
46ICE_AGRIF
47=========
48
49  This test case illustrates the advection of an ice patch across an East/West and North/South periodic channel
50  over a slab ocean (i.e. one ocean layer), and with an AGRIF zoom (1:3) in the center
51  The purpose of this configuration is to test the advection of the ice patch in
52  and across the AGRIF boundary
53  One can either impose ice velocities or ice-atm. stresses and let rheology define velocities
54  (see README for details)
55
56  .. image:: _static/ICE_AGRIF_UDIAG_43days_UM5.gif
57
58VORTEX
59======
60
61  This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom.
62  It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates.
63  It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012) :cite:`DEBREU2012`,
64  Penven et al. (2006) :cite:`PENVEN2006` or Spall and Holland (1991) :cite:`SPALL1991`.
65
66  The animation below (sea level anomaly in meters) illustrates with two 1:2 successively nested grids how
67  the vortex smoothly propagates out of the refined grids.
68
69  .. image:: _static/VORTEX_anim.gif
70
71ISOMIP
72======
73
74  The purpose of this test case is to evaluate the impact of various schemes and new development with the iceshelf cavities circulation and melt.
75  This configuration served as initial assesment of the ice shelf module in Losh et al. (2008) :cite:`LOSCH2008` and Mathiot et al. (2017) :cite:`MATHIOT2017`.
76  The default setup is the one described `here <http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf>`_.
77
78  The figure below (meridional overturning circulation) illustrates the circulation generated after 10000 days by the ice shelf melting (ice pump).
79
80  .. image:: _static/ISOMIP_moc.png
81
82LOCK_EXCHANGE
83=============
84
85  The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted
86  by Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` for testing advection schemes in ocean circulation models.
87  It has been used by several authors including Burchard and Bolding (2002) :cite:`BURCHARD2002` and Ilicak et al. (2012) :cite:`ILICAK2012`.
88  The LOCK EXCHANGE experiment can in particular illustrate the impact of different choices of numerical schemes
89  and/or subgrid closures on spurious interior mixing.
90
91  Below the animation of the LOCK_EXCHANGE test case using the advection scheme FCT4 (forth order) for tracer and ubs for dynamics.
92
93  .. image:: _static/LOCK-FCT4_flux_ubs.gif
94
95OVERFLOW
96========
97
98  The OVERFLOW experiment illustrates the impact of different choices of numerical schemes
99  and/or subgrid closures on spurious interior mixing close to bottom topography.
100  The OVERFLOW experiment is adapted from the non-rotating overflow configuration described
101  in Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` and further used by Ilicak et al. (2012) :cite:`ILICAK2012`.
102  Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and fortht-order FCT4, z-coordinate and sigma coordinate (...).
103
104  Below the animation of the OVERFLOW test case in sigma coordinate with the forth-order advection scheme FCT4.
105
106  .. image:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif
107
108WAD
109===
110
111  A set of simple closed basin geometries for testing the Wetting and drying capabilities.
112  Examples range from a closed channel with EW linear bottom slope to a parabolic EW channel with a Gaussian ridge.
113
114  Below the animation of the test case 7. This test case is a simple linear slope with a mid-depth shelf with an open boundary forced with a sinusoidally varying ssh.
115  This test case has been introduced to emulate a typical coastal application with a tidally forced open boundary with an adverse SSH gradient that, when released, creates a surge up the slope.
116  The parameters are chosen such that the surge rises above sea-level before falling back and oscillating towards an equilibrium position
117
118  .. image:: _static/wad_testcase_7.gif
119
120CANAL
121=====
122
123  East-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex).
124
125  .. image::_static/CANAL_image.gif
126
127ICE_ADV2D
128=========
129
130  This test case illustrates the advection of an ice patch across an East/West and North/South periodic channel
131  over a slab ocean (i.e. one ocean layer).
132  The configuration is similar to ICE_AGRIF, except for the AGRIF zoom.
133  The purpose of this configuration is to test the advection schemes available in the sea-ice code
134  (for now, Prather and Ultimate-Macho from 1st to 5th order),
135  especially the occurence of overshoots in ice thickness
136
137
138ICE_ADV1D
139=========
140
141  This experiment is the classical Schar & Smolarkiewicz (1996) test case :cite:`SCHAR1996`,
142  which has been used in :cite:`LIPSCOMB2004`,
143  and in which very specific shapes of ice concentration, thickness and volume converge toward the center of a basin.
144  Convergence is unidirectional (in x) while fields are homogeneous in y.
145  The purpose of this configuration is to test the caracteristics of advection schemes available in the sea-ice code
146  (for now, Prather and Ultimate-Macho from 1st to 5th order),
147  especially the constitency between concentration, thickness and volume, and the preservation of initial shapes.
148
149.. rubric:: References
150
151.. bibliography:: tests.bib
152   :all:
153   :style: unsrt
154   :labelprefix: T
Note: See TracBrowser for help on using the repository browser.