source: NEMO/trunk/RELEASE_NOTES.rst @ 10596

Last change on this file since 10596 was 10596, checked in by nicolasmartin, 3 years ago

Fixes for a unsuccessful Python Sphinx building, no more warnings but still crashing

File size: 8.6 KB
Line 
1*************
2RELEASE NOTES
3*************
4
5.. contents::
6   :local:
7
8New sea-ice component SI3 (in place of LIMx)
9============================================
10
11- Physics
12  - Lateral melting
13  - Melt ponds: constant or :doi:`10.1175/JCLI-D-11-00078.1 <Holland et al. 2012>` formulation (and soon topographic melt ponds)
14  - Ice-atm. drags from :doi:`10.1029/2012JD017630 <Lupkes et al. 2012>` (depending on ice concentration) or :doi:`10.1002/2014JD022418 <Lupkes et al. 2015>` (depending on sea ice concentration and atm. stability)
15  - Landfast ice (:doi:`10.1002/2016JC012006 <Lemieux et al. 2016>`)
16
17- Numerics
18  - Advection: Ultimate-Macho scheme
19  - Rheology: adaptive EVP (:doi:`10.1016/j.ocemod.2016.03.004 <Kimmritz et al. 2017>`)
20  - Coupling interface: conductivity as surface forcing instead of heat fluxes (Met Office requirement)
21   
22- Performance: all thermodynamics in 1D and reduced mpp communications
23   
24- Usability (users & developers friendly)
25  - Comprehensive set of outputs (universal units and understandable names + includes cmip)
26  - New architecture and namelist
27  - All processes can be decoupled from each other (switch on/off)
28  - Ice categories bounds can be defined by the user or set automatically
29  - For open boundaries, the number of ice categories from the forcing model can be different from the number of categories in the regional simulation
30  - Fully compatible with AGRIF_
31  - Revised documentation
32
33AGRIF for embedded zooms
34========================
35
36- Now compatible with new sea ice component
37- Now compatible with z* coordinate
38- Extended ghost cells area to properly handle scheme with spatial order >2
39- Added vertical refinement (beta)
40- Nesting tools for setup now up to date and working
41
42Enhancements
43============
44
45- Fix for tracer conservation with split explicit free surface
46- Bulk formulae : move to aerobulk package (:doi:`10.1175/JPO-D-16-0169.1 <Brodeau et al. 2016>`), i.e. NCAR, COARE and ECMWF bulk
47                  (remove Clio and MFS bulk)
48- Wetting and drying
49- Added tidal self attraction and loading either read from a file or from usual "scalar" approximation
50- Add a 4th order centered (CEN) and Flux Corrected Transport (FCT) tracer advection
51  (using a 4th compact in the vertical)
52- iso-neutral mixing (iso and triad operators):
53  add the Method of Stabilizing Correction (MSC) (more accurate calculation) + add a bilaplacian case
54- Lateral physics (LDF): scale aware setting of eddy viscosity and diffusivity
55- Vorticity: 2 new energy conserving scheme:
56  ENT with Coriolis defined at T-point (better for Flux form) and
57  EET a variant of EEN where e3t is used instead of e3f
58  (solved the issue with e3f specification but is not enstrophy conserving)
59
60Test Cases
61==========
62
63The first test cases available for now are:
64- ``CANAL``: east-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex)
65- ``ICE_AGRIF``: east-west + north-south periodic channel. The common configuration includes an AGRIF zoom (1:3) in the middle of the basin to test how an ice patch is advected through it but one can also test the advection schemes (Prather and Ultimate-Macho) by removing the key_agrif in the cpp keys.
66- ``ISOMIP``: simple box configuration with an ice shelf with simple geometry on top. The purpose of this test case is to evaluate the impact of various schemes and new development with iceshelf cavities. The exact original setup is described ​here.
67- ``LOCK-EXCHANGE``:classical fluid dynamics experiment that has been adapted by Haidvogel and Beckmann (1999) for testing advection schemes in ocean circulation models. It has been used by several authors including Burchard and Bolding (2002) and Ilıcak et al. (2012). The LOCK EXCHANGE experiment can in particular illustrate the impact of different choices of numerical schemes and/or subgrid closures on spurious interior mixing
68- ``OVERFLOW``: illustrates the impact of different choices of numerical schemes and/or subgrid closures on spurious interior mixing close to bottom topography. It is adapted from the non-rotating overflow configuration described in Haidvogel and Beckmann (1999) and further used by Ilıcak et al. (2012)
69- ``VORTEX``: illustrates the propagation of an anticyclonic eddy over a Beta plan and flat bottom. It is implemented here with an online refined subdomain (thanks to AGRIF library) out of which the vortex propagates. It serves as a benchmark to diagnose nesting errors as in Debreu et al. (2012), Penven et al. (2006) and Spall and Holland (1991)
70- ``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.
71
72New Reference configurations
73============================
74
75``AGRIF_DEMO``: 2 interlocked zooms (1:4 & 1:3) in the Nordic Seas + 1 zoom (1:1) at the equator
76``SPITZ12``: regional configuration around the Svalbard archipelago
77
78Wave coupling
79=============
80
81Coupled interface to external wave model
82Large scale wave interaction process added in momentum and tracer equations
83
84Passive tracer TOP and biogeochemical PISCES components
85=======================================================
86
87- The passive tracers transport component was redesigned toward a modular structure and users can enable each module directly through logical flags in namelist_top (no more fortran macros!).
88- :doc:`tracers <TOP on-line user documentation>`
89- ``TOP`` currently accounts for the following 5 modules:
90  ``CFC`` contains inorganic carbon tracers (CFC11/CFC12/SF6),
91  ``MY_TRC`` is a template for new modules (or external couplings),
92  ``AGE`` deals with water age tracking,
93  ``C14`` as a radiocarbon passive tracer, and
94  the companion ecosystem model ``PISCES``.
95- A generalized infrastructure was developed to handle the prescription of either surface, coastal, or open boundaries conditions for each passive tracer.
96- A new configuration, named ORCA2_OFF_TRC, was created to provide a benchmark simulation environment to deal with inert carbon tracers dynamics by exploiting the offline coupling with NEMO.
97- PISCES model contains new developments and modifications:
98  - Particulate Organic Carbon (POC) component comes with a new liability scheme, while the former Kriest parametrisation was superseded;
99  - A complex iron chemistry scheme is now available, with an improved description of ligands for the marine iron cycle
100  - Carbonate chemistry is based on MOCSY 2.0 routines (see :doi:`10.5194/gmd-8-485-2015 <Orr and Epitalon, 2015>`), by complying also with CMIP6 standards.
101  - Ecosystem components can be optionally modelled by means of explicit nutrient quotas (PISCES-QUOTA)
102
103High Performance Computing (HPC): performances improvements
104===========================================================
105
106- Reduce number of MPI communications
107  (suppression of redundant communications, gather multiple communications into one)
108- Use of MPI-3 asynchronous routines for performance (use key_mpi2 if MPI-3 not available)
109- Back to standard dynamical allocation (remove of wrk_alloc/dealloc statements)
110- :xios:`<XIOS software>` for IOs version 2.5 as default, and optionally available for restarts
111
112Simplification and robustness
113=============================
114
115- Revised structure of namelist_ref/_cfg and default reference values.
116- Lateral physics (LDF): simplification of user interface and removal of CPP keys
117- Vertical physics (ZDF) (modularity, share shear production calculation between TKE and GKS, removal of all ZDF CPP keys, removal of avmu & avmv, minimization of MPP comm.: ~15 removed)
118  Remove the split-explicit ZDF scheme for both TRA and DYN
119  Remove the acceleration of convergence
120  Generalised lbc_lnk and lbc_nfd
121  Unify mppini
122  Use non uniform jpi/jpj with dynamic allocation to avoid ghost rows/columns
123  MPI Message passing re coded
124  Configuration interface completely rewritten
125  (DOM module mainly suppressed , and in place: domain_cfg.nc file, or usr_def module)
126
127Collaborative Development Environment
128=====================================
129
130- Access to information on NEMO wiki reorganised through portals for users/developers/System Team and complete refactoring of all wiki pages and their layout
131- Reorganisation of SVN repository to be compliant with usual directory tree and facilitate building of NEMO executable
132- Define and install a separate repository for test cases to all easy contributions from the NEMO Users Community
133- :forge:`discussion <Forums>` created
134- ​:nemo:`<NEMO public web site>` has been cleaned and is now much nicer (using Wordpress instead of EzP)
135- New mailing lists have been set up
136- Improvements of reliability through automatic and regular testing of the changes made in repository
Note: See TracBrowser for help on using the repository browser.