1 | |
---|
2 | # NEMO Tests Cases |
---|
3 | |
---|
4 | ## Description of tests cases available with NEMO |
---|
5 | |
---|
6 | ### ICE_AGRIF |
---|
7 | |
---|
8 | This test case illustrates the advection of an ice patch across an East/West and North/South periodic channel |
---|
9 | over a slab ocean (i.e. one ocean layer), and with an AGRIF zoom (1:3) in the center |
---|
10 | The purpose of this configuration is to test the advection of the ice patch in |
---|
11 | and across the AGRIF boundary |
---|
12 | One can either impose ice velocities or ice-atm. stresses and let rheology define velocities |
---|
13 | (see README for details) |
---|
14 | |
---|
15 | ![U diag ICE_AGRIF](ICE_AGRIF/MY_DOCS/ICE_AGRIF_UDIAG_43days_UM5.gif) |
---|
16 | |
---|
17 | ### VORTEX |
---|
18 | |
---|
19 | This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. |
---|
20 | It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. |
---|
21 | It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012) :cite:`DEBREU2012`, |
---|
22 | Penven et al. (2006) :cite:`PENVEN2006` or Spall and Holland (1991) :cite:`SPALL1991`. |
---|
23 | |
---|
24 | The animation below (sea level anomaly in meters) illustrates with two 1:2 successively nested grids how |
---|
25 | the vortex smoothly propagates out of the refined grids. |
---|
26 | |
---|
27 | ![VORTEX anim](VORTEX/MY_DOCS/VORTEX_anim.gif) |
---|
28 | |
---|
29 | ### ISOMIP |
---|
30 | |
---|
31 | |
---|
32 | The purpose of this test case is to evaluate the impact of various schemes and new development with the iceshelf cavities circulation and melt. |
---|
33 | 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`. |
---|
34 | The default setup is the one described `here <http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf>`_. |
---|
35 | |
---|
36 | The figure below (meridional overturning circulation) illustrates the circulation generated after 10000 days by the ice shelf melting (ice pump). |
---|
37 | |
---|
38 | ![ISOMIP moc](ISOMIP/MY_DOCS/ISOMIP_moc.png) |
---|
39 | |
---|
40 | ### LOCK_EXCHANGE |
---|
41 | |
---|
42 | |
---|
43 | The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted |
---|
44 | by Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` for testing advection schemes in ocean circulation models. |
---|
45 | It has been used by several authors including Burchard and Bolding (2002) :cite:`BURCHARD2002` and Ilicak et al. (2012) :cite:`ILICAK2012`. |
---|
46 | The LOCK EXCHANGE experiment can in particular illustrate the impact of different choices of numerical schemes |
---|
47 | and/or subgrid closures on spurious interior mixing. |
---|
48 | |
---|
49 | Below the animation of the LOCK_EXCHANGE test case using the advection scheme FCT4 (forth order) for tracer and ubs for dynamics. |
---|
50 | |
---|
51 | .. image:: _static/LOCK-FCT4_flux_ubs.gif |
---|
52 | |
---|
53 | ### OVERFLOW |
---|
54 | |
---|
55 | |
---|
56 | The OVERFLOW experiment illustrates the impact of different choices of numerical schemes |
---|
57 | and/or subgrid closures on spurious interior mixing close to bottom topography. |
---|
58 | The OVERFLOW experiment is adapted from the non-rotating overflow configuration described |
---|
59 | in Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` and further used by Ilicak et al. (2012) :cite:`ILICAK2012`. |
---|
60 | Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and fortht-order FCT4, z-coordinate and sigma coordinate (...). |
---|
61 | |
---|
62 | Below the animation of the OVERFLOW test case in sigma coordinate with the forth-order advection scheme FCT4. |
---|
63 | <img src="./OVERFLOW/figures/OVF-sco_FCT4_flux_cen-ahm1000.gif"> |
---|
64 | .. image:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif |
---|
65 | |
---|
66 | ### WAD |
---|
67 | |
---|
68 | A set of simple closed basin geometries for testing the Wetting and drying capabilities. |
---|
69 | Examples range from a closed channel with EW linear bottom slope to a parabolic EW channel with a Gaussian ridge. |
---|
70 | |
---|
71 | 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. |
---|
72 | 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. |
---|
73 | The parameters are chosen such that the surge rises above sea-level before falling back and oscillating towards an equilibrium position |
---|
74 | |
---|
75 | .. image:: _static/wad_testcase_7.gif |
---|
76 | |
---|
77 | ### CANAL |
---|
78 | |
---|
79 | East-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex). |
---|
80 | |
---|
81 | .. image::_static/CANAL_image.gif |
---|
82 | |
---|
83 | ### ICE_ADV2D |
---|
84 | |
---|
85 | |
---|
86 | This test case illustrates the advection of an ice patch across an East/West and North/South periodic channel |
---|
87 | over a slab ocean (i.e. one ocean layer). |
---|
88 | The configuration is similar to ICE_AGRIF, except for the AGRIF zoom. |
---|
89 | The purpose of this configuration is to test the advection schemes available in the sea-ice code |
---|
90 | (for now, Prather and Ultimate-Macho from 1st to 5th order), |
---|
91 | especially the occurence of overshoots in ice thickness |
---|
92 | |
---|
93 | |
---|
94 | ### ICE_ADV1D |
---|
95 | |
---|
96 | |
---|
97 | This experiment is the classical Schar & Smolarkiewicz (1996) test case :cite:`SCHAR1996`, |
---|
98 | which has been used in :cite:`LIPSCOMB2004`, |
---|
99 | and in which very specific shapes of ice concentration, thickness and volume converge toward the center of a basin. |
---|
100 | Convergence is unidirectional (in x) while fields are homogeneous in y. |
---|
101 | The purpose of this configuration is to test the caracteristics of advection schemes available in the sea-ice code |
---|
102 | (for now, Prather and Ultimate-Macho from 1st to 5th order), |
---|
103 | especially the constitency between concentration, thickness and volume, and the preservation of initial shapes. |
---|
104 | |
---|
105 | |
---|
106 | ### SEAMOUNT |
---|
107 | This experiment is the Beckmann and Haidvogel (1993) SEAMOUNT test case :cite:`BECKMANN1993`. It is a Gaussian bump in |
---|
108 | an East-West periodic channel initialised at rest with a horizontally uniform, exponential vertical density profile. |
---|
109 | The domain is defined by a terrain-following coordinate. The purpose of this configuration is to demonstrate |
---|
110 | the relative performance of various hpg schemes in reducing the spurious velocities generated due to numerical |
---|
111 | errors arising from the misalignment the grid s-level with the pure z-level. |
---|
112 | |
---|
113 | ## How to run these test cases |
---|
114 | The complete and up-to-date set of test cases is available [on this NEMO test cases Github repository](http://github.com/NEMO-ocean/NEMO-examples). |
---|
115 | |
---|
116 | Download it directly in the ``./tests`` root directory using following command: |
---|
117 | ``` |
---|
118 | git clone http://github.com/NEMO-ocean/NEMO-examples |
---|
119 | ``` |
---|
120 | Once downloaded, the test case can be compiled and run as any other NEMO confiuration, see the "Buid the frameowrk section [here](https://forge.ipsl.jussieu.fr/nemo/chrome/site/doc/NEMO/guide/html/NEMO_guide.html) |
---|
121 | |
---|
122 | ## Exploring the results of a test case |
---|
123 | Each test case subdirectory includes some plots and/or pythin notebook discribing the expercted results, possible sensitivuty tests, etc.. |
---|
124 | |
---|
125 | ## How to contribute and add new demontration case : |
---|
126 | |
---|
127 | To propose a test case contribution, you need to build up its directory including: |
---|
128 | * a README.md including |
---|
129 | * Detailed desscription of the test case: goal and results |
---|
130 | * Author as contact person |
---|
131 | * The release/revision number of NEMO on which this tests case is working |
---|
132 | * Published document to quote as reference for the test case |
---|
133 | * All the input files or the program to build them |
---|
134 | * Some outputs and/or figures from the results, to demonstrate the interest and capabilities of the test case |
---|
135 | * Hopefully a python notebook to run the test case and produce the results |
---|
136 | |
---|
137 | This directory should then be sent as a pull request to this github repository |
---|
138 | |
---|
139 | <!--- Comments for now |
---|
140 | using the follwing procedure ("NEWONE" to be substituted as the test case name below): |
---|
141 | ``` |
---|
142 | git clone http://github.com/NEMO-ocean/NEMO-examples # Get the master branch of test cases |
---|
143 | ``` |
---|
144 | In your local copy of the branch, add the "NEWONE" directory for your additional test case, containing the material described above |
---|
145 | |
---|
146 | Add it in the github repository: |
---|
147 | ``` |
---|
148 | git branch "new branch name" # Create the new branch "new branch name" on github |
---|
149 | git add "NEWONE" # Add "NEWONE" test case into it |
---|
150 | git commit -m "add NEWONE test case" # Commit this addition |
---|
151 | git pull # Send it to github repository |
---|
152 | ``` |
---|
153 | ---!> |
---|
154 | |
---|
155 | |
---|
156 | |
---|
157 | |
---|