1 | ====================== |
---|
2 | Explore the test cases |
---|
3 | ====================== |
---|
4 | |
---|
5 | The description below is a brief description of the test cases available in NEMO. |
---|
6 | For detailed description and notebook, the reader is directed on the `Github repository`_ |
---|
7 | |
---|
8 | .. _Github repository: https://github.com/sflavoni/NEMO-test-cases/ |
---|
9 | |
---|
10 | ICEDYN |
---|
11 | ====== |
---|
12 | |
---|
13 | This test case illustrates the advection of an ice patch across a East/West and North/South periodic channel. |
---|
14 | This configuration can be used to test the advection of the ice patch in an AGRIF zoom (1:3) |
---|
15 | and across the AGRIF boundary or to test the ice advection schemes (Prather and Ultimate-Macho). |
---|
16 | In the latest case user need to remove ``key_agrif`` out of the CPP keys list. |
---|
17 | |
---|
18 | .. image:: _static/ICEDYN_UDIAG_43days_UM5.gif |
---|
19 | |
---|
20 | VORTEX |
---|
21 | ====== |
---|
22 | |
---|
23 | This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. |
---|
24 | It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. |
---|
25 | It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012) :cite:`DEBREU2012`, |
---|
26 | Penven et al. (2006) :cite:`PENVEN2006` or Spall and Holland (1991) :cite:`SPALL1991`. |
---|
27 | |
---|
28 | The animation below (sea level anomaly in meters) illustrates with two 1:2 successively nested grids how |
---|
29 | the vortex smoothly propagates out of the refined grids. |
---|
30 | |
---|
31 | .. image:: _static/VORTEX_anim.gif |
---|
32 | |
---|
33 | ISOMIP |
---|
34 | ====== |
---|
35 | |
---|
36 | The purpose of this test case is to evaluate the impact of various schemes and new development with the iceshelf cavities circulation and melt. |
---|
37 | 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`. |
---|
38 | The default setup is the one described `here <http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf>`_. |
---|
39 | |
---|
40 | The figure below (meridional overturning circulation) illustrates the circulation generated after 10000 days by the ice shelf melting (ice pump). |
---|
41 | |
---|
42 | .. image:: _static/ISOMIP_moc.png |
---|
43 | |
---|
44 | LOCK_EXCHANGE |
---|
45 | ============= |
---|
46 | |
---|
47 | The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted |
---|
48 | by Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` for testing advection schemes in ocean circulation models. |
---|
49 | It has been used by several authors including Burchard and Bolding (2002) :cite:`BURCHARD2002` and Ilicak et al. (2012) :cite:`ILICAK2012`. |
---|
50 | The LOCK EXCHANGE experiment can in particular illustrate the impact of different choices of numerical schemes |
---|
51 | and/or subgrid closures on spurious interior mixing. |
---|
52 | |
---|
53 | Below the animation of the LOCK_EXCHANGE test case using the advection scheme FCT4 (forth order) for tracer and ubs for dynamics. |
---|
54 | |
---|
55 | .. image:: _static/LOCK-FCT4_flux_ubs.gif |
---|
56 | |
---|
57 | OVERFLOW |
---|
58 | ======== |
---|
59 | |
---|
60 | The OVERFLOW experiment illustrates the impact of different choices of numerical schemes |
---|
61 | and/or subgrid closures on spurious interior mixing close to bottom topography. |
---|
62 | The OVERFLOW experiment is adapted from the non-rotating overflow configuration described |
---|
63 | in Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` and further used by Ilicak et al. (2012) :cite:`ILICAK2012`. |
---|
64 | Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and fortht-order FCT4, z-coordinate and sigma coordinate (...). |
---|
65 | |
---|
66 | Below the animation of the OVERFLOW test case in sigma coordinate with the forth-order advection scheme FCT4. |
---|
67 | |
---|
68 | .. image:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif |
---|
69 | |
---|
70 | WAD |
---|
71 | === |
---|
72 | |
---|
73 | A set of simple closed basin geometries for testing the Wetting and drying capabilities. |
---|
74 | Examples range from a closed channel with EW linear bottom slope to a parabolic EW channel with a Gaussian ridge. |
---|
75 | |
---|
76 | 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. |
---|
77 | 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. |
---|
78 | The parameters are chosen such that the surge rises above sea-level before falling back and oscillating towards an equilibrium position |
---|
79 | |
---|
80 | .. image:: _static/wad_testcase_7.gif |
---|
81 | |
---|
82 | CANAL |
---|
83 | ===== |
---|
84 | |
---|
85 | East-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex). |
---|
86 | |
---|
87 | .. image::_static/CANAL_image.gif |
---|
88 | |
---|
89 | ================== |
---|
90 | Compile test cases |
---|
91 | ================== |
---|
92 | The compilation of the test cases is very similar to the manner the reference configurations are compiled. |
---|
93 | If you are not familiar on how to compile NEMO, it is first recomended to read the instruction |
---|
94 | `here <http://forge.ipsl.jussieu.fr/nemo/wiki/Users/ModelInstall>`_ |
---|
95 | |
---|
96 | | 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. |
---|
97 | |
---|
98 | | 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: |
---|
99 | |
---|
100 | .. code-block:: console |
---|
101 | |
---|
102 | $ ./makenemo -n WAD2 -a WAD -m macport_osx -j 4 |
---|
103 | |
---|
104 | ===================================== |
---|
105 | Run and analyse the test cases |
---|
106 | ===================================== |
---|
107 | There no requirement of specific input file for the test_cases presented here. The XIOS xml input files and namelist are already setup correctly. |
---|
108 | All the detailed on how to run a specific test cases and Jupyter notebook are available on github `here <https://github.com/sflavoni/NEMO-test-cases>`_. |
---|
109 | |
---|
110 | ========== |
---|
111 | References |
---|
112 | ========== |
---|
113 | |
---|
114 | .. bibliography:: test_cases.bib |
---|
115 | :all: |
---|
116 | :style: unsrt |
---|