Version 2 (modified by annette, 4 years ago) (diff)


Instructions for running the ShaCoNEMO ORCA1 configuration on ARCHER.


You need to register with the NEMO website to extract the code:

The ORCA1 configuration is held in the ShaCoNEMO repository. You need to register for access, and this uses the same username and password as the main NEMO repository.

To create a branch to hold your code changes on the NEMO repository, you will need additional permissions.


The main NEMO website gives more general instructions on building & running NEMO with the standard confgurations included in the code:

The ORCA1_LIM3_PISCES configuration is documented on the ShaCoNEMO (Shared Configuration NEMO) wiki:

  • LIM3 is the sea-ice
  • PISCES is the biogeochemical model

NEMO uses an external library to handle model output diagnostics calkled XIOS, which is documented here:

Code versions

Here we have used the following versions, based on the NEMO/ShaCoNEMO pages:

  • XIOS-1.0 r703
  • NEMO_3.6_stable r6969
  • ShaCoNEMO r60
  • ORCA1 input data set v9

Note: Although XIOS-2.0 is now recommended, revision 932 which is suggested for ORCA1 gave a link-time error which was not investigated.

Code extract

First you need to check out the code from the NEMO repository.

  1. On ARCHER, navigate to the directory that you wish to hold the code. If you are making changes to the standard configuration, you may wish to use the home directory as this is backed up.
  1. To checkout the code to a directory called NEMOGCM_3.6_r6969, run the following, replacing mylogin with your NEMO username (you will be prompted for your password):
    svn --username "mylogin" co -r6969 NEMOGCM_3.6_r6969

This creates a subversion "working copy". Running svn info lists the revision that was checked out, and svn diff lists the changes that have been made.

  1. To setup and extract the ORCA1 configuration:
    cd NEMOGCM_3.6_r6969/CONFIG

Then edit cfg.txt to add the line:

  1. Next checkout the ORCA1 configuration using the same username (mylogin) and password as for the NEMO checkout:
    svn --username "mylogin" co

This creates the directory ORCA1_LIM3_PISCES, which is another "working copy".

Code build

To build NEMO, you need to point to the location of XIOS, and the parallel-netCDF libraries. A version of XIOS-1 can be found here:


To build your own XIOS, see the notes below.

It is advisable to build NEMO with the same key modules as the library:

  • cce/8.4.1
  • cray-netcdf-hdf5parallel/
  • cray-mpich/7.2.6
  1. Navigate to the directory holding the build definition files:
    cd NEMOGCM_3.6_r6969/ARCH
    Then copy in the new ARCHER file arch-XC30_NCAS_ARCHER.fcm.
    cp /work/n02/n02/annette/nemo/NEMOGCM_3.6_r6969/ARCH/arch-XC30_NCAS_ARCHER.fcm . 

Working practices

Use of home Branches

Building XIOS

Attachments (3)

Download all attachments as: .zip