Versions Compared

Old Version 22

changes.mady.by.user Marcus Koehler

Saved on

compared with

New Version Current

changes.mady.by.user Marcus Koehler

Saved on

Key

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


The OpenIFS model is based on the ECMWF operational Integrated Forecast System (IFS). It is identical to IFS in forecast capability, the difference is the data assimilation and observation handling capability is not available.

This user guide covers a brief description of the installation and use of the 3D global forecasting model and the Single-Column Model of OpenIFS 48r1 at model version 48R1.1. It does not deal in detail with the scientific and technical formulation of the model. Such information is available in the references listed in the OpenIFS Documentation section of the OpenIFS website.

Panel
bgColor#e6fdff


Section


Column
width50px


HTML Comment
hiddentrue

the only reason this column is here is to right-indent the page-tree macro, which ignores all attempts to centre-align, indent, etc.



Column

Page Tree
expandCollapseAlltrue
root@self
startDepth2
searchBoxtrue

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. 

Code Block
languagebash
themeMidnight
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:

Code Block
languagebash
themeMidnight
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): 

Code Block
languagebash
themeMidnight
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. 

Info

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.

...