Versions Compared

Key

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

...

In 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. The data volume for the standard distribution of OpenIFS/AC is approximately 21 GB. 

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.

...

  • create a new directory which will contain the 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 four additional data tgz archives into /data/openifs-ac.  The following commands will work on the Atos HPC:

    No Format
    cd /data/openifs-ac
    module load ecfs
    ecp ec:/nm6/oifs/oifs-ac-43r3-chem.tgz .  
    ecp ec:/nm6/oifs/oifs-ac-43r3-xtra.tgz .
    ecp ec:/nm6/oifs/oifs-ac-43r3-initcond.tgz .
    ecp ec:/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 : 

    43r3/chemistryAC specific
    43r3/xdataAC specific
    43r3/rtablesStandard dataset for OpenIFS 43r3
    43r3/climate.v015Standard dataset for OpenIFS 43r3 + AC specifics
    43r3/ifsdataStandard dataset for OpenIFS 43r3
    43r3/wamWave model data for OpenIFS 43r3, needs to be added explicitly 


The following two tgz archives can be unpacked to any location, however in this example the files we will also extract them into /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:

Similar to the standard OpenIFS model, OpenIFS/AC requires system and user software libraries (e.g. eccodes, netcdf, etc) and relies on shell environment variables which need to be set. In order to avoid duplication of documentation we refer to the OpenIFS User Guide as the prerequisites for OpenIFS are also valid for OpenIFS/AC.  For environment variable settings please see here

Info

We recommend to begin with a successfully tested local environment for OpenIFS, and work from there to make adjustments for OpenIFS/AC. 

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 your installation of openifs-ac (and not to the standard oifs43r3 installation), in our example /home/openifs-ac
  • change $OIFS_DATA_DIR to the location with the additional data packages, in our example /data/openifs-ac
  • 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.to apply the first two changes in $OIFS_HOME/oifs-config.editme.sh and to activate the settings with the command:  source ./oifs-config.editme.sh before attempting to build the model. 

In order to run OpenIFS/AC a number of further changes and additions to the environment are requiredAlternatively 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.

...