Giter Club home page Giter Club logo

nemo-examples's Introduction

NEMO Tests Cases

Description of tests cases available with NEMO

ICE_AGRIF

This test case illustrates the advection of an ice patch across an East/West and North/South periodic channel over a slab ocean (i.e. one ocean layer), and with an AGRIF zoom (1:3) in the center The purpose of this configuration is to test the advection of the ice patch in
and across the AGRIF boundary One can either impose ice velocities or ice-atm. stresses and let rheology define velocities (see README for details)

U diag ICE_AGRIF

VORTEX

This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012) :cite:DEBREU2012, Penven et al. (2006) :cite:PENVEN2006 or Spall and Holland (1991) :cite:SPALL1991.

The animation below (sea level anomaly in meters) illustrates with two 1:2 successively nested grids how the vortex smoothly propagates out of the refined grids.

VORTEX anim

ISOMIP

The purpose of this test case is to evaluate the impact of various schemes and new development with the iceshelf cavities circulation and melt. 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. The default setup is the one described here <http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf>_.

The figure below (meridional overturning circulation) illustrates the circulation generated after 10000 days by the ice shelf melting (ice pump).

ISOMIP moc

LOCK_EXCHANGE

The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted by Haidvogel and Beckmann (1999) :cite:HAIDVOGEL1999 for testing advection schemes in ocean circulation models. It has been used by several authors including Burchard and Bolding (2002) :cite:BURCHARD2002 and Ilicak et al. (2012) :cite:ILICAK2012. The LOCK EXCHANGE experiment can in particular illustrate the impact of different choices of numerical schemes and/or subgrid closures on spurious interior mixing.

Below the animation of the LOCK_EXCHANGE test case using the advection scheme FCT4 (forth order) for tracer and ubs for dynamics.

.. image:: _static/LOCK-FCT4_flux_ubs.gif

OVERFLOW

The OVERFLOW experiment illustrates the impact of different choices of numerical schemes and/or subgrid closures on spurious interior mixing close to bottom topography. The OVERFLOW experiment is adapted from the non-rotating overflow configuration described in Haidvogel and Beckmann (1999) :cite:HAIDVOGEL1999 and further used by Ilicak et al. (2012) :cite:ILICAK2012. Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and fortht-order FCT4, z-coordinate and sigma coordinate (...).

Below the animation of the OVERFLOW test case in sigma coordinate with the forth-order advection scheme FCT4. .. image:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif

WAD

A set of simple closed basin geometries for testing the Wetting and drying capabilities. Examples range from a closed channel with EW linear bottom slope to a parabolic EW channel with a Gaussian ridge.

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. 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. The parameters are chosen such that the surge rises above sea-level before falling back and oscillating towards an equilibrium position

.. image:: _static/wad_testcase_7.gif

CANAL

East-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex).

.. image::_static/CANAL_image.gif

ICE_ADV2D

This test case illustrates the advection of an ice patch across an East/West and North/South periodic channel over a slab ocean (i.e. one ocean layer). The configuration is similar to ICE_AGRIF, except for the AGRIF zoom. The purpose of this configuration is to test the advection schemes available in the sea-ice code (for now, Prather and Ultimate-Macho from 1st to 5th order), especially the occurence of overshoots in ice thickness

ICE_ADV1D

This experiment is the classical Schar & Smolarkiewicz (1996) test case :cite:SCHAR1996, which has been used in :cite:LIPSCOMB2004, and in which very specific shapes of ice concentration, thickness and volume converge toward the center of a basin. Convergence is unidirectional (in x) while fields are homogeneous in y. The purpose of this configuration is to test the caracteristics of advection schemes available in the sea-ice code (for now, Prather and Ultimate-Macho from 1st to 5th order), especially the constitency between concentration, thickness and volume, and the preservation of initial shapes.

SEAMOUNT

This experiment is the Beckmann and Haidvogel (1993) SEAMOUNT test case :cite:BECKMANN1993. It is a Gaussian bump in an East-West periodic channel initialised at rest with a horizontally uniform, exponential vertical density profile. The domain is defined by a terrain-following coordinate. The purpose of this configuration is to demonstrate the relative performance of various hpg schemes in reducing the spurious velocities generated due to numerical errors arising from the misalignment the grid s-level with the pure z-level.

How to run these test cases

The complete and up-to-date set of test cases is available on this NEMO test cases Github repository.

Download it directly in the ./tests root directory using following command:

 git clone http://github.com/NEMO-ocean/NEMO-examples

Once downloaded, the test case can be compiled and run as any other NEMO confiuration, see the "Buid the frameowrk section here

Exploring the results of a test case

Each test case subdirectory includes some plots and/or pythin notebook discribing the expercted results, possible sensitivuty tests, etc..

How to contribute and add new demontration case :

To propose a test case contribution, you need to build up its directory including:

  • a README.md including
    • Detailed desscription of the test case: goal and results
    • Author as contact person
    • The release/revision number of NEMO on which this tests case is working
    • Published document to quote as reference for the test case
  • All the input files or the program to build them
  • Some outputs and/or figures from the results, to demonstrate the interest and capabilities of the test case
  • Hopefully a python notebook to run the test case and produce the results

This directory should then be sent as a pull request to this github repository

nemo-examples's People

Contributors

aimie-moulin avatar brodeau avatar clairelevyfr avatar ericmaisonnave avatar guillaume-smo avatar mo-amyyoung avatar ntmlod avatar stefryn avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

nemo-examples's Issues

examples fail to compile

Hi,
i get following error when i try to compile the examples listed in the repository -
gmake: *** No rule to make target 'diatmb.o', needed by 'diawri.o'. Stop.
this shows up with BENCH and CANAL test cases.

the BENCH and CANAL which comes as part of r4.0.6 branch14997 work fine.
please let me know if more information is required in order to fix this issue.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.