Versions Compared

Key

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

...

Obtaining and compiling the code

This section contains information about where the source code package for OpenIFS/AC can be obtained and how the sources should be installed.

Working with the ftp server

In order to convert the standard OpenIFS model to OpenIFS/AC the additional software package for composition needs to be installed into an existing OpenIFS installation.

If both standard (meteorological) model and the atmospheric composition model are to be used at the same time, it is recommended to create a new OIFS_HOME directory for OpenIFS/AC and to first unpack the standard OpenIFS model sources into this directory (for instance, if the standard OpenIFS model is installed into directory 'oifs43r3', the new destination for the model sources could be extracted into directory 'openifs-ac').

Once the standard OpenIFS model code is unpacked, unpack package <package-name> into $OIFS_HOME, overwriting any pre-existing files from the standard model installation.

TO DO:  we need a separate code package for the OpenIFS/AC code that can be unpacked into the existing OpenIFS 43r3v2 source code distribution

Working with the git repository

OpenIFS/AC is maintained in Philippe Le Sager's ECMWF git repository: https://git.ecmwf.int/users/nm6

...

You need to connect to the ECMWF ftp server to download the source package for OpenIFS/AC.  If your institution has signed the OpenIFS license agreement then you can request the ftp password by emailing openifs-support@ecmwf.int.

You can either convert your existing OpenIFS installation or create a new installation for OpenIFS/AC.  We recommend the latter and in this case you will also need the sources for the OpenIFS model (oifs43r3v2) which can be found on the ftp server. 

Connecting to the ECMWF ftp server and how to obtain OpenIFS 43r3 sources is described here in the OpenIFS User Guide.

No Format
ftp ftp.ecmwf.int
username: openifs
password:  
cd src/openifs-ac
get openifs-ac.43r3.v1.tgz
bye

Installing the OpenIFS-AC sources

In order to convert the standard OpenIFS model to OpenIFS/AC the additional software package for composition needs to be installed into an existing OpenIFS installation:

  • change into your $OIFS_HOME directory where OpenIFS is installed:  cd $OIFS_HOME
  • in this directory extract the downloaded source package:   tar xvzf openifs-ac.43r3.v1.tgz
    Note that this unpacking will not only add new files into $OIFS_HOME but it will also overwrite some of the existing files with new version required for OpenIFS/AC

If both the standard (meteorological) model and the atmospheric composition model are to be used at the same time, it is recommended to create a new directory for the OpenIFS/AC installation and to unpack the standard OpenIFS model sources into this directory (for instance, if the standard OpenIFS model is installed into directory 'oifs43r3', the new destination for the model sources could be extracted into directory 'openifs-ac').

Once the standard OpenIFS model code is unpacked, unpack package  openifs-ac.43r3.v1.tgz  into $OIFS_HOME, overwriting any pre-existing files from the standard model installation.

Environment settings

In order to build OpenIFS/AC the standard environment settings for oifs43r3v2 can be used with the application of two changes:

...