Versions Compared

Key

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

...

  • This file can be located anywhere on your file system, however the recommended default location would be somewhere in $OIFS_HOME/bin installation.
  • We provide a template for this configuration file in $OIFS_HOME/bin/oifs48r1oifs-config.edit-_me.sh.
  • You should edit this file and update the path set in variable OIFS_HOME with your installation's path.
  • This file sets global variables for your model installation, depending on your local system, and it will need to be "sourced" prior to running the model.

...

Code Block
languagebash
themeMidnight
source /path/to/file/location/oifs48r1oifs-config.edit-_me.sh

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

 Build OpenIFS

In the next step the model binary executable (and other helper programs) will be built.

OpenIFS build system

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

The above command should also be include in any batch job scripts that are intended to run OpenIFS.

Info

Previous versions of the OpenIFS model also used a platform configuration file. Since OpenIFS 48r1 the number of variables set inside this file has been reduced to a bare minimum. At present, only the variables OIFS_HOME. OIFS_CYCLE, and OIFS_DATA_DIR need to be set in this file. 

 Build OpenIFS

In the next step the model binary executable (and other helper programs) will be built.

OpenIFS build system

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

OpenIFS 48r1 is further OpenIFS 48r1 is further distributed with a software bundle which automatically installs many required software packages during the build process, such as for instance 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. 

...

  • Edit the script and in line 16 set the location of your $OIFS_HOME directory which is the location where you have extracted the git repository and where this script should be located.
  • 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 command:

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.

  Set up the platform configuration file

You will need to set up a platform configuration file for your OpenIFS installation.

  • This file can be located anywhere but the recommended location would be somewhere inside your $OIFS_HOME installation.
  • This file sets global variables for your model installation, depending on your local system, and it will need to be "sourced" prior to running the model.
  • We provide a template for this configuration file in $OIFS_HOME/bin/oifs48r1-config.sh. You should edit this file and update variable OIFS_HOME with your installation's path.
Info

Previous versions of the OpenIFS model also used a platform configuration file. Since OpenIFS 48r1 the number of variables set inside this file has been reduced to a bare minimum. At present, only the variables OIFS_HOME. OIFS_CYCLE, and OIFS_DATA_DIR need to be set in this file. 

  • or gnu). The default is intel. 

Run the build process and the tests using the following command:We recommend that you include the following command in your shell configuration file (e.g. .bashrc): 

Code Block
languagebash
themeMidnight
sourcecd /path/to/configfile/oifs48r1-config.sh

...

$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. 

 Set up a forecast experiment

...