...

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

We describe the process how to build the model from sources 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.

Extract the OpenIFS package

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

You will need approximately 4 GB of disk space for the model sources, the bundle packages, and the built model binaries. 

git clone ssh://git@git.ecmwf.int/~daha/openifs-main-git.git

Set up the platform configuration file

For proper functionality the The OpenIFS model requires a small number of Linux environment variables to be set . for both installation and runs. These are referred to as global environment variables.

The most important environment variable is OIFS_HOME, which describes the location of the OpenIFS model installation. This variable is required by all scripts used by the model. 

 OIFS_HOME describes the location of the OpenIFS model installation and is general Hence, the path where the git repository was extracted will need to be set to OIFS_HOME. For was extracted.  For example, if you clone the repository into your $HOME directory then you should set:

export OIFS_HOME=$HOME/openifs/openifs_48R1.0/

The other model environment variables are

• OIFS_CYCLE - describes the model cycle (e.g. 48r1) for which this configuration file can be used

...

• .
• OIFS_DATA_DIR - describes the location of climatological input files that are required to run OpenIFS. These have been installed on the ECMWF hpc2020 in a central and accessible location under /perm/openifs/oifs_data and the information is organised by model cycle. 

Platform configuration file:  The required global environment variables, described above, are defined in a the Platform configuration file that , which needs to be modified for your local OpenIFS installation. 

• This file can be located anywhere on your file system, however the recommended default location would be somewhere in is $OIFS_HOME/bin installation.
• We provide a template for this configuration file in $OIFS_HOME/bin/oifs-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.

Please note that this file is not executed, instead it is loaded by using the Once edited the platform configuration file is loaded using the following command:

source /path/to/file/location/oifs-config.edit_me.sh

...

The above command should also be include in any batch job scripts that are intended to run OpenIFS .(described in Section 3)

...