ecearth3/runtime/classic/ctrl/tm5-config-run.rc.tmpl

!
! RCFILE template to set up TM5-MP for an ECEARTH 3 run.
!
! The following env variables should be exported by the run script :
!
! ${cpl_tm_guess}, ${tm5_co2}, ${ifs_res_hor}, ${exp_name} (because used in run_dir!!) 
!
! WARNING: any dependency of one of these keys should also be exported by the run script.
! 

!=====================================================================!
! Run main specifications
!=====================================================================!
! [id]  basename for executable & runtime rcfile
my.basename     : tm5v4
! timing
timerange.start : 9999-99-99 99:99:99
timerange.end   : 9999-99-99 99:99:99
jobstep.length  : inf
! autorun
submit.auto     : False
! main directories
my.project.dir  : [[[PLT:ACTIVE:ECEARTH_SRC_DIR]]]/tm5mp
my.run.dir      : [[[PLT:ACTIVE:RUN_DIR]]]
my.data.dir     : [[[PLT:ACTIVE:INI_DATA_DIR]]]/tm5
ifs.data.dir     : [[[PLT:ACTIVE:INI_DATA_DIR]]]/ifs

! dir of standard input files (read in model init)
inputdir        : ${my.data.dir}/TM5_INPUT

co2only : ${tm5_co2}

