...

AC-experiments directory overview

AC-experiments
├── config.h
├── ctrl
│   ├── context_ifs.xml
│   ├── ifs_xml
│   │   ├── axis_def_ifs.xml
│   │   ├── domain_def_ifs.xml
│   │   ├── field_def_ifs.xml
│   │   ├── file_def_ifs.xml
│   │   └── grid_def_ifs.xml
│   ├── iodef.xml
│   ├── namelistfc
│   ├── namelist.ifs-epc8.sh
│   ├── namelist.ifs-m7-debug-output.sh
│   ├── namelist.ifs-oiac.sh
│   ├── namelist.ifs.sh
│   ├── Table
│   │   ├── bins_aerver1.csv
│   │   ├── bins_hamm7ver1.csv
│   │   ├── bins_tm5m7ver0.csv
│   │   ├── bins_tm5m7ver1.csv
│   │   ├── table_bascoetm5ver2d.txt
│   │   ├── table_bascoetm5ver2f.txt
│   │   ├── table_hamm7ver1.txt
│   │   ├── table_RnPbver1.txt
│   │   ├── table_tm5ver15.txt
│   │   └── table_tm5verb27y.txt
│   └── wam_namelist
├── ecmwf-atos.job
├── oifs-run.sh
├── platform
│   ├── climate-prep.puhti.job
│   ├── climate-run.puhti.job
│   ├── csc-puhti.job.tmpl
│   ├── ecmwf-cca.job.tmpl
│   ├── ecmwf-cca-workflow.sh
│   ├── ecmwf-cca+xios.job.tmpl
│   ├── ecmwf-hpc2020.job.tmpl
│   ├── knmi-rhino.job.tmpl
│   ├── knmi-rhino-workflow.sh
│   ├── oifs-config.csc-puhti.sh
│   ├── oifs-config.ecmwf-atos.sh
│   ├── oifs-config.ecmwf-cca.sh
│   ├── oifs-config.ecmwf-hpc2020.sh
│   ├── oifs-config.knmi-rhino.sh
│   ├── prep-ic-icmcl-compo-puhti.job.tmpl
│   └── README_PLATFORM
├── prep_emis
│   ├── check_emis.py
│   ├── log
│   │   ├── CMIP6_MACCity_gfas_rean_v2_burden.txt
│   │   ├── CMIP6_MACCity_gfas_rean_v2.pdf
│   │   └── CMIP6_MACCity_gfas_rean_v2.txt
│   ├── prepare_cb05aer_v1.0
│   ├── prep_cmip6_v0.1
│   └── Table
│       └── table_tm5ver15_aer.txt
├── prep-ic-icmcl-compo.sh
└── scripts
    ├── add_nrt_fire_chem
    ├── gaussgr
    ├── get_alb_lai_intLimits
    ├── get_tablecol
    ├── grib_def.h
    ├── lib_chem_setup.sh
    ├── lib_general.sh
    ├── lib_icmcl_clima.sh
    ├── lib_icmcl_compo.sh
    ├── lib_initcond_offline.sh
    └── lib_initcond.sh

The experiment controls are in $OIFS_HOME/AC-experiments/. 

There the following scripts can be found:

...

PLATFORM='ecmwf-atos'
RUNDIR=${SCRATCH}/43r3/experiments\${EXPID}\/runs  # where your experiment will run
AC_IC_DIR=${SCRATCH}/43r3/experiments\${EXPID}/chem_ic  # where your chemical initial conditions will be created
run_end_date="2010-01-03"

rst_freq='3 day'  # run for 3 days without restarts (no multi-leg exp)
USE_RESTART=false   # Do not write restart files (no multi-leg exp)
LCHEM=true
CHEM_SCHEME="bascoetm5"
CHEM_VER="ver2f"
OIFS_INIDATA_DIR=$path_to_directory_T255L91-bascoetm5-none
AC_IC_ONCE=${OIFS_INIDATA_DIR}/ICMUAoiac.ac_rst'
MET_IC_DIR='${OIFS_ICMCL_DIR}/aabg/2010010100'

LAERO=true
LAERCHEM=true
LCHEM_AEROI=true
LINJ_CHEM=true
LINJ_AER=true
LAEROSFC=true

LWAM=true" config.h
LRLXG=false" config.h
LAC4IC=true" config.h

Generating initial data

...

Initial conditions for the standard OpenIFS model can be generated using the OpenIFS Data Hub or alternatively they can be requested from the ECMWF OpenIFS support by email openifs-support@ecmwf.int. This provides initial experiment data and surface boundary conditions for the physical/meteorological NWP forecast model.

In order to simulate atmospheric composition further initial with OpenIFS/AC additional initial and boundary conditions are needed. These can be created using the prep-ic-icmcl-compo.sh script. 

...

The prep-ic-icmcl-compo.sh script (henceforth: prep script) carries out 3 4 tasks:

• Create a destination directory $AC_IC_DIR which serves as a staging area of for all initial and boundary conditions required for the forecast experiment. Symbolic links will point later from inside the experiment run directory to these files.
• Copy the physical/meteorological initial conditions files that must be specific to the experiment start date from $OIFS_INIDATA_DIR to the new $AC_IC_DIR. If these files cannot be found then they are created. 
• Copy the physical boundary conditions file ICMCL{exp}INIT (SSTs, albedos, etc) from $OIFS_INIDATA_DIR to $AC_IC_DIR and if necessary truncate to length of experiment duration. 
• Copy the chemistry initial and boundary conditions file (emission fluxes, deposition velocities) ICMCL-INIT-COMPO from $OIFS_INIDATA_DIR to $AC_IC_DIR. If this file cannot be found it will be created. 

...

Running the prep script will take a few minutes and will result in new data which will be written to folder $AC_IC_DIR, by default $SCRATCH/43r3/experiments/{exp}/chem_ic. This folder serves as a staging area for the initial experiment data and if the target files already exist in this destination they they will not be overwritten. 

Running a forecast experiment on the ECMWF HPCF

The actual forecast experiment will be carried out inside the run directory. By default this is set to $SCRATCH/43r3/experiments/${exp}/rundir/.

...

Multiple forecasts with restarts

...