source: NEMO/trunk/README.rst @ 10201

Last change on this file since 10201 was 10201, checked in by nicolasmartin, 2 years ago

Various modifications related to the setting of a NEMO Quick Start Guide

  • Add missing namelist blocks from ICE and TOP
  • Create a hidden .global.rst to gather common URL links
  • Convert animated gif to frames images for PDF export
  • Place different README.rst appropriately in the code structure and refer to them with symbolic links in doc/rst/source
File size: 3.8 KB
Line 
1.. include:: .global.rst
2
3:Release: |release|
4:Date:    |today|
5           
6NEMO for *Nucleus for European Modelling of the Ocean* is a state-of-the-art modelling framework of
7ocean related engines for oceanographic research, operational oceanography, seasonal forecast and
8[paleo]climate studies.
9
10.. contents::
11   :local:
12
13Overview
14========
15
16Distributed under CeCILL license (GNU GPL compatible - see ``./LICENSE``),
17the NEMO ocean model has 3 major components:
18
19- :rstblue:`OPA` is fundamental to all users by modelling the ocean [thermo]dynamics and
20  solving the primitive equations         (``./src/OCE``); :cite:`madec_bk08`
21- :rstgrey:`SI`\ :rstgreysup:`3` for sea-ice simulates ice [thermo]dynamics, brine inclusions and
22  subgrid-scale thickness variations      (``./src/ICE``); :cite:`gmd-8-2991-2015,vancoppenolle200933`
23- :rstgreen:`TOP-PISCES` models biogeochemistry with TOP for the on/offline oceanic tracers transport and
24  PISCES for the biogeochemical processes (``./src/MBG``). :cite:`gmd-8-2465-2015`
25
26These physical engines are described in their respective reference publications that must be cited for
27any work related to their use.
28
29Applications and capabilities
30=============================
31
32Not only does the NEMO framework model the ocean circulation,
33it offers various features to enable
34
35- 2-way nesting package `AGRIF`_ to create :doc:`embedded zooms <zooms>` seamlessly
36- Flexible biogeochemistry with :doc:`online coarsening <coarsening>` and
37  opportunity to integrate an :doc:`alternative model <tracers>`
38- Versatile :doc:`data assimilation interface <data_assimilation>`
39
40lation a efficient XIOS_ server for outputing diagnostics a coupled via OASIS_ to alternative components or other models to enable Earth system modelling.
41
42| Several :doc:`builtins configurations <reference_configurations>` are provided to assess the skills and
43   performances of the model which can be used as templates for setting up a new configuration (``./cfgs``).
44| The end user could also find some :doc:`idealised test cases <test_cases>` on the web to serve as examples and
45   to study particular processes (``./tests``).
46
47A set of tools is also provided to setup your own configuration and [pre|post]process your data (``./tools``).
48
49Literature
50==========
51
52| The NEMO reference manual and a quick start guide can be generated from Latex and RST source code files
53   (``./doc``), either in PDF or in HTML format, but it might require some additional installations.
54| In any case, both formats are available online: `HTML`_ | `PDF`_
55
56| Since 2014 the project has a `Special Issue`_ in the open-access journal Geoscientific Model Development (GMD)
57   from the European Geosciences Union (EGU).
58   The main scope is to collect relevant manuscripts which cover a wide variety of topics like
59   process studies, new parameterizations, implementation of new model features and new NEMO configurations.
60| Also it provides a single portal to search, discover and understand about
61   the NEMO modelling framework potential and evolution and to submit their contributions.
62
63Community development
64=====================
65
66| The NEMO Consortium gathering 6 European institutes (`CMCC`_, `CNRS`_, `MOI`_, `Met Office`_ and `NERC`_)
67   organises the sustainable development in order to keep a reliable evolving system since 2008.
68| It defines the multi-year development strategy which is implemented by the NEMO System Team.
69
70When the need arises, `Working Groups`_ are created or resumed to gather the expertise in the community in order to
71focus the development work on a specific subject or major component of the framework.
72
73How to cite NEMO
74================
75
76.. bibliography:: references.bib
77   :all:
78   :style: unsrt
79
80.. _HTML:           http://www.nemo-ocean.eu/doc
81.. _PDF:            http://www.nemo-ocean.eu/wp-content/uploads/NEMO_book.pdf
Note: See TracBrowser for help on using the repository browser.