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.
Changeset 10345 for NEMO/branches/2018/dev_r10164_HPC09_ESIWACE_PREP_MERGE/RELEASE_NOTES.rst – NEMO

Ignore:
Timestamp:
2018-11-21T11:25:53+01:00 (5 years ago)
Author:
smasson
Message:

dev_r10164_HPC09_ESIWACE_PREP_MERGE: merge with trunk@10344, see #2133

File:
1 edited

Legend:

Unmodified
Added
Removed
  • NEMO/branches/2018/dev_r10164_HPC09_ESIWACE_PREP_MERGE/RELEASE_NOTES.rst

    r10150 r10345  
    1 ================ 
    2 NEMO 4.0 Release 
    3 ================ 
     1********************** 
     2What's new in NEMO 4.0 
     3********************** 
    44 
    55.. contents:: 
    6  
    7 ---------- 
    8 What's new 
    9 ---------- 
    10  
     6   :local: 
     7       
    118Original sea-ice component SI\ :sup:`3`\ 
    129======================================== 
     
    5047Define and install a separate repository for test cases to all easy contributions from the NEMO Users Community 
    5148 
    52 +-------------------+--------------------------------------------------------+------------------------------------+ 
    53 | Name              | Purpose                                                | References                         | 
    54 +===================+=================+======================================+====================================+ 
    55 | ``CANAL``         | East-west periodic canal of variable size with several |                                    | 
    56 |                   | initial states and associated geostrophic currents     |                                    | 
    57 |                   | (zonal jets or vortex).                                |                                    | 
    58 +-------------------+--------------------------------------------------------+------------------------------------+ 
    59 | ``ICEDYN``        | East-west + north-south periodic channel.              |                                    | 
    60 |                   | The common configuration includes an AGRIF zoom (1:3)  |                                    | 
    61 |                   | in the middle of the basin to test how an ice patch is |                                    | 
    62 |                   | advected through it but one can also test the          |                                    | 
    63 |                   | advection schemes (Prather and Ultimate-Macho) by      |                                    | 
    64 |                   | removing the ``key_agrif`` in the CPP keys.            |                                    | 
    65 +-------------------+--------------------------------------------------------+------------------------------------+ 
    66 | ``ISOMIP``        | Simple box configuration with an iceshelf with simple  | `Hunter 2006`_                     | 
    67 |                   | geometry on top.                                       |                                    | 
    68 |                   | The purpose of this test case is to evaluate the       |                                    | 
    69 |                   | impact of various schemes and new development with     |                                    | 
    70 |                   | iceshelf cavities.                                     |                                    | 
    71 +-------------------+--------------------------------------------------------+------------------------------------+ 
    72 | ``LOCK_EXCHANGE`` | Classical fluid dynamics experiment that has been      | - `Haidvogel and Beckmann 1999`_   | 
    73 |                   | adapted for testing advection schemes in ocean         | - `Burchard and Bolding 2002`_     | 
    74 |                   | circulation models.                                    | - `Ilıcak 2012`_                   | 
    75 |                   | This experiment can in particular illustrate the       |                                    | 
    76 |                   | impact of different choices of numerical schemes       |                                    | 
    77 |                   | and/or subgrid closures on spurious interior mixing.   |                                    | 
    78 +-------------------+--------------------------------------------------------+------------------------------------+ 
    79 | ``OVERFLOW``      | Adapted from the non-rotating overflow configuration   | - `Haidvogel and Beckmann 1999`_   | 
    80 |                   | Illustrates the impact of different choices of         | - `Ilıcak 2012`_                   | 
    81 |                   | numerical schemes and/or subgrid closures on spurious  |                                    | 
    82 |                   | interior mixing close to bottom topography.            |                                    | 
    83 +-------------------+--------------------------------------------------------+------------------------------------+ 
    84 | ``VORTEX``        | Illustrates the propagation of an anticyclonic eddy    | - `Debreu 2012`_                   | 
    85 |                   | over a Beta plan and flat bottom.                      | - `Penven 2006`_                   | 
    86 |                   | It is implemented here with an online refined          | - `Spall and Holland 1991`_        | 
    87 |                   | subdomain (thanks to AGRIF library) out of which the   |                                    | 
    88 |                   | vortex propagates and serves as a benchmark to         |                                    | 
    89 |                   | diagnose nesting errors.                               |                                    | 
    90 +-------------------+--------------------------------------------------------+------------------------------------+ 
    91 | ``WAD``           | Set of simple closed basin geometries for testing the  |                                    | 
    92 |                   | wetting and drying capabilities.                       |                                    | 
    93 |                   | Examples range from a closed channel with EW linear    |                                    | 
    94 |                   | bottom slope to a parabolic EW channel with a Gaussian |                                    | 
    95 |                   | ridge.                                                 |                                    | 
    96 +-------------------+--------------------------------------------------------+------------------------------------+ 
    97  
    98 ----------- 
    99 Improvments 
    100 ----------- 
    101  
    10249Core components 
    10350=============== 
     
    10855- The passive tracers transport component was redesigned toward a modular structure and 
    10956  users can enable each module directly through logical flags in namelist_top (no more Fortran macros!). 
    110 - TOP on-line user documentation is available on NEMO Trac platform (TOP-UserQuickGuide_) 
     57- TOP on-line user documentation is available on NEMO Trac platform (`TOP User Quick Guide`_) 
    11158- TOP currently accounts for the following 5 modules: 
    11259 
     
    13077AGRIF (embedded zooms) 
    13178---------------------- 
     79 
     80The NEMO 4.0 includes new capabilities, configurations and test cases with AGRIF: 
     81 
     82.. role:: underline 
     83   :class: underline 
     84 
     85:underline:`New capabilities from NEMO 3.6 to NEMO 4.0` 
     86 
     87AGRIF is continuously maintained so that it could be activated with all NEMO components (OPA, sea-ice, TOP). 
     88Depending on NEMO version, it is nevertheless not the case so that some options may not be compatible with 
     89the use of online grid refinement. 
     90Check out the table below to know the status according to the NEMO release you may use. 
     91 
     92:underline:`Status of available options with AGRIF (if not listed, option is compatible with AGRIF)`: 
     93 
     94+--------------------------------------------------------+----------------+---------------------+ 
     95|                                                        | NEMO 3.6       | NEMO 4.0            | 
     96+========================================================+================+=====================+ 
     97| LIM2                                                   | yes            | ``-``               | 
     98+--------------------------------------------------------+----------------+---------------------+ 
     99| LIM3/SI3                                               | no             | yes                 | 
     100+--------------------------------------------------------+----------------+---------------------+ 
     101| TOP                                                    | yes            | yes                 | 
     102+--------------------------------------------------------+----------------+---------------------+ 
     103| GLS vertical mixing                                    | no             | yes                 | 
     104+--------------------------------------------------------+----------------+---------------------+ 
     105| z*                                                     | no             | yes                 | 
     106+--------------------------------------------------------+----------------+---------------------+ 
     107| z~                                                     | no             | no                  | 
     108+--------------------------------------------------------+----------------+---------------------+ 
     109| Lagrangian icebergs                                    | no             | no                  | 
     110+--------------------------------------------------------+----------------+---------------------+ 
     111| East-west periodic and/or north fold bcs in zooms      | no             | no                  | 
     112+--------------------------------------------------------+----------------+---------------------+ 
     113| Online timing                                          | no             | no                  | 
     114+--------------------------------------------------------+----------------+---------------------+ 
     115| Stochastic parameterization                            | no             | no                  | 
     116+--------------------------------------------------------+----------------+---------------------+ 
     117| Vertical coordinate change in zooms (``key_vertical``) | no             | yes, but not tested | 
     118+--------------------------------------------------------+----------------+---------------------+ 
     119| Number of ghost cells                                  | 1 (hard coded) | 3 (parameter)       | 
     120+--------------------------------------------------------+----------------+---------------------+ 
     121 
     122[Important notice concerning the change of ghost cells number] 
     123 
     124The default number of ghost cells (i.e. the number of cells that serve as open boundary data provision) has been 
     125increased from 1 to 3 in NEMO 4.0. 
     126This allows to properly handle boundary conditions for numerical schemes that 
     127have a discretization order greater than 2. 
     128On the user point of view this does not change anything++ except in the definition of level 1 grids in 
     129the ``AGRIF_FixedGrids.in`` file. 
     130In order to retrieve exactly the position of a nested grid in NEMO 4.0 one has to shift indices by 
     1312 points to the south-west. 
     132Taking the ``ICEDYN`` example above for NEMO 4.0, the "old" NEMO 3.6 corresponding file would contain:: 
     133 
     134   1 
     135   36 65 36 65 3 3 3 
     136   0 
     137 
     138++ Child grid output files are now greater by 4 points in each direction. 
    132139 
    133140- Now compatible with new sea ice component and z* coordinate 
     
    159166- Wave coupling: large scale wave interaction process added in momentum and tracer equations 
    160167- Remove the acceleration of convergence 
    161    
     168 
    162169Numerics 
    163170-------- 
     
    197204 
    198205.. _sea ice working group:       http://forge.ipsl.jussieu.fr/nemo/wiki/WorkingGroups/SI3 
    199 .. _TOP-UserQuickGuide:          http://forge.ipsl.jussieu.fr/nemo/wiki/WorkingGroups/top-dg/TOP-UserQuickGuide 
    200  
    201 .. _Hunter 2006:                 http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf 
     206.. _TOP User Quick Guide:        http://forge.ipsl.jussieu.fr/nemo/wiki/WorkingGroups/top-dg/TOP-UserQuickGuide 
     207 
     208.. The following references should be in the manual bibliographies and referenced via 'bibliography' directive 
    202209.. _Brodeau 2017:                http://doi.org/10.1175/JPO-D-16-0169.1 
    203 .. _Haidvogel and Beckmann 1999: http://hdl.handle.net/10013/epic.11761 
    204 .. _Burchard and Bolding 2002:   http://www.researchgate.net/publication/258128069_GETM_A_General_Estuarine_Transport_Model_Scientific_Documentation 
    205 .. _Ilıcak 2012:                 http://doi.org/10.1016/j.ocemod.2011.10.003 
    206 .. _Debreu 2012:                 http://doi.org/10.1016/j.ocemod.2012.03.003 
    207 .. _Penven 2006:                 http://doi.org/10.1016/j.ocemod.2005.05.002 
    208 .. _Spall and Holland 1991:      http://www.researchgate.net/publication/232101325_A_Nested_Primitive_Equation_Model_for_Oceanic_Applications 
    209210.. _Holland 2012:                http://doi.org/10.1175/JCLI-D-11-00078.1 
    210211.. _Lupkes 2012:                 http://doi.org/10.1029/2012JD017630 
Note: See TracChangeset for help on using the changeset viewer.