[10279] | 1 | ********************** |
---|
[10186] | 2 | Explore the test cases |
---|
[10279] | 3 | ********************** |
---|
[10186] | 4 | |
---|
[11734] | 5 | .. todo:: |
---|
| 6 | |
---|
[11743] | 7 | CANAL animated gif is missing |
---|
[11734] | 8 | |
---|
[11735] | 9 | .. contents:: |
---|
| 10 | :local: |
---|
| 11 | :depth: 1 |
---|
[10605] | 12 | |
---|
[11735] | 13 | Installation |
---|
| 14 | ============ |
---|
[10605] | 15 | |
---|
[11735] | 16 | Download |
---|
| 17 | -------- |
---|
| 18 | |
---|
| 19 | | The complete and up-to-date set of test cases is available on |
---|
| 20 | :github:`NEMO test cases repository <NEMO-examples>`. |
---|
| 21 | | Download it directly into the :file:`./tests` root directory with |
---|
| 22 | |
---|
[10605] | 23 | .. code-block:: console |
---|
| 24 | |
---|
| 25 | $ git clone http://github.com/NEMO-ocean/NEMO-examples |
---|
| 26 | |
---|
[11735] | 27 | Compilation |
---|
| 28 | ----------- |
---|
[10279] | 29 | |
---|
[11735] | 30 | The compilation of the test cases is very similar to |
---|
| 31 | the manner the reference configurations are compiled. |
---|
| 32 | If you are not familiar on how to compile NEMO, |
---|
| 33 | it is first recomended to read :doc:`the instructions <install>`. |
---|
[10279] | 34 | |
---|
[11735] | 35 | | As the reference configurations are compiled with ``-r`` option, |
---|
| 36 | test cases can be compiled by the use of :file:`makenemo` with ``-a`` option. |
---|
| 37 | | Here an example to compile a copy named WAD2 of the wetting and drying test case (WAD): |
---|
[10186] | 38 | |
---|
[10605] | 39 | .. code-block:: console |
---|
| 40 | |
---|
[11735] | 41 | $ ./makenemo -n 'WAD2' -a 'WAD' -m 'my_arch' -j '4' |
---|
[10605] | 42 | |
---|
[11735] | 43 | Run and analysis |
---|
| 44 | ---------------- |
---|
[10605] | 45 | |
---|
[11735] | 46 | There no requirement of specific input file for the test_cases presented here. |
---|
| 47 | The XIOS xml input files and namelist are already setup correctly. |
---|
[10605] | 48 | For detailed description and Jupyter notebook, the reader is directed on |
---|
[11735] | 49 | the :github:`NEMO test cases repository <NEMO-examples>` |
---|
[10605] | 50 | |
---|
| 51 | The description below is a brief advertisement of some test cases. |
---|
| 52 | |
---|
[11735] | 53 | List of test cases |
---|
| 54 | ================== |
---|
| 55 | |
---|
[10554] | 56 | ICE_AGRIF |
---|
[11735] | 57 | --------- |
---|
[11723] | 58 | |
---|
[11735] | 59 | .. figure:: _static/ICE_AGRIF_UDIAG_43days_UM5.gif |
---|
| 60 | :width: 200px |
---|
| 61 | :align: left |
---|
[10201] | 62 | |
---|
[11735] | 63 | .. |
---|
[10201] | 64 | |
---|
[11735] | 65 | | This test case illustrates the advection of an ice patch across |
---|
| 66 | an East/West and North/South periodic channel over a slab ocean (i.e. one ocean layer), |
---|
| 67 | and with an AGRIF zoom (1:3) in the center. |
---|
| 68 | | The purpose of this configuration is to |
---|
| 69 | test the advection of the ice patch in and across the AGRIF boundary. |
---|
| 70 | One can either impose ice velocities or ice-atm. |
---|
| 71 | Stresses and let rheology define velocities (see :file:`README` for details) |
---|
| 72 | |
---|
[10204] | 73 | VORTEX |
---|
[11735] | 74 | ------ |
---|
[11723] | 75 | |
---|
[11735] | 76 | .. figure:: _static/VORTEX_anim.gif |
---|
| 77 | :width: 200px |
---|
| 78 | :align: right |
---|
[11723] | 79 | |
---|
[11735] | 80 | .. |
---|
[11723] | 81 | |
---|
[11735] | 82 | This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. |
---|
| 83 | It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. |
---|
| 84 | It serves as a benchmark for quantitative estimates of nesting errors as in :cite:`DEBREU2012`, |
---|
| 85 | :cite:`PENVEN2006` or :cite:`SPALL1991`. |
---|
[10201] | 86 | |
---|
[11735] | 87 | The animation (sea level anomaly in meters) illustrates with |
---|
| 88 | two 1:2 successively nested grids how the vortex smoothly propagates out of the refined grids. |
---|
| 89 | |
---|
[10204] | 90 | ISOMIP |
---|
[11735] | 91 | ------ |
---|
[10201] | 92 | |
---|
[11735] | 93 | .. figure:: _static/ISOMIP_moc.png |
---|
| 94 | :width: 200px |
---|
| 95 | :align: left |
---|
[11723] | 96 | |
---|
[11735] | 97 | .. |
---|
[10201] | 98 | |
---|
[11735] | 99 | | The purpose of this test case is to evaluate the impact of various schemes and new development with |
---|
| 100 | the iceshelf cavities circulation and melt. |
---|
| 101 | This configuration served as initial assesment of the ice shelf module in :cite:`LOSCH2008` and |
---|
| 102 | :cite:`MATHIOT2017`. |
---|
| 103 | The default setup is the one described |ISOMIP|_. |
---|
| 104 | | The figure (meridional overturning circulation) illustrates |
---|
| 105 | the circulation generated after 10000 days by the ice shelf melting (ice pump). |
---|
[10204] | 106 | |
---|
[11735] | 107 | .. |ISOMIP| replace:: here |
---|
| 108 | |
---|
[10204] | 109 | LOCK_EXCHANGE |
---|
[11735] | 110 | ------------- |
---|
[10204] | 111 | |
---|
[11735] | 112 | .. figure:: _static/LOCK-FCT4_flux_ubs.gif |
---|
| 113 | :width: 200px |
---|
| 114 | :align: right |
---|
[10204] | 115 | |
---|
[11735] | 116 | .. |
---|
[10240] | 117 | |
---|
[11735] | 118 | | The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted |
---|
| 119 | by :cite:`HAIDVOGEL1999` for testing advection schemes in ocean circulation models. |
---|
| 120 | It has been used by several authors including :cite:`BURCHARD2002` and :cite:`ILICAK2012`. |
---|
| 121 | The LOCK EXCHANGE experiment can in particular illustrate |
---|
| 122 | the impact of different choices of numerical schemes and/or subgrid closures on |
---|
| 123 | spurious interior mixing. |
---|
| 124 | | Here the animation of the LOCK_EXCHANGE test case using |
---|
| 125 | the advection scheme FCT4 (forth order) for tracer and ubs for dynamics. |
---|
[10204] | 126 | |
---|
| 127 | OVERFLOW |
---|
[11735] | 128 | -------- |
---|
[10204] | 129 | |
---|
[11735] | 130 | .. figure:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif |
---|
| 131 | :width: 200px |
---|
| 132 | :align: left |
---|
[10204] | 133 | |
---|
[11735] | 134 | .. |
---|
[10240] | 135 | |
---|
[11735] | 136 | | The OVERFLOW experiment illustrates the impact of different choices of numerical schemes and/or |
---|
| 137 | subgrid closures on spurious interior mixing close to bottom topography. |
---|
| 138 | The OVERFLOW experiment is adapted from the non-rotating overflow configuration described in |
---|
| 139 | :cite:`HAIDVOGEL1999` and further used by :cite:`ILICAK2012`. |
---|
| 140 | Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and |
---|
| 141 | forth-order FCT4, z-coordinate and sigma coordinate (...). |
---|
| 142 | | Here the animation of the OVERFLOW test case in sigma coordinate with |
---|
| 143 | the forth-order advection scheme FCT4. |
---|
[10204] | 144 | |
---|
| 145 | WAD |
---|
[11735] | 146 | --- |
---|
[10204] | 147 | |
---|
[11735] | 148 | .. figure:: _static/wad_testcase_7.gif |
---|
| 149 | :width: 200px |
---|
| 150 | :align: right |
---|
[11723] | 151 | |
---|
[11735] | 152 | .. |
---|
[10204] | 153 | |
---|
[11735] | 154 | | A set of simple closed basin geometries for testing the Wetting and drying capabilities. |
---|
| 155 | Examples range from a closed channel with EW linear bottom slope to |
---|
| 156 | a parabolic EW channel with a Gaussian ridge. |
---|
| 157 | | Here the animation of the test case 7. |
---|
| 158 | This test case is a simple linear slope with a mid-depth shelf with |
---|
| 159 | an open boundary forced with a sinusoidally varying ssh. |
---|
| 160 | This test case has been introduced to emulate a typical coastal application with |
---|
| 161 | a tidally forced open boundary with an adverse SSH gradient that, |
---|
| 162 | when released, creates a surge up the slope. |
---|
| 163 | The parameters are chosen such that |
---|
| 164 | the surge rises above sea-level before falling back and oscillating towards an equilibrium position. |
---|
[10204] | 165 | |
---|
[10240] | 166 | CANAL |
---|
[11735] | 167 | ----- |
---|
[10240] | 168 | |
---|
[11735] | 169 | .. figure:: _static/CANAL_image.gif |
---|
| 170 | :width: 200px |
---|
| 171 | :align: left |
---|
[10240] | 172 | |
---|
[11735] | 173 | .. |
---|
[10240] | 174 | |
---|
[11735] | 175 | East-west periodic canal of variable size with several initial states and |
---|
| 176 | associated geostrophic currents (zonal jets or vortex). |
---|
| 177 | |
---|
[10554] | 178 | ICE_ADV2D |
---|
[11735] | 179 | --------- |
---|
[11723] | 180 | |
---|
[11735] | 181 | | This test case illustrates the advection of an ice patch across |
---|
| 182 | an East/West and North/South periodic channel over a slab ocean (i.e. one ocean layer). |
---|
[10554] | 183 | The configuration is similar to ICE_AGRIF, except for the AGRIF zoom. |
---|
[11735] | 184 | | The purpose of this configuration is to test the advection schemes available in the sea-ice code |
---|
[10554] | 185 | (for now, Prather and Ultimate-Macho from 1st to 5th order), |
---|
| 186 | especially the occurence of overshoots in ice thickness |
---|
| 187 | |
---|
| 188 | ICE_ADV1D |
---|
[11735] | 189 | --------- |
---|
[11723] | 190 | |
---|
[11735] | 191 | | This experiment is the classical :cite:`SCHAR1996` test case , |
---|
| 192 | which has been used in :cite:`LIPSCOMB2004`, and in which very specific shapes of ice concentration, |
---|
| 193 | thickness and volume converge toward the center of a basin. |
---|
[10554] | 194 | Convergence is unidirectional (in x) while fields are homogeneous in y. |
---|
[11735] | 195 | | The purpose of this configuration is to |
---|
| 196 | test the caracteristics of advection schemes available in the sea-ice code |
---|
[10554] | 197 | (for now, Prather and Ultimate-Macho from 1st to 5th order), |
---|
[11735] | 198 | especially the constitency between concentration, thickness and volume, |
---|
| 199 | and the preservation of initial shapes. |
---|
[10554] | 200 | |
---|
[11723] | 201 | .. rubric:: References |
---|
[10240] | 202 | |
---|
[11723] | 203 | .. bibliography:: tests.bib |
---|
| 204 | :all: |
---|
| 205 | :style: unsrt |
---|
| 206 | :labelprefix: T |
---|
[13207] | 207 | |
---|
| 208 | CPL_OASIS |
---|
| 209 | --------- |
---|
| 210 | | This test case checks the OASIS interface in OCE/SBC, allowing to set up |
---|
| 211 | a coupled configuration through OASIS. See CPL_OASIS/README.md for more information. |
---|
[14225] | 212 | |
---|
| 213 | TSUNAMI |
---|
| 214 | --------- |
---|
| 215 | | just use dynspg_ts to simulate the propagation of an ssh anomaly (cosinus) in a box configuration |
---|
| 216 | with flat bottom and jpk=2 |
---|
[14226] | 217 | |
---|
| 218 | DONUT |
---|
| 219 | ----- |
---|
| 220 | | Donut shaped configuration to test MPI decomposition with bdy |
---|