License
OpenIFS is provided free-of-charge and licenses are usually per institution.
Only licensed users are provided with the username and password to access the ftp site. For more information, or to request a license, please email: openifs-support@ecmwf.int.
OpenIFS directory layout
The model will unpack into a directory called 'oifs'. The directory structure for the OpenIFS model and code will depend on local installation requirements. A suggested directory structure has all source code and data organised under a single directory 'oifs'. If desired, the grib_api could also be installed under the oifs directory but it's recommended it is placed elsewhere.
All the files related to the OpenIFS models are available from the ftp site: ftp.ecmwf.int. If you do not have ftp site password, please email : openifs-support@ecmwf.int. Only licensed institutes are provided with access. The OpenIFS models are distributed as compressed tarfiles and include source code, datafiles and supporting software. Once logged into the ftp site you will see the following directories: User group specific space. Model initial files provided for users will be found here.OpenIFS ftp site
Contents of ftp.ecmwf.int Description data/ OpenIFS data files; climate files, vtables, rtables and namelist. src/openifs OpenIFS source code tar files. src/scm Single Column model code and files. src/osm-htessel Offline Surface Model (HTESSEL) code and files. metview Metview macros for use with OpenIFS. user_workshops Files used in OpenIFS user workshops. users/
Contents of directory src/openifs: | Description |
---|---|
40r1/ | Contains OpenIFS versions based on Cycle 40 Release 1 of the operational IFS. |
43r3/ | Contains OpenIFS versions based on Cycle 43 Release 3 of the operational IFS. |
Download source code for OpenIFS 40r1
To obtain the source code from the ftp site, change directory to the '40r1' directory and retrieve the latest source code (the filename may be different):
% ftp ftp.ecmwf.int user: openifs pass: <enter the password given to you by openifs-support> cd src/openifs/40r1 ls get oifs40r1v2.tar.gz quit
% lftp ftp.ecmwf.int lftp ftp.ecmwf.int:~> set ftp:ssl-allow no lftp ftp.ecmwf.int:~> user openifs Password: <enter the password lftp openifs@ftp.ecmwf.int:/> cd src/openifs/40r1 lftp openifs@ftp.ecmwf.int:/src/openifs/40r1/> get oifs40r1v2.tar.gz lftp openifs@ftp.ecmwf.int:/src/openifs/40r1/> exit
Unpack OpenIFS source code
To unpack the gzipped tarfile:
% tar zxf oifs40r1v2.tar.gz
If your version of the 'tar' command does not support gzipped archives then do it in two stages:
% gzip -d oifs40r1v2.tar.gz % tar xf oifs40r1v2.tar
OpenIFS git repository
A git repository for OpenIFS is hosted by ECMWF. This is intended for developers and contributors to the OpenIFS model and is not generally accessible.
For more information please contact: openifs-support@ecmwf.int.
Download data files
The data directory contains the following gzipped tarfiles, all of which should be downloaded.
Contents of directory data: | Description |
---|---|
40r1/ | Contains data files for versions of OpenIFS 40r1. |
43r3/ | Contains data files for versions of OpenIFS 43r3. |
These files are the same for all OpenIFS experiments. To save space for multiple users, it's recommended they are placed somewhere central and not copied to each user run directory. The sample job scripts provided assume that links are created from these files to the user run directory.
We suggest creating a directory ifsdata somewhere and unpacking the files there.
Filename | Size | Description |
---|---|---|
<version>/ifsdata_climatology_<version>.tgz | 15Mb | Contains the various long-lived gases and aerosol climatologies used by the model.e.g. files C11CLIM, MCICA, etc. Unpacks into a directory called <version>/ifsdata. |
<version>/ifsdata_<version>_climate_<res>.tgz | varies | Contains ozone climatology for all supported horizontal and vertical resolutions, including full and reduced Gaussian grid versions. Unpacks into a directory: <version>/climate/<resolution><grid_type>. These contain data split one file per horizontal resolution with a suffix that corresponds to the type of model grid. For example '40r1/climate/159l_2', would correspond to the OpenIFS 40r1 model release, with a T159 linear grid. For further explanation of the model grid types, please see the user guide section. If you want to save space, you can download just the resolutions you intend working with. |
<version>/ifsdata_rtables_<version>.tgz | <1Mb | Contains namelists defining the supported grid resolutions for the radiation scheme. File name suffix refers to the type of grid and last 3 digits refers to the horizontal resolution. Unpacks to a directory: <version>/rtables |
<version>/ifsdata_vtables_<version>.tgz | <1Mb | Contains namelists defining the coefficients for the supported vertical resolutions. File name suffix refers to the number of levels. Unpacks to a directory: <version>/vtables. |
<version>/ifsdata_namelist_<version>.tgz | <1Mb | Contains the full model namelist set for this OpenIFS version. Unpacks to a directory: <version>/namelist. |
To unpack the files either use the tar zxf
command if your version of tar supports the 'z' option, or use gunzip
followed by tar xf
.
% mkdir oifs/ifsdata % cd oifs/ifsdata % ftp ftp.ecmwf.int Connected to ftp.ecmwf.int. Name (ftp.ecmwf.int): openifs 331 User openifs OK. Password required ftp> cd data/40r1 ftp> prompt ftp> mget ifsdata_*.tgz ftp> quit % for ff in *.tgz; do tar zxf $ff; done % rm *.tar.gz
OpenIFS 40r1 expects the vtables and rtables directories to be at the same directory level as the 40r1 directory. This was changed in later versions of OpenIFS.
To allow for this, make links from the 'oifs/ifsdata' created above:
% cd oifs/ifsdata % ln -s 40r1/vtables vtables % ln -s 40r1/rtables rtables % ls 40r1 vtables rtables
Additional software
OpenIFS users may also find the Metview and MAGICS graphics software useful with OpenIFS.