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.
README.rst in NEMO/branches/2019/dev_r11756_optional_variables – NEMO

source: NEMO/branches/2019/dev_r11756_optional_variables/README.rst @ 11838

Last change on this file since 11838 was 11734, checked in by nicolasmartin, 4 years ago

Review README for reference confgiurations

File size: 3.8 KB
Line 
1.. todo::
2
3
4
5NEMO_ for *Nucleus for European Modelling of the Ocean* is a state-of-the-art modelling framework for
6research activities and forecasting services in ocean and climate sciences,
7developed in a sustainable way by a European consortium since 2008.
8
9.. contents::
10   :local:
11
12Overview
13========
14
15The NEMO ocean model has 3 major components:
16
17- |OCE| models the ocean {thermo}dynamics and solves the primitive equations
18  (:file:`./src/OCE`)
19- |ICE| simulates sea-ice {thermo}dynamics, brine inclusions and
20  subgrid-scale thickness variations (:file:`./src/ICE`)
21- |MBG| models the {on,off}line oceanic tracers transport and biogeochemical processes
22  (:file:`./src/TOP`)
23
24These physical core engines are described in
25their respective `reference publications <#project-documentation>`_ that
26must be cited for any work related to their use (see :doc:`cite`).
27
28Assets and solutions
29====================
30
31Not only does the NEMO framework model the ocean circulation,
32it offers various features to enable
33
34- Create :doc:`embedded zooms<zooms>` seamlessly thanks to 2-way nesting package AGRIF_.
35- Opportunity to integrate an :doc:`external biogeochemistry model<tracers>`
36- Versatile :doc:`data assimilation<da>`
37- Generation of :doc:`diagnostics<diags>` through effective XIOS_ system
38- Roll-out Earth system modeling with :doc:`coupling interface<cplg>` based on OASIS_
39
40Several :doc:`built-in configurations<cfgs>` are provided to
41evaluate the skills and performances of the model which
42can be used as templates for setting up a new configurations (:file:`./cfgs`).
43
44The user can also checkout available :doc:`idealized test cases<tests>` that
45address specific physical processes (:file:`./tests`).
46
47A set of :doc:`utilities <tools>` is also provided to {pre,post}process your data (:file:`./tools`).
48
49Project documentation
50=====================
51
52A walkthrough tutorial illustrates how to get code dependencies, compile and execute NEMO
53(:file:`./INSTALL.rst`).
54
55Reference manuals and quick start guide can be build from source and
56exported to HTML or PDF formats (:file:`./doc`) or
57downloaded directly from the :forge:`development platform<wiki/Documentations>`.
58
59============ ================== ===================
60 Component    Reference Manual   Quick Start Guide
61============ ================== ===================
62 |NEMO-OCE|   |DOI man OCE|_     |DOI qsg|
63 |NEMO-ICE|   |DOI man ICE|
64 |NEMO-MBG|   |DOI man MBG|
65============ ================== ===================
66
67Since 2014 the project has a `Special Issue`_ in the open-access journal
68Geoscientific Model Development (GMD) from the European Geosciences Union (EGU_).
69The main scope is to collect relevant manuscripts covering various topics and
70to provide a single portal to assess the model potential and evolution.
71
72Used by a wide audience,
73numerous :website:`associated projects<projects>` have been carried out and
74extensive :website:`bibliography<bibliography/publications>` published.
75
76Development board
77=================
78
79The NEMO Consortium pulling together 5 European institutes
80(CMCC_, CNRS_, MOI_, `Met Office`_ and NERC_) plans the sustainable development in order to
81keep a reliable evolving framework since 2008.
82
83It defines the |DOI dev stgy|_ that is implemented by the System Team on a yearly basis
84in order to release a new version almost every four years.
85
86When the need arises, :forge:`working groups<wiki/WorkingGroups>` are created or resumed to
87gather the community expertise for advising on the development activities.
88
89.. |DOI dev stgy| replace:: multi-year development strategy
90
91Disclaimer
92==========
93
94The NEMO source code is freely available and distributed under
95:download:`CeCILL v2.0 license <../../../LICENSE>` (GNU GPL compatible).
96
97You can use, modify and/or redistribute the software under its terms,
98but users are provided only with a limited warranty and the software's authors and
99the successive licensor's have only limited liability.
Note: See TracBrowser for help on using the repository browser.