New URL for NEMO forge!   http://forge.nemo-ocean.eu

Since March 2022 along with NEMO 4.2 release, the code development moved to a self-hosted GitLab.
This present forge is now archived and remained online for history.
README.rst in NEMO/branches/2018/dev_r10164_HPC09_ESIWACE_PREP_MERGE/tests – NEMO

source: NEMO/branches/2018/dev_r10164_HPC09_ESIWACE_PREP_MERGE/tests/README.rst @ 10410

Last change on this file since 10410 was 10345, checked in by smasson, 5 years ago

dev_r10164_HPC09_ESIWACE_PREP_MERGE: merge with trunk@10344, see #2133

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