Changeset 10240


Ignore:
Timestamp:
2018-10-26T17:59:10+02:00 (19 months ago)
Author:
mathiot
Message:

include README in README.rst + del README + update .bib + add .bib management in README.rst

Location:
NEMO/trunk/tests
Files:
1 deleted
2 edited

Legend:

Unmodified
Added
Removed
  • NEMO/trunk/tests/README.rst

    r10230 r10240  
    88.. _Github repository:   https://github.com/sflavoni/NEMO-test-cases/ 
    99 
    10 CANAL 
    11 ===== 
    12  
    13   East-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex) 
    14  
    15   .. image::_static/CANAL_image.gif 
    16  
    1710ICEDYN 
    1811====== 
    1912   
    20   This is an East-t cases illustrate the advection of an ice patch across a East/West and North/South periodic channel.  
     13  This test case illustrates the advection of an ice patch across a East/West and North/South periodic channel.  
    2114  This configuration can be used to test the advection of the ice patch in an AGRIF zoom (1:3)  
    2215  and across the AGRIF boundary or to test the ice advection schemes (Prather and Ultimate-Macho).  
     
    3023  This test case illustrates the propagation of an anticyclonic eddy over a Beta plan and a flat bottom. 
    3124  It is implemented here with an online refined subdomain (1:3) out of which the vortex propagates. 
    32   It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012), 
    33   Penven et al. (2006) or Spall and Holland (1991). 
     25  It serves as a benchmark for quantitative estimates of nesting errors as in Debreu et al. (2012) :cite:`DEBREU2012`, 
     26  Penven et al. (2006) :cite:`PENVEN2006` or Spall and Holland (1991) :cite:`SPALL1991`. 
    3427   
    3528  The animation below (sea level anomaly in meters) illustrates with two 1:2 successively nested grids how 
     
    4235 
    4336  The purpose of this test case is to evaluate the impact of various schemes and new development with the iceshelf cavities circulation and melt. 
    44   This configuration served as initial assesment of the ice shelf module in Losh et al. (2008) and Mathiot et al. (2017).  
     37  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`.  
    4538  The default setup is the one described `here <http://staff.acecrc.org.au/~bkgalton/ISOMIP/test_cavities.pdf>`_. 
    4639   
     
    5346 
    5447  The LOCK EXCHANGE experiment is a classical fluid dynamics experiment that has been adapted 
    55   by Haidvogel and Beckmann (1999) for testing advection schemes in ocean circulation models. 
    56   It has been used by several authors including Burchard and Bolding (2002) and Ilicak et al. (2012). 
    57   The LOCK EXCHANGE experiment can in particulart illustrate the impact of different choices of numerical schemes  
     48  by Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` for testing advection schemes in ocean circulation models. 
     49  It has been used by several authors including Burchard and Bolding (2002) :cite:`BURCHARD2002` and Ilicak et al. (2012) :cite:`ILICAK2012`. 
     50  The LOCK EXCHANGE experiment can in particular illustrate the impact of different choices of numerical schemes  
    5851  and/or subgrid closures on spurious interior mixing. 
     52 
     53  Below the animation of the LOCK_EXCHANGE test case using the advection scheme FCT4 (forth order) for tracer and ubs for dynamics. 
    5954 
    6055  .. image:: _static/LOCK-FCT4_flux_ubs.gif 
     
    6661  and/or subgrid closures on spurious interior mixing close to bottom topography.  
    6762  The OVERFLOW experiment is adapted from the non-rotating overflow configuration described  
    68   in Haidvogel and Beckmann (1999) and further used by Ilicak et al. (2012). 
    69   Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and fortht-order FCT4,  
    70   with some exemple of python scripts into the notebook associated. 
     63  in Haidvogel and Beckmann (1999) :cite:`HAIDVOGEL1999` and further used by Ilicak et al. (2012) :cite:`ILICAK2012`. 
     64  Here we can assess the behaviour of the second-order tracer advection scheme FCT2 and fortht-order FCT4, z-coordinate and sigma coordinate (...). 
     65 
     66  Below the animation of the OVERFLOW test case in sigma coordinate with the forth-order advection scheme FCT4. 
    7167 
    7268  .. image:: _static/OVF-sco_FCT4_flux_cen-ahm1000.gif 
     
    8480  .. image:: _static/wad_testcase_7.gif 
    8581 
     82CANAL 
     83===== 
     84 
     85  East-west periodic canal of variable size with several initial states and associated geostrophic currents (zonal jets or vortex). 
     86 
     87  .. image::_static/CANAL_image.gif 
     88 
     89================== 
     90Compile test cases 
     91================== 
     92The compilation of the test cases is very similar to the manner the reference configurations are compiled. 
     93If you are not familiar on how to compile NEMO, it is first recomended to read the instruction  
     94`here <http://forge.ipsl.jussieu.fr/nemo/wiki/Users/ModelInstall>`_ 
     95 
     96| 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. 
     97 
     98| 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: 
     99 
     100.. code-block:: console 
     101                    
     102        $ ./makenemo -n WAD2 -a WAD -m macport_osx -j 4 
     103 
     104===================================== 
     105Run and analyse the test cases 
     106===================================== 
     107There no requirement of specific input file for the test_cases presented here. The XIOS xml input files and namelist are already setup correctly.  
     108All the detailed on how to run a specific test cases and Jupyter notebook are available on github `here <https://github.com/sflavoni/NEMO-test-cases>`_. 
     109 
    86110========== 
    87111References 
    88112========== 
    89 - Burchard, H., Bolding, K., 2002. GETM - a general estuarine transport model. Scientific documentation. Tech. Rep. EUR 20253 EN, European Commission. 
    90 - Debreu, L., P. Marchesiello, P. Penven and G. Cambon, 2012: Two-way nesting in split-explicit ocean models: Algorithms, implementation and validation. Ocean Modelling, 49-50, 1-21. 
    91 - Haidvogel, Dale B., and Aike Beckmann. Numerical ocean circulation modeling. Vol. 2. World Scientific, 1999.  
    92 - Haidvogel, Dale B., and Aike Beckmann. Numerical ocean circulation modeling. Vol. 2. World Scientific, 1999.  
    93 - Ilicak, Mehmet, et al. "Spurious dianeutral mixing and the role of momentum closure." Ocean Modelling 45 (2012): 37-58. 
    94 - Ilicak, Mehmet, et al. "Spurious dianeutral mixing and the role of momentum closure." Ocean Modelling 45 (2012): 37-58. 
    95 - Losch, M., 2008: Modeling ice shelf cavities in a z coordinate ocean general circulation model, J. Geophys. Res.-Oceans, 113, C08043. 
    96 - Mathiot, P., Jenkins, A., Harris, C., and Madec, G., 2017: Explicit representation and parametrised impacts of under ice shelf seas in the z* coordinate ocean model NEMO 3.6, Geosci. Model Dev., 10, 2849-2874. 
    97 - Penven, P., L. Debreu, P. Marchesiello and J. C. Mc Williams, 2006: Evaluation and application of the ROMS 1-way embedding procedure to the central california upwelling system. Ocean Modelling, 12, 157-187. 
    98 - Spall, M. A. and W. R. Holland, 1991: A Nested Primitive Equation Model for Oceanic Applications. J. Phys. Ocean., 21, 205-220. 
     113 
     114..      bibliography:: test_cases.bib 
     115                :all: 
     116        :style: unsrt 
  • NEMO/trunk/tests/test_cases.bib

    r10201 r10240  
    1 @book{epic31172, 
     1@book{HAIDVOGEL1999, 
    22   author = {D. B. Haidvogel and A. Beckmann}, 
    33   publisher = {Imperial College Press, London}, 
     
    66} 
    77 
    8 @book{burchard2002getm, 
     8@book{BURCHARD2002, 
    99   title={GETM: A General Estuarine Transport Model; Scientific Documentation}, 
    1010   author={Burchard, Hans and Bolding, Karsten}, 
     
    1313} 
    1414 
    15 @article{ILICAK201237, 
     15@article{ILICAK2012, 
    1616   title = "Spurious dianeutral mixing and the role of momentum closure", 
    1717   journal = "Ocean Modelling", 
     
    2121   issn = "1463-5003", 
    2222   doi = "10.1016/j.ocemod.2011.10.003", 
    23    author = "Mehmet Ilıcak and Alistair J. Adcroft and Stephen M. Griffies and Robert W. Hallberg", 
     23   author = "Mehmet Ilicak and Alistair J. Adcroft and Stephen M. Griffies and Robert W. Hallberg", 
    2424   keywords = "Spurious dianeutral transport, Cabbeling, Overflows, Exchange-flow, Ocean models, Momentum transport, Tracer advection, Reference potential energy" 
    2525} 
    2626 
    27 @article{DEBREU20121, 
     27@article{DEBREU2012, 
    2828   title = "Two-way nesting in split-explicit ocean models: Algorithms, implementation and validation", 
    2929   journal = "Ocean Modelling", 
     
    3737} 
    3838 
    39 @article{PENVEN2006157, 
     39@article{PENVEN2006, 
    4040   title = "Evaluation and application of the ROMS 1-way embedding procedure to the central california upwelling system", 
    4141   journal = "Ocean Modelling", 
     
    5050} 
    5151 
    52 @article{SPALL1991205, 
    53    author = {Spall, Michael A. and Holland, William R.}, 
     52@article{SPALL1991, 
     53   author = {Spall, M. A. and Holland, W. R.}, 
    5454   title = {A Nested Primitive Equation Model for Oceanic Applications}, 
    5555   journal = {Journal of Physical Oceanography}, 
     
    6060   doi = {10.1175/1520-0485(1991)021<0205:ANPEMF>2.0.CO;2}, 
    6161} 
     62 
     63@article{MATHIOT2017, 
     64   author = {Mathiot, P. and Jenkins, A. and Harris, C. and Madec, G.}, 
     65   title = {Explicit representation and parametrised impacts of under ice shelf seas in the ${z}^{\ast}$ coordinate ocean model NEMO 3.6}, 
     66   journal = {Geoscientific Model Development}, 
     67   volume = {10}, 
     68   year = {2017}, 
     69   number = {7}, 
     70   pages = {2849--2874}, 
     71   url = {https://www.geosci-model-dev.net/10/2849/2017/}, 
     72   doi = {10.5194/gmd-10-2849-2017} 
     73} 
     74 
     75@article{LOSCH2008, 
     76   author = {Losch, M.}, 
     77   title = {Modeling ice shelf cavities in a z coordinate ocean general circulation model}, 
     78   journal = {Journal of Geophysical Research: Oceans}, 
     79   volume = {113}, 
     80   year = {2008}, 
     81   number = {C8}, 
     82   pages = {}, 
     83   keywords = {Ice shelf cavities, numerical ocean modeling, z coordinates}, 
     84   doi = {10.1029/2007JC004368}, 
     85   url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2007JC004368}, 
     86   eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2007JC004368}, 
     87   abstract = {Processes at the ice shelf-ocean interface and in particular in ice shelf cavities around Antarctica have an observable effect on the solutions of basin scale to global coupled ice-ocean models. Despite this, these processes are not routinely represented in global ocean and climate models. It is shown that a new ice shelf cavity model for z coordinate models can reproduce results from an intercomparison project of earlier approaches with vertical ?~C or isopycnic coordinates. As a proof of concept, ice shelves are incorporated in a 100-year global integration of a z coordinate model. In this simulation, glacial meltwater can be traced as far as north as 15??S. The observed effects of processes in the ice shelf cavities agree with previous results from a ?~C coordinate model, notably the increase in sea ice thickness. However, melt rates are overestimated probably because the parameterization of basal melting does not suit the low resolution of this configuration.} 
     88} 
Note: See TracChangeset for help on using the changeset viewer.