Versions Compared

Key

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

...

In contrast to earlier model versions, the building of OpenIFS 48r1 is no longer based on the FCM configuration manager, but uses from now ; instead, the build system for OpenIFS is now based on the ecbuild ECMWF build system that is also same ecbuild / CMake system used for the ECMWF IFS model, and which uses CMake at its core.

Similar to the IFS, OpenIFS 48r1 is further distributed with also employs a software bundle which, as part of the build process, automatically finds, downloads and installs many of the required software packages during the build process, such as for instance , e.g., ecbuild, ecCodes, metkit, etc. Hence, a separate installation of these libraries is no longer required as they have now become part of the OpenIFS distribution. 

Starting the build process

The  $OIFS_HOME/scripts/build_test/openifs-test.sh  script can be used to build the model and run initial tests. 

  • The script requires key environment variables, such as $OIFS_HOME, to be assigned. Make sure you have sourced the platform configuration script first.
  • The usage of the script is shown with the command:  openifs-test.sh -h
  • The option -e defines the compiler environment (intel or gnu). The default is intel. 

Run the build process and the tests using the following commandcommands (assumes the platform configuration file has been sourced) :

Code Block
languagebash
themeMidnight
cd $OIFS_HOME
.$OIFS_TEST/scripts/openifs-test.sh -cbt

where

  • $OIFS_TEST is defined in the platform configuration file (oifs-config.edit_me.sh) as $OIFS_HOME/scripts/build_test 
  • -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)

...