[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 | |
---|
[14444] | 56 | BENCH |
---|
| 57 | ----- |
---|
| 58 | | Benchmark configuration. Allow to run any configuration (including ORCA type or BDY) with idealized grid |
---|
| 59 | and initial state so it does not need any input file other than the namelists. |
---|
| 60 | As usual, all configuration changes can be done through the namelist. |
---|
| 61 | We provide 3 example of namelist_cfg to mimic ORCA1, OR025 or ORCA12 configurations. |
---|
| 62 | By default do not produce any output file. An extensive description of BENCH will be abailable in |
---|
| 63 | Irrmann et al. 2021. |
---|
| 64 | |
---|
[10554] | 65 | ICE_AGRIF |
---|
[11735] | 66 | --------- |
---|
[11723] | 67 | |
---|
[11735] | 68 | .. figure:: _static/ICE_AGRIF_UDIAG_43days_UM5.gif |
---|
| 69 | :width: 200px |
---|
| 70 | :align: left |
---|
[10201] | 71 | |
---|
[11735] | 72 | .. |
---|
[10201] | 73 | |
---|
[11735] | 74 | | This test case illustrates the advection of an ice patch across |
---|
| 75 | an East/West and North/South periodic channel over a slab ocean (i.e. one ocean layer), |
---|
| 76 | and with an AGRIF zoom (1:3) in the center. |
---|
| 77 | | The purpose of this configuration is to |
---|
| 78 | test the advection of the ice patch in and across the AGRIF boundary. |
---|
| 79 | One can either impose ice velocities or ice-atm. |
---|
| 80 | Stresses and let rheology define velocities (see :file:`README` for details) |
---|
| 81 | |
---|
[10204] | 82 | VORTEX |
---|
[11735] | 83 | ------ |
---|
[11723] | 84 | |
---|
[11735] | 85 | .. figure:: _static/VORTEX_anim.gif |
---|
| 86 | :width: 200px |
---|
| 87 | :align: right |
---|
[11723] | 88 | |
---|
[11735] | 89 | .. |
---|
[11723] | 90 | |
---|
[11735] | 91 | This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. |
---|
| 92 | It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. |
---|
| 93 | It serves as a benchmark for quantitative estimates of nesting errors as in :cite:`DEBREU2012`, |
---|
| 94 | :cite:`PENVEN2006` or :cite:`SPALL1991`. |
---|
[10201] | 95 | |
---|
[11735] | 96 | The animation (sea level anomaly in meters) illustrates with |
---|
| 97 | two 1:2 successively nested grids how the vortex smoothly propagates out of the refined grids. |
---|
| 98 | |
---|
[10204] | 99 | ISOMIP |
---|
[11735] | 100 | ------ |
---|
[10201] | 101 | |
---|
[11735] | 102 | .. figure:: _static/ISOMIP_moc.png |
---|
| 103 | :width: 200px |
---|
| 104 | :align: left |
---|
[11723] | 105 | |
---|
[11735] | 106 | .. |
---|
[10201] | 107 | |
---|
[11735] | 108 | | The purpose of this test case is to evaluate the impact of various schemes and new development with |
---|
| 109 | the iceshelf cavities circulation and melt. |
---|
| 110 | This configuration served as initial assesment of the ice shelf module in :cite:`LOSCH2008` and |
---|
| 111 | :cite:`MATHIOT2017`. |
---|
| 112 | The default setup is the one described |ISOMIP|_. |
---|
| 113 | | The figure (meridional overturning circulation) illustrates |
---|
| 114 | the circulation generated after 10000 days by the ice shelf melting (ice pump). |
---|
[10204] | 115 | |
---|
[11735] | 116 | .. |ISOMIP| replace:: here |
---|
| 117 | |
---|
[10204] | 118 | LOCK_EXCHANGE |
---|
[11735] | 119 | ------------- |
---|
[10204] | 120 | |
---|
[11735] | 121 | .. figure:: _static/LOCK-FCT4_flux_ubs.gif |
---|
| 122 | :width: 200px |
---|
| 123 | :align: right |
---|
[10204] | 124 | |
---|
[11735] | 125 | .. |
---|
[10240] | 126 | |
---|
[11735] | 127 | | The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted |
---|
| 128 | by :cite:`HAIDVOGEL1999` for testing advection schemes in ocean circulation models. |
---|
| 129 | It has been used by several authors including :cite:`BURCHARD2002` and :cite:`ILICAK2012`. |
---|
| 130 | The LOCK EXCHANGE experiment can in particular illustrate |
---|
| 131 | the impact of different choices of numerical schemes and/or subgrid closures on |
---|
| 132 | spurious interior mixing. |
---|
| 133 | | Here the animation of the LOCK_EXCHANGE test case using |
---|
| 134 | the advection scheme FCT4 (forth order) for tracer and ubs for dynamics. |
---|
[10204] | 135 | |
---|
| 136 | OVERFLOW |
---|
[11735] | 137 | -------- |
---|
[10204] | 138 | |
---|
[11735] | 139 | .. figure:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif |
---|
| 140 | :width: 200px |
---|
| 141 | :align: left |
---|
[10204] | 142 | |
---|
[11735] | 143 | .. |
---|
[10240] | 144 | |
---|
[11735] | 145 | | The OVERFLOW experiment illustrates the impact of different choices of numerical schemes and/or |
---|
| 146 | subgrid closures on spurious interior mixing close to bottom topography. |
---|
| 147 | The OVERFLOW experiment is adapted from the non-rotating overflow configuration described in |
---|
| 148 | :cite:`HAIDVOGEL1999` and further used by :cite:`ILICAK2012`. |
---|
| 149 | Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and |
---|
| 150 | forth-order FCT4, z-coordinate and sigma coordinate (...). |
---|
| 151 | | Here the animation of the OVERFLOW test case in sigma coordinate with |
---|
| 152 | the forth-order advection scheme FCT4. |
---|
[10204] | 153 | |
---|
| 154 | WAD |
---|
[11735] | 155 | --- |
---|
[10204] | 156 | |
---|
[11735] | 157 | .. figure:: _static/wad_testcase_7.gif |
---|
| 158 | :width: 200px |
---|
| 159 | :align: right |
---|
[11723] | 160 | |
---|
[11735] | 161 | .. |
---|
[10204] | 162 | |
---|
[11735] | 163 | | A set of simple closed basin geometries for testing the Wetting and drying capabilities. |
---|
| 164 | Examples range from a closed channel with EW linear bottom slope to |
---|
| 165 | a parabolic EW channel with a Gaussian ridge. |
---|
| 166 | | Here the animation of the test case 7. |
---|
| 167 | This test case is a simple linear slope with a mid-depth shelf with |
---|
| 168 | an open boundary forced with a sinusoidally varying ssh. |
---|
| 169 | This test case has been introduced to emulate a typical coastal application with |
---|
| 170 | a tidally forced open boundary with an adverse SSH gradient that, |
---|
| 171 | when released, creates a surge up the slope. |
---|
| 172 | The parameters are chosen such that |
---|
| 173 | the surge rises above sea-level before falling back and oscillating towards an equilibrium position. |
---|
[10204] | 174 | |
---|
[10240] | 175 | CANAL |
---|
[11735] | 176 | ----- |
---|
[10240] | 177 | |
---|
[11735] | 178 | .. figure:: _static/CANAL_image.gif |
---|
| 179 | :width: 200px |
---|
| 180 | :align: left |
---|
[10240] | 181 | |
---|
[11735] | 182 | .. |
---|
[10240] | 183 | |
---|
[11735] | 184 | East-west periodic canal of variable size with several initial states and |
---|
| 185 | associated geostrophic currents (zonal jets or vortex). |
---|
| 186 | |
---|
[10554] | 187 | ICE_ADV2D |
---|
[11735] | 188 | --------- |
---|
[11723] | 189 | |
---|
[11735] | 190 | | This test case illustrates the advection of an ice patch across |
---|
| 191 | an East/West and North/South periodic channel over a slab ocean (i.e. one ocean layer). |
---|
[10554] | 192 | The configuration is similar to ICE_AGRIF, except for the AGRIF zoom. |
---|
[11735] | 193 | | The purpose of this configuration is to test the advection schemes available in the sea-ice code |
---|
[10554] | 194 | (for now, Prather and Ultimate-Macho from 1st to 5th order), |
---|
| 195 | especially the occurence of overshoots in ice thickness |
---|
| 196 | |
---|
| 197 | ICE_ADV1D |
---|
[11735] | 198 | --------- |
---|
[11723] | 199 | |
---|
[11735] | 200 | | This experiment is the classical :cite:`SCHAR1996` test case , |
---|
| 201 | which has been used in :cite:`LIPSCOMB2004`, and in which very specific shapes of ice concentration, |
---|
| 202 | thickness and volume converge toward the center of a basin. |
---|
[10554] | 203 | Convergence is unidirectional (in x) while fields are homogeneous in y. |
---|
[11735] | 204 | | The purpose of this configuration is to |
---|
| 205 | test the caracteristics of advection schemes available in the sea-ice code |
---|
[10554] | 206 | (for now, Prather and Ultimate-Macho from 1st to 5th order), |
---|
[11735] | 207 | especially the constitency between concentration, thickness and volume, |
---|
| 208 | and the preservation of initial shapes. |
---|
[10554] | 209 | |
---|
[11723] | 210 | .. rubric:: References |
---|
[10240] | 211 | |
---|
[11723] | 212 | .. bibliography:: tests.bib |
---|
| 213 | :all: |
---|
| 214 | :style: unsrt |
---|
| 215 | :labelprefix: T |
---|