Versions Compared

Key

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

...

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

Installing the model sources and building the model (including acceptance tests) requires 3-4 GB of disk space. The additionally required climatological data packages are not yet included; their installation is described below and will require further disk space.  

...

  • create a new home for the OpenIFS/AC installation, e.g. a directory called  . Here we call this location /home/openifs-ac.   
  • change into your new directory and unpack therein the original OpenIFS model sources:   tar xvzf oifs43r3v2.tgz
  • in a second step, in the same folder unpack the OpenIFS/AC sources:  tar xvzf openifs-ac.43r3.v1.tgz

...

Info

Note that this unpacking will not only add new files into your existing $OIFS_HOME but it will also overwrite some of the existing files with new version required for OpenIFS/AC.

...

Obtaining additional data packages

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

  • change OIFS_HOME to point to the installation of openifs-ac (and not to the standard oifs43r3 installation)
  • change OIFS_DATA_DIR to a bespoke path as the additional data packages will be added to the climate data files; we describe below what date needs to be moved to this directory
  • before compiling the model sources edit $OIFS_HOME/make/oifs.fcm to enable chemistry (which is by default disabled)

It is recommend for the first two changes to use a custom configuration script to set the environment variables.

Alternatively the settings can be enabled when running the prep scripts that come with OpenIFS/AC:  For the t21 acceptance tests, the environment variables and paths are set within the oifs-config.<platform>.sh which needs to be edited in the  platform  subdirectory. This is described below.

Obtaining additional data packages

addition to the enhancements of the model sources, OpenIFS/AC also requires additional external data to carry out forecast experiments (e.g. climatological data for boundary conditions, fluxes for emitted chemical compounds, etc). This data will complement the data found usually in the $OIFS_DATA_DIR location.

Info

Note:  It is recommended to create a new OIFS_DATA_DIR directory specifically for use with OpenIFS/AC which is kept separate from the data directory for the meteorological model.

As a next step you should: 

  • create a new directory which will contain the Create a new directory (here we name this directory /data/openifs-ac) which will contain additional data that is required for atmospheric composition modelling and it will also contain the new OIFS_DATA_DIR.  .  Here we call this location /data/openifs-ac
  • download the required Download the four additional data tgz archives that are required for OpenIFS chemistry experiments into /data/openifs-ac :
    ${datapath}=/nm6/oifs/.  The following commands will work on the Atos HPC:

    No Format
    cd /data/openifs-ac
    module load ecfs
    ecp ec:${datapath}/nm6/oifs/oifs-ac-43r3-chem.tgz .  
    ecp ec:${datapath}/nm6/oifs/oifs-ac-43r3-xtra.tgz .
    ecp ec:${datapath}/nm6/oifs/oifs-ac-43r3-initcond.tgz .
    ecp ec:${datapath}//nm6/oifs/ICMCL-2010.tgz .


  • Unpack oifs-ac-43r3-chem.tgz and oifs-ac-43r3-xtra.tgz into /data/openifs-ac. This will result in the following directory structure inside /data/openifs-ac : 

...

  • Unpack oifs-ac-43r3-initcond.tgz into /data/openifs-ac which results in a directory /data/openifs-ac/INITIAL-CONDITIONS. The files therein are initial data files for the first day of month for all 12 months of 2010.
  • Unpack ICMCL-2010.tgz into /data/openifs-ac which results in a directory /data/openifs-ac/ICMCL. This directory contains monthly files with surface boundary conditions (e.g. SSTs, soil temps, albedos, LAI etc).
  • From you conventional OpenIFS installation's OIFS_DATA_DIR copy the directories ifsdata and rtables to /data/openifs-ac/43r3 as they are also needed here.
  • Further, create a directory /data/openifs-ac/43r3/wam which needs to contain wave model initial data for 2010-01-01.  (presently files are copied over from cca:/lus/snx11062/scratch/ms/nl/nm6/ECE-DATA/OPENIFS/43r3)

Environment settings

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

  • change OIFS_HOME to point to the installation of openifs-ac (and not to the standard oifs43r3 installation)
  • change OIFS_DATA_DIR to a bespoke path as the additional data packages will be added to the climate data files; we describe below what date needs to be moved to this directory
  • before compiling the model sources edit $OIFS_HOME/make/oifs.fcm to enable chemistry (which is by default disabled)

It is recommend for the first two changes to use a custom configuration script to set the environment variables.

Alternatively the settings can be enabled when running the prep scripts that come with OpenIFS/AC:  For the t21 acceptance tests, the environment variables and paths are set within the oifs-config.<platform>.sh which needs to be edited in the  platform  subdirectory. This is described below.

Building the model

On the ECMWF Bull Atos Sequana HPC it is possible to compile the model using a login node. However, in order to complete the acceptance testing with chemistry an interactive node should be requested.

...