Versions Compared

Old Version 171

changes.mady.by.user Marcus Koehler

Saved on

compared with

New Version 172

changes.mady.by.user Marcus Koehler

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This page contains a guide for building and using OpenIFS 48r1 at model version 48R1.01.

We describe how to build the model and carry out a few basic tests, how to run an example forecast experiment, for which initial experiment data is made available, and how to visualise the model output by creating plots.

Info

Worked Example:

We explain the model installation and the process of running of a forecast experiment on the ECMWF Atos Sequana XH2000 HPC facility (hpc2020). 

  • All data files and configuration scripts that are required for the worked example experiment described in this guide can be found on the ECMWF file system here:  /perm/openifs/oifs_data/48r1/example
  • The model will be installed into $HOME/openifs-48r1.01/
  • The example forecast experiment will be set up in directory $PERM/i4xc/

It is important to note that the installation process on hpc2020 will not directly translate to alternative systems

...

Create your local installation of OpenIFS 48R1.0 by 1 by cloning or branching from the git repository with the OpenIFS package. 

Code Block
languagebash
themeMidnight
git clone --single-branch --branch release ssh://git@git.ecmwf.int/oifs/openifs-48r1.01.git


Note
  • You will need approximately 4 GB of disk space for the model sources, the bundle packages, and the built model binaries. 
  • Please note that currently access to this repository is restricted to a limited number of users only.

...

Code Block
languagebash
themeMidnight
export OIFS_HOME=$HOME/openifs-48r1.01/

The other model environment variables are

...

Code Block
languagebash
themeMidnight
source /path/to/file/location/oifs-config.edit_me.sh
# using our installatino example:
# source $HOME/openifs-48r1.01/oifs-config.edit_me.sh

We recommend to include this command in your Linux shell startup configuration (e.g. in .bashrc). 

...

Example: 
On the ECMWF hpc2020 our model installation $OIFS_HOME will be in $HOME/openifs-48r1.0 1 and for the experiment we extract the i4xc package to $PERM. The experiment directory shall therefore be $PERM/i4xc/2016092500. 

...

    • It is important to change "/path/to/your/config/oifs-config.edit_me.sh" to the actual path for the oifs-config.edit_me.sh, e.g., "$HOME/openifs-48r1.01/oifs-config.edit_me.sh"
    • The default resources requested in run.ecmwf-hpc2020.job are  8 nodes on the ECMWF hpc2020 machine, with a total of 256 MPI tasks and 4 OpenMP threads. This can be changed as required.
    • For information, the LAUNCH command for batch job submission is set to "srun" without any further options, because all required parallel environment settings are provided through the SLURM script headers.

...