Versions Compared

Key

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

...

Info

Worked Example:

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

  • All data files and configuration scripts that are required for the worked example experiment described in this quickstart guide can be found on the ECMWF file system here:  /perm/openifs/oifs_data/48r1/example
  • The model will be installed into $HOME/openifs/openifs_48R1.0/
  • 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

...

Code Block
languagebash
themeMidnight
cd $OIFS_HOME
./bin/openifs-test.sh -cbt
Info

It is normal to see warnings during the build process.

The script builds the model binaries for the selected compiler and will run the ifs-test t21 and t42 tests. 

...

where

  • -c cleans up the directory, i.e, remove any existing build, source, ecbundle directories
  • -b builds 
    • the OpenIFS double and single precision master executables (ifsMASTER.DP and ifsMASTER.SP, respectively) , which are used to run 3-D OpenIFS. The executables are located in  $OIFS_HOME/build/bin.
    • the double and single precision Single Column Model (SCM) executables (MASTER_scm.DP and MASTER_scm.SP, respectively), which are used to run the SCM derived from OpenIFS. The executables are located in  $OIFS_HOME/build/bin.
  • -t  will run the ifs-test t21 tests, which comprise of
    • 21 3-D OpenIFS forecast-only tests with and without chemistry
    • 1 SCM test (based on TWP-ICE)
Info

By default, on hpc2020, OpenIFS will be built using the intel compiler. OpenIFS will also build with GNU, if this is required then the user should execute the following command

./bin/openifs-test.sh -cbt -e gnu 

This will load the compiler environment for gnu 11.2.

If everything has worked correctly then all tests should have passed and the script returns the following

Code Block
languagebash
themeMidnight
[INFO]: Good news - ctest has passed
        openifs is ready for experiment and SCM testing
----------------------------------------------------------------
END ifstest on OpenIFS build

 Set up a forecast experiment

...