...
This page contains a guide for building and using OpenIFS 48r1 at model version 48R1.01.
We describe how to build the model and carry out a few basic tests, how to run an example forecast experiment, for which initial experiment data is made available, and how to visualise the model output by creating plots.
Info |
---|
Worked Example: We explain the model installation and the process of running of a forecast experiment on the ECMWF Atos Sequana XH2000 HPC facility (hpc2020).
It is important to note that the installation process on hpc2020 will not directly translate to alternative systems |
...
Create your local installation of OpenIFS 48R1.0 by 1 by cloning or branching from the git repository with the OpenIFS package.
Code Block | ||||
---|---|---|---|---|
| ||||
git clone --single-branch --branch release ssh://git@git.ecmwf.int/oifs/openifs-48r1.01.git |
Note |
---|
|
...
Code Block | ||||
---|---|---|---|---|
| ||||
export OIFS_HOME=$HOME/openifs-48r1.01/ |
The other model environment variables are
...
Code Block | ||||
---|---|---|---|---|
| ||||
source /path/to/file/location/oifs-config.edit_me.sh # using our installatino example: # source $HOME/openifs-48r1.01/oifs-config.edit_me.sh |
We recommend to include this command in your Linux shell startup configuration (e.g. in .bashrc).
...
Example:
On the ECMWF hpc2020 our model installation $OIFS_HOME will be in $HOME/openifs-48r1.0 1
and for the experiment we extract the i4xc package to $PERM. The experiment directory shall therefore be $PERM/i4xc/2016092500
.
...
- It is important to change
"/path/to/your/config/oifs-config.edit_me.sh"
to the actual path for theoifs-config.edit_me.sh,
e.g.,"$HOME/openifs-48r1.01/oifs-config.edit_me.sh"
- The default resources requested in
run.ecmwf-hpc2020.job
are 8 nodes on the ECMWF hpc2020 machine, with a total of 256 MPI tasks and 4 OpenMP threads. This can be changed as required. - For information, the
LAUNCH
command for batch job submission is set to "srun
" without any further options, because all required parallel environment settings are provided through the SLURM script headers.
- It is important to change
...