You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

This page contains a guide to the building and running a Single-Column Model (SCM), which is derived from OpenIFS 48r1.

Installing and building the SCM

The SCM source code is extracted and installed alongside OpenIFS. Thus, if not done already, to install the SCM please follow the instructions detailed in Getting started.

In short the once the source code is extracted and installed from https://sites.ecmwf.int/openifs/openifs-data/src/48r1/openifs-48r1.tar.gz, then the code can be built using the following

# load the OpenIFS and SCM environment variables
source /path/to/file/location/oifs-config.edit_me.sh
# using our installation example:
# source $HOME/openifs-48r1.1/oifs-config.edit_me.sh

# change to the home directory for OpenIFS and SCM 
cd $OIFS_HOME
# Use the openifs-test.sh script to build and automatically test OpenIFS and the SCM
$OIFS_TEST/openifs-test.sh -cbt

The above commands assume that the base prerequisites for OpenIFS and the SCM are installed on the system. This is the case on the ECMWF Atos Sequana XH2000 HPC facility (hpc2020) but on other systems, the prerequisites need to be installed. A description/recipe for the prerequisites can be found on the Getting started on docker page.

Once successful, the above commands will build double and single precision SCM executables (MASTER_scm.DP and MASTER_scm.SP, respectively), which are used to run the SCM derived from OpenIFS. The executables are located in  $OIFS_HOME/build/bin.

  • The location and name of the executable for the SCM is defined in the platform configuration file (oifs-config.edit_me.sh) as $SCM_EXEC

Download and extraction of the OpenIFS 48r1 sources tarball is only required if a user has not previously done this for a general OpenIFS install.

If a user has already downloaded the OpenIFS package to install the 3D model, there is no need to extract the package again, since the SCM is packaged with OpenIFS. 

Running the SCM

Before the SCM can be run, it is necessary to

  • obtain and extract the SCM test-case package.
  • source the oifs-config.edit_me.sh to load the SCM environment variables

Extract SCM test-case package

In a similar fashion to the OpenIFS package and the experiment data, the SCM test-case package can be download from https://sites.ecmwf.int/openifs/openifs-data/scm/48r1/scm_openifs_48r1.1.tar.gz. Please note that access to this web site is restricted to registered OpenIFS users, i.e. your personal ECMWF account must have been added to the OpenIFS user policy.

In the example below we assume that the SCM package shall be installed in the user's HOME directory, and that the wget utility is available for convenient download: 

cd $HOME
wget https://sites.ecmwf.int/openifs/openifs-data/scm/48r1/scm_openifs_48r1.1.tar.gz
tar -xvzf scm_openifs_48r1.tar.gz

The untarred SCM package is small, ~45 Mb and data produced by a standard individual SCM simulation is also low. However, if I user is planning to perform many simulations and store the data, which is often the case, the disk space usage can become large. If this is the plan, then a user may need to consider installing the SCM test-case package on a larger disk area than HOME. 



  • No labels