!=====================================================================!
! Environment (compiler, libraries, job manager, //, ...)
!=====================================================================!
par.mpi       : T
par.ntask     : 1
par.nx        : [[[MOD:TM5:NUMPROC_X]]]
par.ny        : [[[MOD:TM5:NUMPROC_Y]]]

!=====================================================================!
! Grids & Levels
!=====================================================================!
#if "${tm5_exch_nlevs}" == '91'
my.levs       : tropo34
#elif "${tm5_exch_nlevs}" == '62'
my.levs       : tropo31
#else
my.levs       : all 
#endif
! regions name
my.region1    :  glb300x200
! grid names for meteo input (allows on the flight regridding):
my.region1m   :  glb100x100
!=====================================================================!
! Model tuning
!=====================================================================!
! model timestep
time.ntimestep              : [[[MOD:TM5:TIME_STEP_SEC]]]
time.ndyn_max               : 3600
! processes
proces.advection.reduced    : T
proces.wet_removal.cp_scale : 0.5
! read diffusion coefficients (instead of calculate) (also: write if doesnot exist)
diffusion.write             : F
diffusion.dir               : ${my.run.dir}/output
!=====================================================================!
! Restart files
!=====================================================================!
! initial fields
istart : 31
! Directory (case of istart=33)
restart.read.dir    : ${my.run.dir}
! File (case of istart=4, 30, 31, 5)
start.31.glb100x100 :  ${my.run.dir}/tm5_save.hdf
start.31.glb300x200 :  ${my.run.dir}/tm5_save.hdf
start.31.glb600x400 :  ${my.run.dir}/tm5_save.hdf
start.5.glb300x200 :  ${my.run.dir}/tm5_mmix.hdf
start.5.glb600x400 :  ${my.run.dir}/tm5_mmix.hdf
!
restart.write                 :  T
! extra restart files
restart.write.extra           :  F
restart.write.extra.hour      :  00
restart.write.extra.dhour     :  24
! where to write restart files:
restart.write.dir             :  ${restart.read.dir}
!=====================================================================!
! METEO SETTINGS
!=====================================================================!
my.meteo.class        : ifs${tm5_exch_nlevs}
my.meteo.resol        : glb100x100
my.meteo.format       : tm5-hdf
time.fc               : F
time.fc.day0          : 
my.tmm.setup.apply    : T
#include ${my.project.dir}/rc/meteo-tm5-ecearth3.rc
!=====================================================================!
! Coupling to ecearth
!=====================================================================!
! list of variables get from ifs (comma seperated):
#if "${co2only}" == '1' 
prism.get   :  SPINF,LNSP,VOR,DIV,OROG,SPRES,TMP,HUM,UMF,UDR,DMF,DDR,LSMSK,SR,U10M,V10M,SLHF,SSHF,EWSS,NSSS
#else
prism.get   :  SPINF,LNSP,VOR,DIV,OROG,SPRES,TMP,HUM,CLW,CIW,CC,CCO,CCU,UMF,UDR,DMF,DDR,LSMSK,ALB,SR,CI,U10M,V10M,SRC,D2M,T2M,SLHF,SSHF,EWSS,NSSS,CP,LSP,SSR,SD,SWVL1,TV01,TV02,TV03,TV04,TV05,TV06,TV07,TV09,TV10,TV11,TV13,TV16,TV17,TV18,TV19,CVL,CVH
#endif

! * == 3D
!SPINF,LNSP,VOR*,DIV*,OROG,SPRES,TMP*,HUM*,CLW*,CIW*,CC*,CCO*,CCU*,UMF*,UDR*,DMF*,DDR*,LSMSK,ALB,SR,CI,U10M,V10M,SRC,D2M,T2M,SLHF,SSHF,EWSS,NSSS,CP,LSP,SSR,SD,SWVL1,TV01,TV02,TV03,TV04,TV05,TV06,TV07,TV09,TV10,TV11,TV13,TV16,TV17,TV18,TV19,CVL,CVH

! list of variables put to ifs (comma seperated):
prism.put   :  ${tm5_to_ifs}
! number of levels for exchange with IFS:
ifs.cpl.nlev : ${tm5_exch_nlevs}
! reduced number of levels for exchange with IFS,
! applied to aerosol fields
ifs.cpl.nlev.cutoff : ${tm5_exch_nlevs_cutoff}
! ifs nproc:
ifs.nproc    : [[[MOD:IFS:NUMPROC]]]
! ifs spectral resolution:
ifs.shresol  : ${ifs_res_hor}
! exchange period of coupler [hrs]:
cpl.exchange.period : [[[MOD:OASIS:CPL_FREQ_ATM_CHE_HRS]]]
! couple TM5 to LPJ-GUESS
coupled_to_lpjguess : ${cpl_tm_guess} 
!=====================================================================!
! Extra resources
!=====================================================================!
#if "${my.region1}" == "glb100x100"
#include ${my.project.dir}/rc/regions-glb100x100-chem.rc
#else
#include ${my.project.dir}/rc/regions-${my.region1}.rc
#endif

#include ${my.project.dir}/rc/expert-ecearth3-run.rc

!=====================================================================!
! Input for chemistry - see <sources>/tm5mp/rc/chem-input-default.rc.tmpl for details
!=====================================================================!
!------------------------
! Photolysis
!------------------------
input.photo              : ${inputdir}/photolysis
optics.lookuptable       : ${inputdir}/photolysis/lookup_table.nc
optics.refractive_indices: ${inputdir}/photolysis/refractive_indices_hdfstyle.nc

!------------------------
! STRATOSPHERIC BOUNDARY : O3, O3S and CH4 are relaxed to climatology at those layers
!------------------------
! ** Use CMIP6 O3..
input.conc.o3.cmip6        :  T
! .. specifically its pre-industrial climatology
input.conc.o3.cmip6.piclim :  F

#if "${input.conc.o3.cmip6.piclim}" == 'T'
input.conc.o3.cmip6.dir    :  ${ifs.data.dir}/cmip6-data/o3_pi/
#else
input.conc.o3.cmip6.dir    :  ${ifs.data.dir}/cmip6-data/o3_histo/
#endif

! Alternative for O3
input.climat.MSR         :  F
input.climat.o3vmr       :  ${inputdir}/boundary/O3_top/MSR_O3_VMR_HDF/
input.climat.use_o3du    :  F
input.climat.o3du        :  ${inputdir}/boundary/O3_top/MSR_O3_VMR_HDF/

! Option to fix CMIP6 or MSR O3 mixing ratios to fixed year:
! Note that, for CMIP6, this option applied to the year 1850, 
! is not the same as selecting the pre-industrial climatology
! with input.conc.o3.cmip6.piclim=T.
input.o3.fixyear  :  F
input.o3.year     : 

! ** CH4, use HALOE climatology...
input.climat.HALOE       :  T
input.climat.ch4vmr      :  ${inputdir}/boundary/CH4_top/
! ... scaled based on the CMIP6 time series of the global and annual mean

! Option to fix CMIP6 methane boundary conditions and emissions to fixed year
input.ch4.fixyear :  F
input.ch4.year    :

! ** For HNO3 and CO scaled from O3 according to ODIN:
input.climat.ODIN        :  T
input.climat.covmr       :  ${inputdir}/boundary/ODIN/

!------------------------
! Set emissions base year (default to simulation year if commented)
!------------------------
#if "[[[MOD:TM5:EMISS_FIXYEAR]]]" != "0"
input.emis.year          : [[[MOD:TM5:EMISS_FIXYEAR]]]
#endif

! ----------------------------------------
! ! Anthropogenic emis (choose ONE: CMIP6 (1850-2100) or AR5(1850-2100) or EDGAR4(1970-2005/8) )
! ----------------------------------------
use_cmip6            : T
input.emis.dir.CMIP6 : ${my.data.dir}/CMIP6
use_ar5              : F
input.emis.dir.AR5   : ${my.data.dir}/AR5
! AR5 scenario: choose b/w RCP26 (1), RCP45 (2), RCP60 (3), RCP85 (4) and 'hist' (0) for historical
input.emis.AR5.RCP   : [[[MOD:TM5:CMIP5_RCP]]]
use_edgar4           : F
input.emis.dir.ED41  : ${my.data.dir}/EDGAR4

! ----------------------------------------
! Biomass burning (choose one: CMIP6BMB (1850-2100), GFED3 (1997-2010), RETRO_FIRES(1960-2000) or AR5_FIRES)
! ----------------------------------------
use_cmip6_fires      : T
use_ar5_fires        : F
use_retro_fires      : F
use_gfed3            : F
input.emis.dir.gfed  : ${my.data.dir}/GFED3
input.emis.dir.retro : ${my.data.dir}/RETRO
! apply daily cycle to BMB in the tropics 
! (based on isoprene and not applied to BC/POM)
input.emis.bb.dailycycle   :  F

!--------------------------------------------------------------------    
! Additional switches to fix the emissions of                            
! anthropogenic and biomass burning emissions to a specific year         
! (as required in AerChemMIP).                                           
!                                                                        
! The year of emissions can be controlled for the whole group of NTCFs,  
! for the sub-groups of aerosol and ozone precursors,                    
! and/or for the individual species.                                     
!                                                                        
! Note that settings for individual species or else the subgroup         
! to which they belong are leading.                                      
! If these are commented, input.emis.year.ntcf or                        
! else input.emis.year is used.                                          
! If these are also commented,                                           
! the actual year of simulation is used.                                 
!                                                                        
! Near-Term Climate Forcers (NTCFs), excl. CH4                           
!input.emis.year.ntcf  :                                                 
!                                                                        
! Aerosol precursors (BC, OC, NH3, SOx)                                  
!input.emis.year.aer  :                                                  
!input.emis.year.bc   :                                                  
!input.emis.year.oc   :                                                  
!input.emis.year.sox  :                                                  
!input.emis.year.nh3  :                                                  
!                                                                        
! Ozone precursors (NOx, CO, NMVOCs incl. isoprene and mononterpenes)    
! Note that in AerChemMIP, the year for CO should be that for NMVOCs.    
!input.emis.year.o3    :                                                 
!input.emis.year.nox   :                                                 
!input.emis.year.co    :                                                 
!input.emis.year.nmvoc :                                                 
!------------------------------------------------------------------------

! ----------------------------------------
! Natural emissions
! ----------------------------------------
use_macc               : T
input.emis.dir.MACC    : ${my.data.dir}/MACC
use_megan              : T
input.emis.dir.MEGAN   : ${my.data.dir}/MEGAN
use_lpj                : T
use_hymn               : T
input.emis.dir.natch4  : ${inputdir}/natural_emissions/reactive_gases/CH4/HYMN
input.emis.dir.rn222   : ${inputdir}/natural_emissions/tracer
input.emis.dir.dms     : ${inputdir}/natural_emissions/reactive_gases/DMS

! Set base year for natural emissions that don't cover the full period
! 1850-2100.  Use 2000 in climate integrations (CMIP6).  Used for CH4
! emissions from LPJ, as well as for MACC & MEGAN.
input.natemis.year : 2000                        

! ----------------------------------------
! Aerosols
! ----------------------------------------
input.emis.dust          : ONLINE
input.emis.dir.dust      :  ${inputdir}/aerosols/Dust/${input.emis.dust}
input.emis.dir.aerocom   :  ${inputdir}/aerosols/SOA

! ** particle formation scheme
! 1 Vehkamaki et al. 2002 (so4)
! 2 Kulmala et al. 1996 (so4)
! 3 Paasonen et al. 2010 (organic+so4) + Vehkamaki et al.
! 4 Riccobono et al. 2014 + Vehkamaki et al.
input.nucleation.scheme  : 4

! ** SOA scheme
!0 POM AeroCom (aitkenmodes)
!1 POM distribution according to volatility (5 modes) (not implemented) 
!2 monoterpene+isoprene oxidation + condensation
input.soa.scheme  : 2

!Use also isoprene yields for ELVOC and SVOC production
!Default value True
input.soa.isoprene_on    : T
!Size of formed particles in KK parameterisation in nm (default: 5.0)
input.KK.d_form         : 5.0

! ----------------------------------------
! NOx extra sources
! ----------------------------------------
input.onlinenox.dir      :  ${inputdir}/input/glb1x1

! ----------------------------------------
! Nudging CH4 [see emission_CH4.F90]
! ----------------------------------------
! If input.conc.ch4.cmip6 is set to T:
! - CMIP6 zonal mean surface mixing ratios used in the lower troposphere
! - HALOE climatology of stratospheric CH4 mixing ratios scaled
!   based on CMIP6 time series of global annual mean mixing ratio at surface
!   (input.climat.HALOE forced to T --see above--)
input.conc.ch4.cmip6     :  T
input.conc.ch4.cmip6.dir.year  :  ${ifs.data.dir}/cmip6-data/
input.conc.ch4.cmip6.dir.month :  ${inputdir}/boundary/CMIP6/CH4/

! alternative
input.emis.ch4.surf      :  ${inputdir}/boundary/CH4_surf/
input.emis.ch4.single    :  F
input.emis.ch4.fixed_ppb :  1760.0
input.emis.ch4.fix3d     :  T

! ----------------------------------------
! CO2 mixing ratio used in pH calculation for aqueous chemistry
! ----------------------------------------
! If input.conc.co2.cmip6 is set to T (RECOMMENDED),
! global annual mean mixing ratios from CMIP6 are used;
! otherwise, it is fixed to a value for the year 2000.
input.conc.co2.cmip6     :  T
input.conc.co2.cmip6.dir :  ${ifs.data.dir}/cmip6-data/

! Option to fix CMIP6 CO2 mixing ratio to fixed year:
input.co2.fixyear :  F
input.co2.year    :

!=====================================================================!
! Log & output dir
!=====================================================================!
okdebug               : F
go.print.all          : F
go.print.prompt.pe    : F
go.print.trace        : F
go.print.file         : T
go.print.file.base    : ctm.tm5.log
output.dir            : ${my.run.dir}
output.overwrite      : T
! alternative output dir  
output.dir.base       :  
output.dir.extensions :  

!=====================================================================!
! Optional output from 'BASE' code
!=====================================================================!
! mean mixing ratio
output.mmix                : T

! budget fluxes through boundaries
apply.budget.global.flux   : F
budget.global.flux.lon_in  : -12
budget.global.flux.lon_out :  36
budget.global.flux.lat_in  :  34
budget.global.flux.lat_out :  62

! Non-Horizontally-Aggregated-Budgets
write.column.budgets : T

! profiling (subdir of output.dir)
timing.output              : F
timing.output.subdir       : tm5_profile
!output.after.step         :

!=====================================================================!
! Optional output from 'PROJ/USER_OUTPUT' code
!=====================================================================!
! Grids setting (subdir of output.dir)
settings.output          : F
settings.output.subdir   : 

! Station output
output.station           : F
inputdir.station         : 
input.station.filename   : station.emep.list
input.station.filename2  :
input.station.fileformat : 1
station.speclist         : SO2 NOy CH4 OH
output.station.filename  : tm5_emep.hdf

! Flight tracks
output.flight            : F

! All fields on root processor
output.mix               : F
output.mix.dhour         : 3

! Aerocom output (cannot do -fpe0 with Aerocom output)
output.aerocom          : T

! Set output frequency to "hourly", "daily" or "monthly"
output.aerocom.freq     : monthly
output.aerocom.exper    : [[[MOD:GENERAL:EXP_NAME]]]
output.aerocom.dhour    : 1
output.aerocom.stations : F
pm.sizelimits            : 2 5 10

! General output
output.general          : T
output.general.freq     : monthly
output.general.exper    : [[[MOD:GENERAL:EXP_NAME]]]
output.general.dhour    : 1
! all_chemistry: all or subset of gasphase compounds
output.general.all_chemistry    : F
output.general.2d       : T
output.general.3d       : T

! AerChemMIP and CRESCENDO output
output.aerchemmip: T
output.aerchemmip.1h: T
! ** NOT IMPLEMENTED YET **
! output.aerchemmip.dhour: 1
output.aerchemmip.experiment: SOMETHING
output.aerchemmip.realm: atmosChem
output.aerchemmip.sourcetype: AP3
output.aerchemmip.experimentid: id00
output.crescendo: T

! diagnostic CCN
input.diagnostic.CCN    : T
input.supersat          : 8
! supersaturation [%RH]
supersat.values         : 0.05 0.1 0.2 0.3 0.5 0.7 1.0 1.4

! NOAA output
output.noaa              : F

! Time Series
output.pdump                        :  F
output.pdump.dataset.author         :  John Doe
output.pdump.dataset.institution    :  My Company, Somewhere
output.pdump.dataset.version        :  ece3

output.pdump.fname.model            :  TM5MP 
output.pdump.fname.expid            :  r240
output.pdump.fname.grid.glb300x200  :  glb3x2
output.pdump.fname.grid.eur100x100  :  eur1x1

output.pdump.griddef.apply          :  T

output.pdump.tp.apply               :  F
output.pdump.tp.dhour               :  3

output.pdump.vmr.n                  :  3

output.pdump.vmr.001.apply          :  T
output.pdump.vmr.001.fname          :  vmr3
output.pdump.vmr.001.dhour          :  3
output.pdump.vmr.001.tracers        :  O3 CO NO

output.pdump.vmr.002.apply          :  F
output.pdump.vmr.002.fname          :  vmr1
output.pdump.vmr.002.dhour          :  1
output.pdump.vmr.002.tracers        :  O3 O3s CO CH2O
output.pdump.vmr.002.subreg         :  F
output.pdump.vmr.002.minlon         :  -10.
output.pdump.vmr.002.maxlon         :  10.
output.pdump.vmr.002.minlat         :  23.
output.pdump.vmr.002.maxlat         :  57.

output.pdump.vmr.003.apply          :  F
output.pdump.vmr.003.fname          :  vmra
output.pdump.vmr.003.dhour          :  3
output.pdump.vmr.003.tracers        :  SO4 NO3_A BC BCS POM SS1_N SS1_M SS2_N SS2_M SS3_N SS3_M DUST2_N

output.pdump.lt.apply               :  F
output.pdump.lt.tracers             :  O3
output.pdump.lt.localtime           :  2

output.pdump.lt2.apply              :  F
output.pdump.lt2.tracers            :  
output.pdump.lt2.localtime          :  

output.pdump.depositions.apply      :  F
output.pdump.depositions.dhour      :  3
output.pdump.depositions.tracers    :  O3 HNO3 NO NO2 H2O2 CH2O PAN CO NH3 NH4 SO2 NOy

output.pdump.depvels.apply          :  F
output.pdump.depvels.dhour          :  3
output.pdump.depvels.tracers        :  O3 HNO3 NO NO2 H2O2 CH2O PAN CO NH3 NH4 SO2