Extract the OpenIFS package
Create your local installation of OpenIFS 48R1.0 by cloning or branching from the git repository with the OpenIFS package. The location will be your new OIFS_HOME place.
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
Please note that currently access to this repository is restricted to a limited number of users.
Build OpenIFS
The $OIFS_HOME/bin/openifs-test.sh script can be used to build the model and run initial tests.
- 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:
cd $OIFS_HOME ./bin/openifs-test.sh -cbt
Note: It is normal to see warnings during the build process.
This will build 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 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.
We recommend that you include the following command in your shell configuration file (e.g. .bashrc):
source /path/to/configfile/oifs48r1-config.sh
This command should also be include in any batch job scripts that are intended to run OpenIFS.
Run a forecast experiment
Extract the example forecast experiment i4xc.tgz
into a location suitable for model experiments.
Note: The experiment directory would ideally be in a separate location from the earlier model installation path $OIFS_HOME. You will need more disk space depending on the duration of the forecast experiment.
Example: In our example on the ECMWF hpc2020 the model installation $OIFS_HOME is in $HOME/openifs
and we extract the i4xc package in $PERM, and the experiment directory shall therefore be $PERM/i4xc/2016092500
.