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