Skip to content
Snippets Groups Projects
README.rst 5.67 KiB
Newer Older
Claire Levy's avatar
Claire Levy committed
.. contents::
   :local:


.. _`Former web platform forge`: https://forge.ipsl.jussieu.fr/nemo
.. _`NEMO users' guide`: https://sites.nemo-ocean.io/user-guide
.. _`Migration Guide`: https://sites.nemo-ocean.io/user-guide/migration.html
.. _`Change list`: https://sites.nemo-ocean.io/user-guide/changes.html
.. _`Test case repository`: https://github.com/NEMO-ocean/NEMO-examples
.. _`How to cite`: https://www.nemo-ocean.eu/bibliography/how-to-cite/
.. _`NEMO forums`: https://nemo-ocean.discourse.group
.. _`NEMO newsletter`: https://listes.ipsl.fr/sympa/subscribe/nemo-newsletter
.. _`NEMO publications`: https://www.nemo-ocean.eu/bibliography/publications/add
.. _`NEMO projects`: https://www.nemo-ocean.eu/projects/add
.. _`Special Issue`: https://gmd.copernicus.org/articles/special_issue40.html
.. _`NEMO System Team wiki`: https://forge.nemo-ocean.eu/developers/home/-/wikis/Home
.. _`NEMO ocean engine`: https://zenodo.org/record/1464816
.. _`NEMO Tracers engine` : https://zenodo.org/record/1471700
.. _`NEMO Sea Ice engine`: https://zenodo.org/record/1471689
Guillaume Samson's avatar
Guillaume Samson committed

**Welcome to NEMO home page!**
NEMO (*Nucleus for European Modelling of the Ocean*) is a state-of-the-art modelling
framework for research activities and forecasting services in ocean and climate sciences,
developed in a sustainable way by the NEMO European consortium since 2008.
Guillaume Samson's avatar
Guillaume Samson committed

This page intends to help you to get started using the NEMO platform and to introduce you
to the different levels of information available. It starts here with NEMO release 4.2.0.
Claire Levy's avatar
Claire Levy committed

Reminder: Our `Former web platform forge`_ (SVN+Trac) contains the previous documentation
and releases made available from the beginning of the project up to of NEMO 4.0.
Guillaume Samson's avatar
Guillaume Samson committed

Claire Levy's avatar
Claire Levy committed
Getting started
===============
Claire Levy's avatar
Claire Levy committed

Getting your hands on NEMO: the first steps are described in detail in the 
`NEMO users' guide`_ . This explains how to download the code, build the environment, 
create the executable, and perform a first integration.
Claire Levy's avatar
Claire Levy committed

If you are already using a previous release of NEMO, please refer to the 
`Migration Guide`_ which aims to help you to make the move to 4.2.0.

The above users guides cover in detail what is available from gitlab and supported by NEMO
System Team. Aside from this web platform, a set of test cases is also available from the
`Test case repository`_ . These test cases can be useful for students, outreach, and
exploring specific aspects of NEMO with light configurations. The web page also allows you
to submit test cases you have developed and want to share with the community. Feel free to
contribute!
Claire Levy's avatar
Claire Levy committed
Project documentation
=====================

Reference manuals fully describing NEMO  for the three main component
Claire Levy's avatar
Claire Levy committed

* |OCE| models the ocean {thermo}dynamics and solves the primitive equations (`./src/OCE <./src/OCE>`_)
Claire Levy's avatar
Claire Levy committed

* |ICE| simulates sea-ice {thermo}dynamics, brine inclusions and subgrid-scale thickness 
  variations (`./src/ICE <./src/ICE>`_)
Claire Levy's avatar
Claire Levy committed

* |MBG| models the {on,off}line oceanic tracers transport and biogeochemical processes 
  (`./src/TOP <./src/TOP>`_)
Claire Levy's avatar
Claire Levy committed
are available from zenodo

Guillaume Samson's avatar
Guillaume Samson committed
============ ============================================== 
 Component    Reference Manual (from zenondo, DOI to quote) 
============ ============================================== 
 |NEMO-OCE|   `NEMO ocean engine`_                          
 |NEMO-ICE|   `NEMO Sea Ice engine`_                        
 |NEMO-MBG|   `NEMO Tracers engine`_                        
============ ============================================== 
Claire Levy's avatar
Claire Levy committed

These reference manuals are the publications that should be cited in your own
publications. Please visit `How to cite`_? for details.
Claire Levy's avatar
Claire Levy committed

New features of 4.2.0 release are described in the `Change list`_ section of the `NEMO users' guide`_
Claire Levy's avatar
Claire Levy committed

Claire Levy's avatar
Claire Levy committed

Asking questions, and exchanging information
============================================
- Register once for all and use the `NEMO forums`_ on discourse to share and discuss with the NEMO community.
Claire Levy's avatar
Claire Levy committed

- Register once for all and receive by mail the `NEMO newsletter`_ : recommended for all
  users to receive the major announcements from the project (new releases, open meetings and
  main informations). Low traffic: about ten messages a year.
Claire Levy's avatar
Claire Levy committed
Contributing to NEMO visibility: projects and publications
==========================================================
Please help us justifying the NEMO development efforts by
Claire Levy's avatar
Claire Levy committed

-  Adding your publications using NEMO and its outputs to the `NEMO publications`_ page
Claire Levy's avatar
Claire Levy committed

-  Describing your project using NEMO on the `NEMO projects`_ page
Claire Levy's avatar
Claire Levy committed

NEMO also has a `Special Issue`_ in the open-access journal
Geoscientific Model Development (GMD) from the European Geosciences Union
Claire Levy's avatar
Claire Levy committed
The main scope is to collect relevant manuscripts covering various topics and
to provide a single portal to assess the model potential and evolution.


Guillaume Samson's avatar
Guillaume Samson committed

Claire Levy's avatar
Claire Levy committed
Contributing to NEMO development
================================
Guillaume Samson's avatar
Guillaume Samson committed

NEMO strives to be written in a way which allows the easy incorporation of developments.
You are welcome to contribute to the development of the NEMO Shared reference.  NEMO
development is driven by  NEMO Consortium planning and producing NEMO's sustainable
development in order to keep a reliable evolving framework.  Development is organised and
scheduled through a five years development strategy, Working groups and the activities of
the development team (named NEMO System Team) in a yearly workplan. More information is
available on the `NEMO System Team wiki`_
Guillaume Samson's avatar
Guillaume Samson committed


Disclaimer
==========

The NEMO source code is freely available and distributed under
`CeCILL v2.0 license <./LICENSE>`_ (GNU GPL compatible).
Guillaume Samson's avatar
Guillaume Samson committed

You can use, modify and/or redistribute the software under its terms,
but users are provided only with a limited warranty and the software's authors and
the successive licensor's have only limited liability.