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.
Users/ModelInstall – NEMO
wiki:Users/ModelInstall

Version 2 (modified by gmattia, 7 years ago) (diff)

First draft

Install the modelling framework (NEMO and XIOS)

1-1 Extract the NEMO code

Using your "my_login" /pw registered on this web site:

svn --username "mylogin" co http://forge.ipsl.jussieu.fr/nemo/svn/branches/2015/nemo_v3_6_STABLE/NEMOGCM



1-2 Extract and install XIOS2

http://www.nemo-ocean.eu/Using-NEMO/User-Guides/Basics/XIOS-IO-server-installation-and-use (and come back to this page afterwards to create NEMO executable!)

1-3 Compile and create NEMO executable


The main script to compile and create executable is called makenemo and located in the CONFIG directory.To identify the source code you need, build the makefile and run it.

As an example, compile GYRE, with ifort on linux to create a MY_GYRE configuration:

cd NEMOGCM/CONFIG; ./makenemo –m ifort_linux –r GYRE -n MY_GYRE



More options:

  • –n CONFIG : for configuration name, existant or new config to install
  • –m COMPILER : compiler choice (use files names in NEMOGCM/ARCH, see examples below)
  • –h help
  • –r REFCONFIG : reference configuration as first guess when installing a new one
  • –j 4 : number of processes to compile (j=0 :no compilation)
  • –d “ “ : NEMO subdirectory (not needed)
  • –t DIR : temporary directory to store libraries
  • -clean [CONFIG_NAME] : remove the Makefile and all the files created afterwards


At the first use, you need the -m optionto specifiy compiler, its options and libraries, then for next compilation, it is assumed you will be using the same compiler If –n option s not specified, ORCA2_LIM is the default configuration used. -d option has been implemented for use in non-interactive shell The WORK directory is created under each configuration directory.

Tools used during the process:

  • functions.sh : bash functions used by makenemo, for instance to create the WORK directory
  • cfg.txt : text list of configurations and source directories
  • bld.cfg : FCM rules to compile

Description of directories :

  • ARCH : compilation option files, with format arch_compiler.fcm, the compiler name has to be provided with –m option
  • GYRE, ORCA2_LIM or others : there is now a cpp.fcm file containing the list of cpp key, the WORK is specific to each configuration

Attachments (2)

Download all attachments as: .zip