Skip to end of metadata
Go to start of metadata

The OpenIFS models run on a variety of Unix based systems: Unix/Linux, Mac OS X. There is no support for running under Windows.

Common requirements

The OpenIFS model, Single Column Model (SCM) and the Offline Surface Model (OSM) (HTESSEL) all require the following in order to build and run. Most of these should be available as standard on Unix/Linux systems:

bash - the scripts accompanying the package make use of the Bash shell.

perl - is required for the FCM software used to compile the models. Some additional perl modules may be required for FCM (see below).

fortran & C compilers - many Linux/Unix systems come with gfortran/gcc by default which work well with the OpenIFS models. High Performance Computer facilities may provide other compilers which achieve better performance. The fortran compiler must support an auto-double (e.g. -r8) capability as some source code files are in fixed format fortran.
The OpenIFS model can make use of OpenMP if it is supported on your system (multicore) and compilers but this is optional. Note that if OpenMP is used then the version of MPI used should be thread-safe.

lapack & blas libraries - these are usually available on all flavours of Linux/Unix. Some systems, notably HPC installations will have special optimized versions of these libraries. These should be used instead (if a version exists for your choice of compiler) to achieve a better performance. You may need to modify the compile configuration to access these optimized libraries.
If the lapack/blas libraries are not available or you choose not to use them, OpenIFS comes with the necessary lapack code. This is disabled by default, see README.lapack file in openifs distribution for instructions on how to use this option.

grib-api/eccodes  - the grib-api library or its replacement eccodes library and accompanying set of commands for working with and manipulating GRIB files. GRIB is the file format used as input and output for OpenIFS.  See the grib_api for OpenIFS install page for more details on how to build grib_api for the OpenIFS models. If using eccodes, some model code changes for older OpenIFS versions may be necessary. See install page for more details.

Perl modules required

Software called FCM is used to compile the model. FCM is provided with OpenIFS. However, note that it may need additional Perl modules installed. The most likely missing modules are: XML::ParserCheck and Time::Piece.

To check a Perl module is installed e.g. XML::Parser, type the command perl -MXML::Parser -e 1. If the module is not installed this will cause an error.

For help with installing missing Perl modules either see the CPAN module page or ask your local support team. ECMWF cannot provide assistance in installing Perl on your machine.

OpenIFS model additional requirements

OpenIFS requires the following in order to build and run:

mpi library - an implementation of MPI must be available on your system. It can either be vendor supplied or one of the freely available versions such as MPICH or OpenMPI.

python - is required to run some of the tools. Python 2.7 is recommended.

Single column model additional requirements

netCDF - an implementation of netCDF must be available on the system as the models read/write netcdf format.

IDL - optionally requirement as some sample scripts are provided to plot the model output.

Offline surface model additional requirements

netCDF - an implementation of netCDF must be available on the system as the models read/write netcdf format