MESONH

The MESONH user will specify some free parameters of the run by fixing their new values in the namelists of the file EXSEG$n.nam. When more than one model is present, each model needs its own Meso-NH file to be initialized and its own EXSEG$n.nam file to fix the free-parameters (note that a lot of physical free-parameters depends on the mesh and therefore vary with the model number). The input files are read by the program in order to realize the initialization and the eventual coupling of the MESONH model with a large-scale model (ECMWF, ARPEGE, AROME, GFS). The output files are of two types:

synchronous files for a given instant of the run. They contain the prognostic fields and eventually, additional records for supplementary diagnostic fields at the same instant. The file name ends by 00n with n>0
a diachronic file for the temporal series of prognostic or diagnostic fields. The file name ends by 000.

MESONH program and its corresponding namelist and function
Executable	Namelist	Function
MESONH	EXSEG1.nam	Launch simulation

The following namelists can be used in the EXSEG1.nam file :

SURFEX

NAM_2D_FRC

NAM_2D_FRC content
Fortran name	Fortran type	Default value
L2D_ADV_FRC	LOGICAL	.FALSE.
L2D_REL_FRC	LOGICAL	.FALSE.
XRELAX_HEIGHT_BOT	REAL	0.0
XRELAX_HEIGHT_TOP	REAL	30000.0
XRELAX_TIME	REAL	864000.0

L2D_ADV_FRC : flag to activate advecting forcing (2D simulations), using files passed through namelist PRE_IDEA1.nam
L2D_REL_FRC : flag to activate relaxation forcing (2D simulations), using files passed through namelist PRE_IDEA1.nam
XRELAX_HEIGHT_BOT : lower limit of relaxation (m)
XRELAX_HEIGHT_TOP : upper limit of relxation (m)
XRELAX_TIME : relaxation timsescale (s)

NAM_ADVn

It contains the different advection schemes for dynamic variables (u,v and w), scalar meteorological variables (temperature, water substances, TKE) and tracers used by the model n.

NAM_ADVn content
Fortran name	Fortran type	Default value
CUVW_ADV_SCHEME	CHARACTER(LEN=6)	‘CEN4TH’
CMET_ADV_SCHEME	CHARACTER(LEN=6)	‘PPM_01’
CSV_ADV_SCHEME	CHARACTER(LEN=6)	‘PPM_01’
CTEMP_SCHEME	CHARACTER(LEN=4)	‘RKC4’
NWENO_ORDER	INTEGER	3
LSPLIT_CFL	LOGICAL	.TRUE.
LSPLIT_WENO	LOGICAL	.TRUE.
XSPLIT_CFL	REAL	0.8
LCFL_WRIT	LOGICAL	.FALSE.

CUVW_ADV_SCHEME : Advection scheme used for horizontal and vertical velocities. The following options are possible :
- ‘WENO_K’ : WENO odd ordered advection scheme
- ‘CEN2ND’ : 2nd order advection scheme CENtred on space and time
- ‘CEN4TH’ : 4th order advection scheme CENtred on space and time
CMET_ADV_SCHEME : Advection scheme used for the following METeorological variables: temperature, water substances and TKE. The following options are possible :
- ‘PPM_00’ : PPM advection scheme without constraint
- ‘PPM_01’ : Monotonic version of PPM. It is POSITIVE definite.
CSV_ADV_SCHEME : Advection scheme used for the tracer variables. The same options as CMET_ADV_SCHEME can be used.

Note

Note that if LLG=T in NAM_CONF, CSV_ADV_SCHEME must be equal to CMET_ADV_SCHEME.

CTEMP_SCHEME : Temporal scheme for momentum advection (the rest of the model is in Forward In Time). The following options are possible :
- ‘LEFR’ : Leap-Frog scheme (only for CEN4TH or CEN2ND wind schemes)
- ‘RKC4’ : Runge-Kutta centred 4th order (recommended for CEN4TH)
- ‘RK53’ : Runge-Kutta 5 steps 3th order (recommended for WENO5 and WENO3)
- ‘RK33’ : Runge-Kutta 3 steps 3th order
- ‘RK21’ : Runge-Kutta 2 steps 1st order
NWENO_ORDER : Order of WENO scheme for CUVW_ADV_SCHEME. For the moment, the 3rd order and the 5th order are available.
LSPLIT_CFL : Flag to split PPM advection as a function of CFL
XSPLIT_CFL : Allowed CFL maximum value for LSPLIT_CFL=T.
LSPLIT_WRITE : Flag to store CFL fields on every output synchronous file.
LSPLIT_WENO : Flag to split WENO momentum advection

NAM_AIRCRAFTS

This namelist allows to add virtual aircrafts to the simulation. Before using this namelist, the total number of aircrafts must be set in the NAM_FLYERS namelist.

All the prognostic fields (zonal and meridian wind (from U and V components), vertical velocity, potential temperature, pression, mixing ratios, tke, radiative surface temperature…) are recorded along the trajectories of the aircrafts, as well as their trajectories themselves (positions in X, Y and Z directions and orography). All records are stored in the diachronic file (.000).

NAM_AIRCRAFTS content
Fortran name	Fortran type	Default value
CFILE	CHARACTER(LEN=128)(:)
CMODEL	CHARACTER(LEN=3)(:)	‘FIX’
CTITLE	CHARACTER(LEN=10)(:)	‘AIRCRAnnn’
LALTDEF	LOGICAL(:)	.FALSE.
NMODEL	INTEGER(:)	0
NPOS	INTEGER(:)	0
TLAUNCH	TYPE(DATE_TIME)(:)	default value of type(date_time)
XTSTEP	REAL(:)	60.0

CFILE : name of the .csv file with the aircraft positions (one file per aircraft)
CMODEL : ‘FIX’ if the aircraft stays on the same grid model, ‘MOB’ if the aircraft may change of grid model (always the finest depending on the horizontal position). ‘FIX’ by default
CTITLE : name of the aircraft. If not provided, it is set to ‘AIRCRAnnn’ with nnn the number of the aircraft
LALTDEF : if .FALSE. (by default), atlitude is given in meters; if .TRUE. altitude is given in pressure (hPa)
NMODEL : number of the grid model where the aircraft flies. If CMODEL=’FIX’, it may be any grid model number (forced to 1 if NMODEL not set and only one domain). If CMODEL=’MOB’, NMODEL is forced to 1 at simulation start but will change during flight to always fly on the finest model at a given horizontal position.
NPOS : number of aircraft positions that will be read in the .csv file. If not provided, the whole file will be read.

TLAUNCH : instant of launch. This type has 4 fields (nyear, nmonth, nday and xtime).

Note

For example:

TLAUNCH(1)%nyear  =  2023
TLAUNCH(1)%nmonth =     1
TLAUNCH(1)%nday   =    16
TLAUNCH(1)%xtime  = 21600.

XTSTEP : data storage frequency. If not set, it is forced to 60s. The frequency must be a multiple of the timestep of the chosen model NMODEL if CMODEL=’FIX’ or of the main model 1 if CMODEL=’MOB’. It will be enforced at run.

The .csv files should follow the format example hereafter (the first line is ignored, here the altitude is given in pressure (in hPa)):

Time Lat Lon Alt(p)
  45.  -4. 1003.6
47.5 -.5 990.8
50.  2.  988.1

Warning

If the altitude is given in pressure, the units are hPa and not Pa.

Warning

The first time should be 0. as the times correspond to the time since the launch of the aircraft.

NAM_BACKUP

NAM_BACKUP content
Fortran name	Fortran type	Default value
XBAK_TIME	REAL(:,:)	-999.0
NBAK_STEP	INTEGER(:,:)	-999
XBAK_TIME_FREQ	REAL(:)	-999.0
XBAK_TIME_FREQ_FIRST	REAL(:)	-999.0
NBAK_STEP_FREQ	INTEGER(:)	-999
NBAK_STEP_FREQ_FIRST	INTEGER(:)	-999
LBAK_BEG	LOGICAL	.FALSE.
LBAK_END	LOGICAL	.FALSE.
LBAK_REDUCE_FLOAT_PRECISION	LOGICAL(:)	.FALSE.
LBAK_COMPRESS	LOGICAL(:)	.FALSE.
NBAK_COMPRESS_LEVEL	INTEGER(:)	4
CBAK_DIR	CHARACTER(LEN=512)

XBAK_TIME(m,i) : array of increments in seconds from the beginning of the segment to the instant where the i-th backup is realized by the model m
NBAK_STEP(m,i) : array of increments in timesteps from the beginning of the segment to the instant where the i-th backup is realized by the model m
XBAK_TIME_FREQ(m) : time between 2 backups for each model m
XBAK_TIME_FREQ_FIRST(m) : time of the first backup for each model m (if XBAK_TIME_FREQ(m) is set). If not set, the first backup will be at time = XBAK_TIME_FREQ.
NBAK_STEP_FREQ(m) : number of timesteps between 2 backups for each model m
NBAK_STEP_FREQ_FIRST(m) : timestep number of the first backup for each model m (if NBAK_STEP_FREQ(m) is set). If not set, the first backup will be at time = NBAK_STEP_FREQ.
LBAK_BEG : force a backup at the first timestep
LBAK_END : force a backup at the last timestep
LBAK_REDUCE_FLOAT_PRECISION(m) : force writing of floating points numbers in single precision for each model m. This option can not be enabled if LIO_ALLOW_REDUCED_PRECISION_BACKUP has not been forced to .TRUE. in NAM_CONFIO. Be careful, this loss of precision could impact restarted computations. This option should only be used if you understand the risks.
LBAK_COMPRESS(m) : enable lossless compression of data for each model m. This can have a negative impact on performance. This option loses precedence over LIO_COMPRESS of NAM_CONFIO.
LBAK_COMPRESS_LEVEL(m) : set the compression level for each model m. The value must be in the 0 to 9 interval (0 for no compression, 9 for maximum compression). This option loses precedence over LIO_COMPRESS_LEVEL of NAM_CONFIO if LIO_COMPRESS=.TRUE.
CBAK_DIR : directory used to write backups and diachronic files (current directory by default). It overrides CIO_DIR.

Note

A choosen time must be a multiple of the timestep.
Different ways to choose the backup times can be combined: a regular series (given with a frequency) + irregular times. Duplicate times will be automatically removed.
In grid-nesting, backup times are propagated from the parent model to its children (children are allowed to have other backup times). Children regular series must be aligned with parent ones. A regular parent backup must always be at the same time than a regular children backup. However, children may have more frequent regular backups (parent time frequency must be a multiple of children frequencies).

NAM_BALLOONS

This namelist allows to add virtual balloons to the simulation. Before using this namelist, the total number of balloons must be set in the NAM_FLYERS namelist.

Balloons are advected by the wind of the model. They can crash. All the prognostic fields (zonal and meridian wind (from U and V components), vertical velocity, potential temperature, pression, mixing ratios, tke, radiative surface temperature…) are recorded along the trajectories of the balloons, as well as their trajectories themselves (positions in X, Y and Z directions and orography). All records are stored in the diachronic file (.000).

NAM_BALLOONS content
Fortran name	Fortran type	Default value
CMODEL	CHARACTER(LEN=3)(:)	‘FIX’
CTITLE	CHARACTER(LEN=10)(:)	CTYPE//nnn
CTYPE	CHARACTER(LEN=6)(:)	‘’
NMODEL	INTEGER(:)	0
TLAUNCH	TYPE(DATE_TIME)(:)	default value of type(date_time)
XTSTEP	REAL(:)	60.0
XLATLAUNCH	REAL(:)	XUNDEF
XLONLAUNCH	REAL(:)	XUNDEF
XALTLAUNCH	REAL(:)	XNEGUNDEF
XPRES	REAL(:)	XNEGUNDEF
XWASCENT	REAL(:)	XNEGUNDEF
XDIAMETER	REAL(:)	XNEGUNDEF
XVOLUME	REAL(:)	XNEGUNDEF
XMASS	REAL(:)	XNEGUNDEF
XAERODRAG	REAL(:)	XNEGUNDEF
XINDDRAG	REAL(:)	XNEGUNDEF

CMODEL : ‘FIX’ if the balloon stays on the same grid model, ‘MOB’ if the balloon may change of grid model (always the finest depending on the horizontal position). ‘FIX’ by default
CTITLE : name of the balloon. If not provided, it is set to CTYPE//nnn with $nnn$ the number of the balloon
CTYPE : ‘CVBALL’ for constant volume balloon, ‘ISODEN’ for iso-density balloon, ‘RADIOS’ for radiosounding balloon. Mandatory
NMODEL : number of the grid model where the balloon flies. If CMODEL=’FIX’, it may be any grid model number (forced to 1 if NMODEL not set). If CMODEL=’MOB’, NMODEL is forced to 1 at simulation start but will change during flight to always fly on the finest model at a given horizontal position.

TLAUNCH : instant of launch. Mandatory. This type has 4 fields (nyear, nmonth, nday and xtime).

Note

For example:

TLAUNCH(1)%nyear  =  2023
TLAUNCH(1)%nmonth =     1
TLAUNCH(1)%nday   =    16
TLAUNCH(1)%xtime  = 21600.

XTSTEP : data storage frequency. If not set, it is forced to 60s. The frequency must be a multiple of the timestep of the chosen model NMODEL if CMODEL=’FIX’ or of the main model 1 if CMODEL=’MOB’. It will be enforced at run. Balloon positions are not computed with this timestep but with the model one.
XLATLAUNCH : latitude of the launching site. Mandatory
XLONLAUNCH : longitude of the launching site. Mandatory
XALTLAUNCH : altitude of the launching site (mandatory if CTYPE=’RADIOS’; if not set for ‘CVBALL’ or ‘ISODEN’, XPRES must be provided)
XPRES : pressure at the launching site (in Pascal). Must be provided for ‘CVBALL’ or ‘ISODEN’ if XALTLAUNCH is not set. Ignored for ‘RADIOS’
XWASCENT : ascentional vertical speed of the ballon (in m/s). Speed in calm air for ‘RADIOS’ (added to air vertical speed, default 5 m/s), initial value for ‘CVBALL’ (default 0 m/s), not used for ‘ISODEN’
XDIAMETER : diameter of the balloon (for ‘CVBALL’) (in m). If not provided, XVOLUME must be set.
XVOLUME : volume of the balloon (for ‘CVBALL’) (in $m^3$). If not provided, XDIAMETER must be set.
XMASS : mass of the balloon (for ‘CVBALL’) (in kg). Mandatory
XAERODRAG : aerodynamic drag coefficient of the balloon (for ‘CVBALL’). Default: 0.44
XINDDRAG : induced drag coefficient (i.e. air shifted by the balloon, only for ‘CVBALL’). Default: 0.014

NAM_BLANKn

NAM_BLANKn content
Fortran name	Fortran type	Default value
XDUMMY1	REAL	0.0
XDUMMY2	REAL	0.0
XDUMMY3	REAL	0.0
XDUMMY4	REAL	0.0
XDUMMY5	REAL	0.0
XDUMMY6	REAL	0.0
XDUMMY7	REAL	0.0
XDUMMY8	REAL	0.0
NDUMMY1	INTEGER	0
NDUMMY2	INTEGER	0
NDUMMY3	INTEGER	0
NDUMMY4	INTEGER	0
NDUMMY5	INTEGER	0
NDUMMY6	INTEGER	0
NDUMMY7	INTEGER	0
NDUMMY8	INTEGER	0
LDUMMY1	LOGICAL	TRUE
LDUMMY2	LOGICAL	TRUE
LDUMMY3	LOGICAL	TRUE
LDUMMY4	LOGICAL	TRUE
LDUMMY5	LOGICAL	TRUE
LDUMMY6	LOGICAL	TRUE
LDUMMY7	LOGICAL	TRUE
LDUMMY8	LOGICAL	TRUE
CDUMMY1	CHARACTER(LEN=80)
CDUMMY2	CHARACTER(LEN=80)
CDUMMY3	CHARACTER(LEN=80)
CDUMMY4	CHARACTER(LEN=80)
CDUMMY5	CHARACTER(LEN=80)
CDUMMY6	CHARACTER(LEN=80)
CDUMMY7	CHARACTER(LEN=80)
CDUMMY8	CHARACTER(LEN=80)

Eight dummy variables and arrays (real, integer, logical, and character of length 80) are defined for testing and debugging. They are read through the namelist but are not used by any Meso-NH routine. If a developer wants to temporarily add a parameter to a subroutine, they can include a USE MODD_BLANK_n statement in that subroutine. This allows them to access and modify these variables via the namelist input.

NAM_BLOWSNOW

NAM_BLOWSNOW content
Fortran name	Fortran type	Default value
LBLOWSNOW	LOGICAL	.FALSE.
NBLOWSNOW3D	INTEGER	2
NBLOWSNOW_2D	INTEGER	3
XALPHA_SNOW	REAL	3
XRSNOW	REAL	4

LBLOWSNOW : Flag to active pronostic blowing snow
NBLOWSNOW3D : Number of blowing snow variables as scalar in Meso-NH. The curent version of the model use two scalars: number concentration and mass concentration (kg/kg)
NBLOWSNOW_2D : Number of 2D blowing snow variables advected in Meso-NH. The curent version of the model advectes three variables: total number concentration in canopy, total mass concentration in canopy and equivalent concentration in the saltation layer
XALPHA_SNOW : Gamma distribution shape factor
XRSNOW : Ratio between diffusion coefficient for scalar variables and blowing snow variables
- XRSNOW = KSCA/KSNOW = 4. (if Redelsperger and Sommeria [1981] used in ini_cturb.f90)
- XRSNOW = KSCA/KSNOW = 2.5 ( if Cheng et al. [2002] used in ini_cturb.f90)

NAM_BLOWSNOWn

NAM_BLOWSNOWn content
Fortran name	Fortran type	Default value
LSNOWSUBL	LOGICAL	.FALSE.

LSNOWSUBL : flag to activate blowing snow sublimation

NAM_BUDGET

NAM_BUDGET content
Fortran name	Fortran type	Default value
CBUTYPE	CHARACTER(LEN=4)	‘NONE’
NBUMOD	INTEGER	1
XBULEN	REAL	43200.0
NBUKL	INTEGER	1
NBUKH	INTEGER	0
LBU_KCP	LOGICAL	.TRUE.
XBUWRI	REAL	43200.0
NBUIL	INTEGER	1
NBUIH	INTEGER	0
NBUJL	INTEGER	1
NBUJH	INTEGER	0
LBU_ICP	LOGICAL	.TRUE.
LBU_JCP	LOGICAL	.TRUE.
NBU_MASK	INTEGER	1

CBUTYPE : type of box used to compute the budget:
- ‘CART’ a cartesian box defined by the lowest and highest values of the indices in the 3 directions in the Meso-NH Grid, defined in the following.
- ‘MASK’ several areas, described by horizontal masks, are selected according to criteria evaluated at each model timestep. The budget computations are realized at the selected verticals for each criteria. The criteria must be defined in the routine set_mask.f90.
NBUMOD : number of the model in which the budget are performed. Only one model must be selected even if the grid-nesting is active.
NBUMASK : Number of masks used to select the budgets’ areas, in the case CBUTYPE= ‘MASK’.
XBULEN : Timestep in seconds, on which the different source terms of all the budget are temporally averaged.
XBUWRI : Duration in seconds, between successive writings in the diachronic file of the budget storage arrays for horizontal masks (CBUTYPE=’MASK’).
NBUKL : value of the model level K for the bottom of the budget box in physical domain, in the case of a cartesian box (CBUTYPE=’CART’) (NBUKL=1 corresponds to the first vertical physical level).
NBUKH : Same as NBUKL but for the top of the budget box in physical domain. Inside the budget box: $NBUKL \leq K \leq NBUKH$
NBUJL : value of the model level J for the left side of the budget box, in the case of a cartesian box (CBUTYPE=’CART’) in physical domain.
NBUJH : Same as NBUJL but for the right side of the budget box in physical domain. Inside the budget box: $NBUJL \leq J \leq NBUJH$
NBUIL : value of the model level I for the left side of the budget box in physical domain, in the case of a cartesian box (CBUTYPE=’CART’).
NBUIH : Same as NBUIL but for the right side of the budget box in physical domain. Inside the budget box: $NBUIL \leq J \leq NBUIH$
LBU_KCP : Flag to average or not in the K direction all the budget terms, for any CBUTYPE value.
LBU_JCP : Flag to average or not in the J direction all the budget terms, for CBUTYPE=’CART’.
LBU_ICP : Flag to average or not in the I direction all the budget terms, for CBUTYPE=’CART’.

The description of the budgets for every prognostic variable is given below. Because all the budgets are performed in the same way, we give here some details on the way to select or cumulate the different source terms.

Firstly, there is a flag to activate or not the budget of a given prognostic variable (in the form LBU_*). It should be noted that the budget terms for the variable $\Psi$ have the dimension of ${\partial \left[ \tilde{ \rho} \Psi \right] \over \partial t }$.

Then, all the source terms computed in the model for this prognostic variable can be selected. Each term is associated with a name. Enabled terms are simply selected by putting their names in a list (an array of character strings beginning with CBULIST_*). Each entry in the list will generate an output in the diachronic file. It is possible to write each source term separateley by writing one name by entry in the array. Or source terms can be grouped together by putting them in the same array entry and separating them with the + (plus) sign without spaces. In the latter case, their respective values are added together.

For example, the following NAM_BU_RU namelist:

&NAM_BU_RU
  LBU_RU = .TRUE.
  CBULIST_RU(1)='ADV'
  CBULIST_RU(2)='HTURB+VTURB'
/

will output 2 different terms. The first one corresponds to the advection source term, the second one to the addition of the horizontal and vertical turbulence source terms.

A special name exists to select all the available source terms: ALL. If set (in the first position of the CBULIST_* array), all the available source terms (depending on the simulation parameters) will be written individually in the diachronic file.

NAM_BU_RRC

NAM_BU_RRC content
Fortran name	Fortran type	Default value
LBU_RRC	LOGICAL	.FALSE.
CBULIST_RRC	CHARACTER(LEN=128)(:)

LBU_RRC : flag to activate budget for cloud
CBULIST_RRC : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRC array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated,water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RC=T
DCONV	KAFR convection	CDCONV=’KAFR’ or CSCONV=’KAFR’
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
DEPOTR	tree droplet deposition	LDRAGTREE=T and LDEPOTREE=T

LIMA source terms

Name	Description	Condition(s)
ACCR	accretion of cloud droplets	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
AUTO	autoconversion into rain	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
SEDI	sedimentation of cloud	NMOM_C>=1 and LSEDC=T
DEPO	surface droplet deposition	NMOM_C>=1 and LDEPOC=T
RIM	riming of cloud water	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
IMLT	melting of ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
BERFI	Bergeron-Findeisen	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
HENU	CCN activation nucleation	NMOM_C>=1 and LACTI=T and NMOD_CCN>0 and (LPTSPLIT=F or LSUBG_COND=F)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T
HONC	droplet homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T)
CEDS	adjustment to saturation	no condition
REVA	evaporation of rain drops	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
R2C1	rain to cloud change after sedimentation	LPTSPLIT=T and NMOM_C>=1 and NMOM_R>=1
CVRC	rain to cloud change after other microphysical processes	LPTSPLIT=T
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

ICE3 / ICE4 source terms

Name	Description	Condition(s)
ACCR	accretion of cloud droplets	NMOM_C>=1
AUTO	autoconversion into rain	NMOM_C>=1
SEDI	sedimentation of cloud	LSEDIC=T
DEPO	surface droplet deposition	LDEPOSC=T and CELEC=’NONE’
HON	homogeneous nucleation	no condition
RIM	riming of cloud water	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
IMLT	melting of ice	no condition
BERFI	Bergeron-Findeisen	no condition
DEPI	condensation/deposition on ice	LRED=F or ( LRED=T and LADJ_AFTER=T) or CELEC/=’NONE’
CMEL	collection by snow and conversion into rain with T>XTT on ice	LRED=T and CELEC/=’ELE3’
DRYH	dry growth of hail	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
ADJU	adjustement to saturation	LRED=T and LADJ_BEFORE=T and CELEC/=’ELE3’
WETH	wet growth of hail	CCLOUD=’ICE4’
CORR	correction	LRED=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

C2R2 / KHKO source terms

Name	Description	Condition(s)
ACCR	accretion of cloud droplets	NMOM_R>=1
AUTO	autoconversion into rain	NMOM_R>=1
SEDI	sedimentation of cloud	LSEDC=T
DEPO	surface droplet deposition	LDEPOC=T
COND	vapor condensation or cloud water evaporation	no condition
HENU	CCN activation nucleation	LSUPSAT=F or (CACTCCN=’ABRK’ and (LORILAM=T or LDUST=T or LSALT=T))
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

KESS source terms

Name	Description	Condition(s)
ACCR	accretion of cloud droplets	no condition
AUTO	autoconversion into rain	no condition
COND	vapor condensation or cloud water evaporation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

REVE source terms

Name	Description	Condition(s)
COND	vapor condensation or cloud water evaporation	no condition

NAM_BU_RRG

NAM_BU_RRG content
Fortran name	Fortran type	Default value
LBU_RRG	LOGICAL	.FALSE.
CBULIST_RRG	CHARACTER(LEN=128)(:)

LBU_RRG : flag to activate budget for graupel
CBULIST_RRG : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRG array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RG=T

LIMA source terms

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
SEDI	sedimentation	NMOM_I>=1 and NMOM_S>=1
HONR	rain homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T and NMOM_R>=1)
DEPG	deposition on graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
RIM	riming of cloud water	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
ACC	rain accretion on graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and NMOM_R>=1)
CMEL	conversion melting of snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CFRZ	conversion freezing of rain	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
RDSF	ice multiplication process following rain contact freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and LRDSF=T)
HMG	Hallett-Mossop ice multiplication process due to graupel riming	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
GMLT	graupel melting	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
COHG	conversion of hail to graupel	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

ICE3 / ICE4 source terms

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
SEDI	sedimentation	no condition
SFR	spontaneous freezing	no condition
DEPG	deposition on graupel	no condition
RIM	riming of cloud water	no condition
ACC	rain accretion on graupel	no condition
CMEL	conversion melting of snow	no condition
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
GHCV	graupel to hail conversion	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
DRYG	dry growth of graupel	no condition
GMLT	graupel melting	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
HGCV	hail to graupel conversion	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
DRYH	dry growth of hail	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
CORR	correction	LRED=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

NAM_BU_RRH

NAM_BU_RRH content
Fortran name	Fortran type	Default value
LBU_RRH	LOGICAL	.FALSE.
CBULIST_RRH	CHARACTER(LEN=128)(:)

LBU_RRH : flag to activate budget for hail
CBULIST_RRH : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRH array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RG=T

LIMA source terms

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
SEDI	sedimentation	NMOM_I>=1 and NMOM_H>=1
DEPH	deposition on hail	NMOM_H>=1
WETG	wet growth of graupel	NMOM_H>=1 and (LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1))
HMLT	melting of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
COHG	conversion of hail to graupel	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

ICE4 source terms

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
SEDI	sedimentation	no condition
GHCV	graupel to hail conversion	LRED=T and CELEC=’NONE’
WETG	wet growth of graupel	LRED=F or CELEC/=’NONE’
WETH	wet growth of hail	no condition
HGCV	hail to graupel conversion	LRED=T and CELEC=’NONE’
DRYH	dry growth of hail	LRED=T and CELEC=’NONE’
HMLT	melting of hail	no condition
CORR	correction	LRED=T and CELEC=’NONE’
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

NAM_BU_RRI

NAM_BU_RRI content
Fortran name	Fortran type	Default value
LBU_RRI	LOGICAL	.FALSE.
CBULIST_RRI	CHARACTER(LEN=128)(:)

LBU_RRI : flag to activate budget for non-precipitating ice
CBULIST_RRI : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRI array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RI=T
DCONV	KAFR convection	CDCONV=’KAFR’ or CSCONV=’KAFR’
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’

LIMA source terms

Name	Description	Condition(s)
SEDI	sedimentation of cloud	NMOM_I>=1 and LSEDI=T
HIN	heterogeneous ice nucleation	NMOM_I=1
HIND	heterogeneous nucleation by deposition	NMOM_I>=1 and LNUCL=T
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T
HONH	haze homogeneous nucleation	NMOM_I>=1 and LNUCL=T and LHHONI=T and NMOD_CCN>0
HONC	droplet homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T)
CNVI	conversion of snow to cloud ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
CNVS	conversion of pristine ice to snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
AGGS	aggregation of snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
IMLT	melting of ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
BERFI	Bergeron-Findeisen	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
HMS	Hallett-Mossop ice multiplication process due to snow riming	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
HMG	Hallett-Mossop ice multiplication process due to graupel riming	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CIBU	ice multiplication process due to ice collisional breakup	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and LCIBU=T)
CFRZ	conversion freezing of rain	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
RDSF	ice multiplication process following rain contact freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and LRDSF=T)
DEPI	condensation/deposition on ice	LPTSPLIT=T
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CEDS	adjustment to saturation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

ICE3 / ICE4 source terms

Name	Description	Condition(s)
SEDI	sedimentation of cloud	no condition
HIN	heterogeneous ice nucleation	no condition
HON	homogeneous nucleation	no condition
AGGS	aggregation of snow	no condition
AUTS	autoconversion of ice	no condition
IMLT	melting of ice	no condition
BERFI	Bergeron-Findeisen	no condition
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
DRYH	dry growth of hail	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
DEPI	condensation/deposition on ice	LRED=F or ( LRED=T and LADJ_AFTER=T) or CELEC/=’NONE’
CORR	correction	LRED=T and CELEC/=’ELE3’
ADJU	adjustment to saturation	LRED=T and LADJ_BEFORE=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

NAM_BU_RRR

NAM_BU_RRR content
Fortran name	Fortran type	Default value
LBU_RRR	LOGICAL	.FALSE.
CBULIST_RRR	CHARACTER(LEN=128)(:)

LBU_RRR : flag to activate budget for rain water
CBULIST_RRR : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRR array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RR=T

LIMA source terms

Name	Description	Condition(s)
SEDI	sedimentation of rain drops	NMOM_C>=1 and NMOM_R>=1
AUTO	autoconversion into rain	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
ACCR	accretion of cloud droplets	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
REVA	rain evaporation	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
HONR	rain homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T and NMOM_R>=1)
ACC	accretion of rain on aggregates	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and NMOM_R>=1)
CFRZ	conversion freezing of rain	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
GMLT	graupel melting	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CVRC	rain to cloud change after other microphysical processes	LPTSPLIT=T
HMLT	melting of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
R2C1	rain to cloud change after sedimentation	LPTSPLIT=T and NMOM_C>=1 and NMOM_R>=1
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

ICE3 / ICE4 source terms

Name	Description	Condition(s)
SEDI	sedimentation of rain drops	no condition
AUTO	autoconversion into rain	NMOM_C>=1
ACCR	accretion of cloud droplets	NMOM_C>=1
REVA	rain evaporation	NMOM_C>=1
ACC	accretion of rain on aggregates	no condition
CMEL	collection of droplets by snow and conversion into rain	LRED=T and CELEC/=’ELE3’
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
GMLT	graupel melting	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
DRYH	dry growth of hail	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
HMLT	melting of hail	CCLOUD=’ICE4’
SFR	spontaneous freezing	no condition
CORR	correction	LRED=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

C2R2 / KHKO source terms

Name	Description	Condition(s)
SEDI	sedimentation of rain drops	no condition
AUTO	autoconversion into rain	NMOM_R>=1
ACCR	accretion of cloud droplets	NMOM_R>=1
REVA	rain evaporation	NMOM_R>=1
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

KESS source terms

Name	Description	Condition(s)
SEDI	sedimentation of rain drops	no condition
AUTO	autoconversion into rain	no condition
ACCR	accretion of cloud droplets	no condition
REVA	rain evaporation	no condition
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

NAM_BU_RRS

NAM_BU_RRS content
Fortran name	Fortran type	Default value
LBU_RRS	LOGICAL	.FALSE.
CBULIST_RRS	CHARACTER(LEN=128)(:)

LBU_RRS : flag to activate budget for snow
CBULIST_RRS : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRS array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RS=T

LIMA source terms

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
SEDI	sedimentation	NMOM_I>=1 and NMOM_S>=1
CNVI	conversion of snow to cloud ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
DEPS	deposition on snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
CNVS	conversion of pristine ice to snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
AGGS	aggregation of snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
RIM	riming of cloud water	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
HMS	Hallett-Mossop ice multiplication process due to snow riming	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CIBU	ice multiplication process due to ice collisional breakup	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and LCIBU=T)
ACC	accretion of rain on snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and NMOM_R>=1)
CMEL	conversion melting of snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

ICE3 / ICE4 source terms

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
SEDI	sedimentation	no condition
DEPS	deposition on snow	no condition
AGGS	aggregation of snow	no condition
AUTS	autoconversion of ice	no condition
RIM	riming of cloud water	no condition
ACC	accretion of rain on snow	no condition
CMEL	conversion melting of snow	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
DRYH	dry growth of hail	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
CORR	correction	LRED=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

NAM_BU_RRV

NAM_BU_RRV content
Fortran name	Fortran type	Default value
LBU_RRV	LOGICAL	.FALSE.
CBULIST_RRV	CHARACTER(LEN=128)(:)

LBU_RRV : flag to activate budget for vapor
CBULIST_RRV : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RRV array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_R=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
2DADV	advective forcing	L2D_ADV_FRC=T
2DREL	relaxation forcing	L2D_REL_FRC=T
NUD	nudging	LNUDGING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_RV=T
DCONV	KAFR convection	CDCONV=’KAFR’ or CSCONV=’KAFR’
DRAGB	vapor released by buildings	LDRAGBLDG=T
BLAZE	Blaze fire model	LBLAZE=T
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
MAFL	mass flux	CSCONV=’EDKF’
SNSUB	blowing snow sublimation	LBLOWSNOW=T and LSNOWSUBL=T

LIMA source terms

Name	Description	Condition(s)
HENU	heterogeneous nucleation	NMOM_C>=1 and LACTI=T and NMOD_CCN>0 and (LPTSPLIT=F or LSUBG_COND=F)
REVA	rain evaporation	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
HIN	heterogeneous ice nucleation	NMOM_IMM=1
HIND	heterogeneous nucleation by deposition	NMOM_I>=1 and LNUCL=T
HONH	haze homogeneous nucleation	NMOM_I>=1 and LNUCL=T and LHHONI=T and NMOD_CCN>0
DEPS	deposition on snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
DEPI	condensation/deposition on ice	LPTSPLIT=T
DEPG	deposition on graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DEPH	deposition on hail	LPTSPLIT=T or NMOM_H>=1
CEDS	adjustment to saturation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

ICE3 / ICE4 source terms

Name	Description	Condition(s)
REVA	rain evaporation	NMOM_C>=1
HIN	heterogeneous ice nucleation	no condition
DEPS	deposition on snow	no condition
DEPG	deposition on graupel	no condition
DEPH	deposition on hail	CCLOUD=’ICE4’
ADJU	adjustment to saturation	LRED=T and LADJ_BEFORE=T and CELEC/=’ELE3’
DEPI	condensation/deposition on ice	LRED=F or ( LRED=T and LADJ_AFTER=T) or CELEC/=’NONE’
CORR	correction	LRED=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

C2R2 / KHKO source terms

Name	Description	Condition(s)
HENU	heterogeneous nucleation	LSUPSAT=F or (CACTCCN=’ABRK’ and (LORILAM=T or LDUST=T or LSALT=T))
REVA	rain evaporation	NMOM_R>=1
COND	vapor condensation or cloud water evaporation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

KESS source terms

Name	Description	Condition(s)
REVA	rain evaporation	no condition
COND	vapor condensation or cloud water evaporation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

REVE source terms

Name	Description	Condition(s)
COND	vapor condensation or cloud water evaporation	no condition

NAM_BU_RSV

NAM_BU_RSV content
Fortran name	Fortran type	Default value
LBU_RSV	LOGICAL	.FALSE.
CBULIST_RSV	CHARACTER(LEN=128)(:)

LBU_RSV : flag to activate budget for scalar variable
CBULIST_RSV : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RSV array and the conditions of their availability:

General source terms

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_SV=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFSV=T
REL	relaxation	LHORELAX_SV(jsv)=T or corresponding LHOREAX_SV*=T or (CELEC/=’NONE’ and LRELAX2FW_ION=T and (jsv=NSV_ELECBEG or jsv=NSV_ELECEND) )
DCONV	KAFR convection	CDCONV=’KAFR’ or CSCONV=’KAFR’
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
MAFL	mass flux	CSCONV=’EDKF’
NEGA2	negativity correction	no condition

with jsv the scalar variable number.

C2R2 / KHKO source terms

Common source terms for C2R2 / KHKO :

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NEGA	negativity correction	no condition
NECON	negativity correction induced by condensation	no condition

Concentration of activated nuclei for C2R2 / KHKO :

Name	Description	Condition(s)
HENU	CCN activation	LSUPSAT=F or (CACTCCN=’ABRK’ and (LORILAM=T or LDUST=T or LSALT=T))
CEVA	evaporation	no condition

Concentration of cloud droplets for C2R2 / KHKO :

Name	Description	Condition(s)
DEPOTR	tree droplet deposition	LDRAGTREE=T and LDEPOTREE=T
HENU	CCN activation	LSUPSAT=F or (CACTCCN=’ABRK’ and (LORILAM=T or LDUST=T or LSALT=T))
SELF	self-collection of cloud droplets	NMOM_R>=1
ACCR	accretion of cloud droplets	NMOM_R>=1
SEDI	sedimentation	LSEDC=T
DEPO	surface droplet deposition	LDEPOC=T
CEVA	evaporation	no condition

Concentration of raindrops for C2R2 / KHKO :

Name	Description	Condition(s)
AUTO	autoconversion into rain	NMOM_R>=1
SCBU	self collection - coalescence/break-up	CCLOUD/=’KHKO’
REVA	rain evaporation	NMOM_R>=1
BRKU	spontaneous break-up	NMOM_R>=1
SEDI	sedimentation	no condition

Supersaturation for C2R2 / KHKO :

Name	Description	Condition(s)
CEVA	evaporation	no condition

LIMA source terms

Common source terms for LIMA :

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NEGA	negativity correction	no condition
NECON	negativity correction induced by condensation	no condition

Concentration of cloud droplets for LIMA :

Name	Description	Condition(s)
DEPOTR	tree droplet deposition	LDRAGTREE=T and LDEPOTREE=T
SEDI	sedimentation of cloud	NMOM_C>=1 and LSEDC=T
DEPO	surface droplet deposition	NMOM_C>=1 and LDEPOC=T
R2C1	rain to cloud change after sedimentation	LPTSPLIT=T and NMOM_C>=1 and NMOM_R>=1
HENU	CCN activation	NMOM_C>=1 and LACTI=T and NMOD_CCN>0 and (LPTSPLIT=F or LSUBG_COND=F)
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T
SELF	self-collection of cloud droplets	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
AUTO	autoconversion into rain	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
ACCR	accretion of cloud droplets	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
REVA	evaporation of rain drops	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
HONC	droplet homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T)
IMLT	melting of ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
RIM	riming of cloud water	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CVRC	rain to cloud change after other microphysical processes	LPTSPLIT=T
WETH	wet growth of hail	LPTSPLIT=T or NMOM_H>=1
CEDS	adjustment to saturation	NMOM_C>=1
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

Concentration of raindrops for LIMA :

Name	Description	Condition(s)
SEDI	sedimentation	NMOM_C>=1 and NMOM_R>=1
R2C1	rain to cloud change after sedimentation	LPTSPLIT=T and NMOM_C>=1 and NMOM_R>=1
AUTO	autoconversion into rain	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
SCBU	self collection - coalescence/break-up	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
REVA	rain evaporation	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
BRKU	spontaneous break-up	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
HONR	rain homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_R>=1 and LNUCL=T)
ACC	accretion of rain on aggregates	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and NMOM_R>=1)
CFRZ	conversion freezing of rain	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
GMLT	graupel melting	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CVRC	rain to cloud change after other microphysical processes	LPTSPLIT=T
WETH	wet growth of hail	LPTSPLIT=T or NMOM_H>=1
HMLT	melting of hail	LPTSPLIT=T or NMOM_H>=1
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

Concentration of free CCN for LIMA :

Name	Description	Condition(s)
HENU	CCN activation	NMOM_C>=1 and LACTI=T and NMOD_CCN>0 and (LPTSPLIT=F or LSUBG_COND=F)
HONH	haze homogeneous nucleation	NMOM_I>=1 and LNUCL=T and LHHONI=T and NMOD_CCN>0
CEDS	adjustment to saturation	NMOM_C>=1
SCAV	scavenging	LSCAV=T

Concentration of activated CCN for LIMA :

Name	Description	Condition(s)
HENU	CCN activation	NMOM_C>=1 and LACTI=T and NMOD_CCN>0 and (LPTSPLIT=F or LSUBG_COND=F)
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T and LMEYERS=F
CEDS	adjustment to saturation	NMOM_C>=1

Scavenged mass variable for LIMA :

Name	Description	Condition(s)
SCAV	scavenging	LSCAV=T and LAERO_MASS=T
CEDS	adjustment to saturation	LSCAV=T and LAERO_MASS=T and LSPRO=F

Concentration of pristine ice crystals for LIMA :

Name	Description	Condition(s)
SEDI	sedimentation	NMOM_I>=1 and LSEDI=T
HIND	heterogeneous nucleation by deposition	NMOM_I>=1 and LNUCL=T
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T
HONH	haze homogeneous nucleation	NMOM_I>=1 and LNUCL=T and LHHONI=T and NMOD_CCN>0
HONC	droplet homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T)
CNVI	conversion of snow to cloud ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
CNVS	conversion of pristine ice to snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
AGGS	aggregation of snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
IMLT	melting of ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
HMS	Hallett-Mossop ice multiplication process due to snow riming	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CIBU	ice multiplication process due to ice collisional breakup	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and LCIBU=T)
CFRZ	conversion freezing of rain	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
RDSF	ice multiplication process following rain contact freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and LRDSF=T)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
HMG	Hallett-Mossop ice multiplication process due to graupel riming	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or NMOM_H>=1
CEDS	adjustment to saturation	LPTSPLIT=F and LSPRO=F
CORR2	supplementary correction inside LIMA splitting	LPTSPLIT=T

Concentration of snow for LIMA :

Name	Description	Condition(s)
SEDI	sedimentation	NMOM_S>=2
CNVI	conversion of snow to cloud ice	NMOM_S>=2
CNVS	conversion of pristine ice to snow	NMOM_S>=2
BRKU	break up of snow	NMOM_S>=2
RIM	heavy riming of cloud droplet on snow	NMOM_S>=2
ACC	accretion of rain on snow	NMOM_S>=2
CMEL	conversion melting of snow	NMOM_S>=2
WETG	wet growth of graupel	NMOM_S>=2
DRYG	dry growth of graupel	NMOM_S>=2
WETH	wet growth of hail	NMOM_S>=2
SSC	snow self collection	NMOM_S>=2
CEDS	adjustment to saturation	LPTSPLIT=F and NMOM_I>=1 and LSPRO=F

Concentration of graupel for LIMA :

Name	Description	Condition(s)
SEDI	sedimentation	NMOM_G>=2
RIM	heavy riming of cloud droplet on snow	NMOM_G>=2
ACC	accretion of rain on snow	NMOM_G>=2
CMEL	conversion melting of snow	NMOM_G>=2
CFRZ	conversion freezing of raindrop	NMOM_G>=2
WETG	wet growth of graupel	NMOM_G>=2
GMLT	raupel melting	NMOM_G>=2
WETH	wet growth of hail	NMOM_G>=2
COHG	conversion hail graupel	NMOM_G>=2
CEDS	adjustment to saturation	LPTSPLIT=F and NMOM_I>=1 and LSPRO=F

Concentration of hail for LIMA :

Name	Description	Condition(s)
SEDI	sedimentation	NMOM_H>=2
WETG	wet growth of graupel	NMOM_H>=2
COHG	conversion hail graupel	NMOM_H>=2
HMLT	hail melting	NMOM_H>=2

Concentration of free IFN for LIMA :

Name	Description	Condition(s)
HIND	heterogeneous nucleation by deposition	NMOM_I>=1 and LNUCL=T and LMEYERS=F
CEDS	adjustment to saturation	NMOM_I>=1 and LPTSPLIT=F and LSPRO=F
SCAV	scavenging	LSCAV=T

Concentration of nucleated IFN for LIMA :

Name	Description	Condition(s)
HIND	heterogeneous nucleation by deposition	NMOM_I>=1 and LNUCL=T and (LMEYERS=F or jsv=NSV_LIMA_IFN_NUCL)
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T and LMEYERS=T and jsv=NSV_LIMA_IFN_NUCL
IMLT	melting of ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
CEDS	adjustment to saturation	NMOM_I>=1 and LPTSPLIT=F and LSPRO=F

with jsv the scalar variable number.

Concentration of nucleated IMM for LIMA :

Name	Description	Condition(s)
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T and LMEYERS=F
CEDS	adjustment to saturation	NMOM_I>=1 and LPTSPLIT=F and LSPRO=F

Homogeneous freezing of CCN for LIMA :

Name	Description	Condition(s)
HONH	haze homogeneous nucleation	NMOM_I>=1 and LNUCL=T and ( (LHHONI=T and NMOD_CCN>0) or (LPTSPLIT=F and NMOM_C>=1) )

Supersaturation for LIMA :

Name	Description	Condition(s)
CEDS	adjustment to saturation	no condition

Electricity source terms

Common source terms for electricity :

Name	Description	Condition(s)
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NEGA	negativity correction	no condition
NECON	negativity correction induced by condensation	no condition

Positive ions :

Name	Description	Condition(s)
DRIFT	ion drift motion	no condition
CORAY	cosmic ray source	no condition
ADJU	adjustement to saturation	CCLOUD(1:3)=’ICE’ and LRED=T and LADJ_BEFORE
DEPS	deposition on snow	no condition
DEPG	deposition on graupel	no condition
REVA	rain evaporation	NMOM_C>=1
DEPI	condensation/deposition on ice	CCLOUD(1:3)=’ICE’ and (LRED=F or LADJ_AFTER)
CEDS	adjustement to saturation	CCLOUD=’LIMA’
NEUT	neutralization	no condition
SUBI	sublimation of ice crystals	CCLOUD=’LIMA’ and LPTSPLIT=T
CORR2	supplementary correction inside LIMA splitting	CCLOUD=’LIMA’ and LPTSPLIT=T

Volumetric charge of cloud droplets :

Name	Description	Condition(s)
ADJU	adjustement to saturation	CCLOUD(1:3)=’ICE’ and LRED=T and LADJ_BEFORE
HON	homogeneous nucleation	no condition
AUTO	autoconversion into rain	NMOM_C>=1
ACCR	accretion of cloud droplets	NMOM_C>=1
RIM	riming of cloud water	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
INCG	inductive charge transfer between cloud droplets and graupel	LINDUCTIVE=T
WETH	wet growth of hail	CCLOUD=’ICE4’
IMLT	melting of ice	no condition
BERFI	Bergeron-Findeisen	no condition
SEDI	sedimentation	LSEDIC=T
DEPI	condensation/deposition on ice	CCLOUD(1:3)=’ICE’ and (LRED=F or LADJ_AFTER)
CEDS	adjustement to saturation	CCLOUD=’LIMA’
NEUT	neutralization	no condition
R2C1	rain to cloud change after sedimentation	CCLOUD=’LIMA’ and LPTSPLIT=T and NMOM_C>=1 NMOM_R>=1
CORR2	supplementary correction inside LIMA splitting	CCLOUD=’LIMA’ and LPTSPLIT=T
CMEL	collection by snow and conversion into rain with T>XTT on ice	CCLOUD(1:3)=’ICE’ and LRED=T

Volumetric charge of rain drops :

Name	Description	Condition(s)
SFR	spontaneous freezing	no condition
AUTO	autoconversion into rain	NMOM_C>=1
ACCR	accretion of cloud droplets	NMOM_C>=1
REVA	rain evaporation	NMOM_C>=1
ACC	accretion of rain on aggregates	no condition
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
GMLT	graupel melting	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
HMLT	melting of hail	CCLOUD=’ICE4’
SEDI	sedimentation	no condition
NEUT	neutralization	no condition
R2C1	rain to cloud change after sedimentation	CCLOUD=’LIMA’ and LPTSPLIT=T and NMOM_C>=1 NMOM_R>=1
CORR2	supplementary correction inside LIMA splitting	CCLOUD=’LIMA’ and LPTSPLIT=T
CMEL	collection by snow and conversion into rain with T>XTT on ice	CCLOUD(1:3)=’ICE’ and LRED=T
RDSF	raindrop shattering by freezing	CCLOUD=’LIMA’ and LPTSPLIT=T and LRDSF=T

Volumetric charge of ice crystals :

Name	Description	Condition(s)
ADJU	adjustement to saturation	CCLOUD(1:3)=’ICE’ and LRED=T and LADJ_BEFORE
HON	homogeneous nucleation	no condition
AGGS	aggregation of snow	no condition
AUTS	autoconversion of ice	no condition
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
IMLT	melting of ice	no condition
BERFI	Bergeron-Findeisen	no condition
NIIS	non-inductive charge separation due to ice-snow collisions	no condition
NIIG	non-inductive charge separation due to ice-graupel collisions	no condition
SEDI	sedimentation	no condition
DEPI	condensation/deposition on ice	CCLOUD(1:3)=’ICE’ and (LRED=F or LADJ_AFTER)
CEDS	adjustement to saturation	CCLOUD=’LIMA’
NEUT	neutralization	no condition
CNVI	conversion of snow to cloud ice	CCLOUD=’LIMA’ and LPTSPLIT=T
SUBI	sublimation of ice crystals	CCLOUD=’LIMA’ and LPTSPLIT=T
HMS	Hallett-Mossop ice multiplication process due to snow riming	CCLOUD=’LIMA’ and LPTSPLIT=T
HMG	Hallett-Mossop ice multiplication process due to graupel riming	CCLOUD=’LIMA’ and LPTSPLIT=T
CIBU	collisional ice breakup	CCLOUD=’LIMA’ and LPTSPLIT=T and LCIBU=T
RDSF	raindrop shattering by freezing	CCLOUD=’LIMA’ and LPTSPLIT=T and LRDSF=T
CORR2	supplementary correction inside LIMA splitting	CCLOUD=’LIMA’ and LPTSPLIT=T

Volumetric charge of snow :

Name	Description	Condition(s)
DEPS	deposition on snow	no condition
AGGS	aggregation of snow	no condition
AUTS	autoconversion of ice	no condition
RIM	riming of cloud water	no condition
ACC	accretion of rain on snow	no condition
CMEL	conversion melting	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
NIIS	non-inductive charge separation due to ice-snow collisions	no condition
NISG	non-inductive charge separation due to snow-graupel collisions	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
SEDI	sedimentation	no condition
CNVI	conversion of snow to cloud ice	CCLOUD=’LIMA’ and LPTSPLIT=T
HMS	Hallett-Mossop ice multiplication process due to snow riming	CCLOUD=’LIMA’ and LPTSPLIT=T
CIBU	collisional ice breakup	CCLOUD=’LIMA’ and LPTSPLIT=T and LCIBU=T
NEUT	neutralization	no condition

Volumetric charge of graupel :

Name	Description	Condition(s)
SFR	spontaneous freezing	no condition
DEPG	deposition on graupel	no condition
RIM	riming of cloud water	no condition
ACC	accretion of rain on graupel	no condition
CMEL	conversion melting	no condition
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
INCG	inductive charge transfer between cloud droplets and graupel	LINDUCTIVE=T
NIIG	non-inductive charge separation due to ice-graupel collisions	no condition
NISG	non-inductive charge separation due to snow-graupel collisions	no condition
GMLT	graupel melting	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
SEDI	sedimentation	no condition
HMG	Hallett-Mossop ice multiplication process due to graupel riming	CCLOUD=’LIMA’ and LPTSPLIT=T
NEUT	neutralization	no condition

Negative ions :

Name	Description	Condition(s)
DRIFT	ion drift motion	no condition
CORAY	cosmic ray source	no condition
ADJU	adjustement to saturation	CCLOUD(1:3)=’ICE’ and LRED=T and LADJ_BEFORE
DEPS	deposition on snow	no condition
DEPG	deposition on graupel	no condition
REVA	rain evaporation	NMOM_C>=1
DEPI	condensation/deposition on ice	CCLOUD(1:3)=’ICE’ and (LRED=F or LADJ_AFTER)
CEDS	adjustement to saturation	CCLOUD=’LIMA’
NEUT	neutralization	no condition
SUBI	sublimation of ice crystals	CCLOUD=’LIMA’ and LPTSPLIT=T
CORR2	supplementary correction inside LIMA splitting	CCLOUD=’LIMA’ and LPTSPLIT=T

Chemistry

Name	Description	Condition(s)
CHEM	chemistry activity	no condition
NEGA	negativity correction	no condition

Chemical aerosols

Name	Description	Condition(s)
NEGA	negativity correction	no condition

Blowing snow

Name	Description	Condition(s)
SNSUB	blowing snow sublimation	LBLOWSNOW=T and LSNOWSUBL=T
SNSED	blowing snow sedimentation	LBLOWSNOW=T

NAM_BU_RTH

NAM_BU_RTH content
Fortran name	Fortran type	Default value
LBU_RTH	LOGICAL	.FALSE.
CBULIST_RTH	CHARACTER(LEN=128)(:)

LBU_RTH : flag to activate budget for potential temperature
CBULIST_RTH : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RTH array and the conditions of their availability:

Source terms (except water microphysical schemes)

Name	Description	Condition(s)
ALL	all available source terms (separated, water microphysics included)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_TH=T
OCEAN	radiative tendency due to SW penetrating ocean	LOCEAN .AND. (.NOT. LCOUPLES)
ADV	total advection	no condition
FRC	forcing	LFORCING=T
2DADV	advective forcing	L2D_ADV_FRC=T
2DREL	relaxation forcing	L2D_REL_FRC=T
NUD	nudging	LNUDGING=T
PREF	reference pressure	L1D=F and number of moist variables > 0
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_UVWTH=T or LVE_RELAX=T or LVE_RELAX_GRD=T
RAD	radiation	CRAD/=’NONE’
DCONV	KAFR convection	CDCONV=’KAFR’ or CSCONV=’KAFR’
BLAZE	Blaze fire model	LBLAZE=T
DRAGB	heat released by buildings	LDRAGBLDG=T
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
DISSH	dissipation	CTURB=’TKEL’
MAFL	mass flux	CSCONV=’EDKF’
SNSUB	blowing snow sublimation	LBLOWSNOW=T and LSNOWSUBL=T

LIMA source terms

Name	Description	Condition(s)
SEDI	heat transport by hydrometeors sedimentation	LPTSPLIT=T
HENU	heterogeneous nucleation	NMOM_C>=1 and LACTI=T and NMOD_CCN>0 and (LPTSPLIT=F or LSUBG_COND=F)
REVA	rain evaporation	LPTSPLIT=T or (NMOM_C>=1 and NMOM_R>=1)
HIN	heterogeneous ice nucleation	NMOM_I=1
HIND	heterogeneous nucleation by deposition	NMOM_I>=1 and LNUCL=T
HINC	heterogeneous nucleation by contact	NMOM_I>=1 and LNUCL=T
HONH	haze homogeneous nucleation	NMOM_I>=1 and LNUCL=T and LHHONI=T and NMOD_CCN>0
HONC	droplet homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T)
HONR	rain homogeneous freezing	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and LNUCL=T and NMOM_R>=1)
DEPS	deposition on snow	LPTSPLIT=T or (NMOM_I>=1 and NMOM_S>=1)
DEPI	condensation/deposition on ice	LPTSPLIT=T
DEPG	deposition on graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DEPH	deposition on hail	LPTSPLIT=T or NMOM_H>=1
IMLT	melting of ice	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
BERFI	Bergeron-Findeisen	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1)
RIM	riming of cloud water	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
ACC	accretion of rain on aggregates	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1 and NMOM_R>=1)
CFRZ	conversion freezing of rain	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETG	wet growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
DRYG	dry growth of graupel	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
GMLT	graupel melting	LPTSPLIT=T or (NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
WETH	wet growth of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
HMLT	melting of hail	LPTSPLIT=T or (NMOM_H>=1 and NMOM_I>=1 and NMOM_C>=1 and NMOM_S>=1)
CEDS	adjustment to saturation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

ICE3 / ICE4 source terms

Name	Description	Condition(s)
REVA	rain evaporation	NMOM_C>=1
HIN	heterogeneous ice nucleation	no condition
HON	homogeneous nucleation	no condition
SFR	spontaneous freezing	no condition
DEPS	deposition on snow	no condition
DEPG	deposition on graupel	no condition
DEPH	deposition on hail	CCLOUD=’ICE4’
IMLT	melting of ice	no condition
BERFI	Bergeron-Findeisen	no condition
RIM	riming of cloud water	no condition
ACC	accretion of rain on aggregates	no condition
CFRZ	conversion freezing of rain	no condition
WETG	wet growth of graupel	no condition
DRYG	dry growth of graupel	no condition
GMLT	graupel melting	no condition
WETH	wet growth of hail	CCLOUD=’ICE4’
DRYH	dry growth of hail	CCLOUD=’ICE4’ and LRED=T and CELEC=’NONE’
HMLT	melting of hail	CCLOUD=’ICE4’
ADJU	adjustment to saturation	LRED=T and LADJ_BEFORE=T and CELEC/=’ELE3’
DEPI	condensation/deposition on ice	LRED=F or ( LRED=T and LADJ_AFTER=T) or CELEC/=’NONE’
CORR	correction	LRED=T and CELEC/=’ELE3’
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

C2R2 / KHKO source terms

Name	Description	Condition(s)
HENU	heterogeneous nucleation	LSUPSAT=F or (CACTCCN=’ABRK’ and (LORILAM=T or LDUST=T or LSALT=T))
REVA	rain evaporation	NMOM_R>=1
COND	vapor condensation or cloud water evaporation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

KESS source terms

Name	Description	Condition(s)
REVA	rain evaporation	no condition
COND	vapor condensation or cloud water evaporation	no condition
NEGA	negativity correction	no condition
NETUR	negativity correction induced by turbulence	CTURB=’TKEL’
NEADV	negativity correction induced by advection	no condition
NECON	negativity correction induced by condensation	no condition

REVE source terms

Name	Description	Condition(s)
COND	vapor condensation or cloud water evaporation	no condition

NAM_BU_RTKE

NAM_BU_RTKE content
Fortran name	Fortran type	Default value
LBU_RTKE	LOGICAL	.FALSE.
CBULIST_RTKE	CHARACTER(LEN=128)(:)

LBU_RTKE : flag to activate budget for turbulent kinetic energy
CBULIST_RTKE : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RTKE array and the conditions of their availability:

Name	Description	Condition(s)
ALL	all available source terms (separated)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
ADV	total advection	no condition
FRC	forcing	LFORCING=T
DIF	numerical diffusion	LNUMDIFTH=T
REL	relaxation	LHORELAX_TKE=T
DRAG	drag force	LDRAGTREE=T
DRAGB	drag force due to buildings	LDRAGBLDG=T
DP	dynamic production	no condition
TP	thermal production	no condition
DISS	dissipation of TKE	no condition
TR	turbulent transport	no condition

NAM_BU_RU

NAM_BU_RU content
Fortran name	Fortran type	Default value
LBU_RU	LOGICAL	.FALSE.
CBULIST_RU	CHARACTER(LEN=128)(:)

LBU_RU : flag to activate budget for u-wind
CBULIST_RU : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RU array and the conditions of their availability:

Name	Description	Condition(s)
ALL	all available source terms (separated)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_UVW=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
NUD	nudging	LNUDGING=T
CURV	curvature	L1D=F and LCARTESIAN=F
COR	Coriolis	LCORIO=T
DIF	numerical diffusion	LNUMDIFU=T
REL	relaxation	LHORELAX_UVWTH=T or LVE_RELAX=T or LVE_RELAX_GRD=T
DRAG	drag force	LDRAGTREE=T
DRAGEOL	drag force due to wind turbine	LMAIN_EOL=T
DRAGB	drag force due to buildings	LDRAGBLDG=T
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
MAFL	mass flux	CSCONV=’EDKF’
PRES	pressure	no condition

NAM_BU_RV

NAM_BU_RV content
Fortran name	Fortran type	Default value
LBU_RV	LOGICAL	.FALSE.
CBULIST_RV	CHARACTER(LEN=128)(:)

LBU_RV : flag to activate budget for v-wind
CBULIST_RV : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RV array and the conditions of their availability:

Name	Description	Condition(s)
ALL	all available source terms (separated)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_UVW=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
NUD	nudging	LNUDGING=T
CURV	curvature	L1D=F and LCARTESIAN=F
COR	Coriolis	LCORIO=T
DIF	numerical diffusion	LNUMDIFU=T
REL	relaxation	LHORELAX_UVWTH=T or LVE_RELAX=T or LVE_RELAX_GRD=T
DRAG	drag force	LDRAGTREE=T
DRAGEOL	drag force due to wind turbine	LMAIN_EOL=T
DRAGB	drag force due to buildings	LDRAGBLDG=T
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
MAFL	mass flux	CSCONV=’EDKF’
PRES	pressure	no condition

NAM_BU_RW

NAM_BU_RW content
Fortran name	Fortran type	Default value
LBU_RW	LOGICAL	.FALSE.
CBULIST_RW	CHARACTER(LEN=128)(:)

LBU_RW : flag to activate budget for w-wind
CBULIST_RW : list of source terms

Note

Description of the names to be used for the different source terms in the CBULIST_RW array and the conditions of their availability:

Name	Description	Condition(s)
ALL	all available source terms (separated)	no condition
ASSE	time filter (Asselin)	CUVW_ADV_SCHEME(1:3)=’CEN’ and CTEMP_SCHEME=’LEFR’
NEST	nesting	NMODEL>1
VISC	viscosity	LVISC=T and LVISC_UVW=T
ADV	total advection	no condition
FRC	forcing	LFORCING=T
NUD	nudging	LNUDGING=T
CURV	curvature	L1D=F and LCARTESIAN=F and LTHINSHELL=F
COR	Coriolis	LCORIO=T and LTHINSHELL=F
DIF	numerical diffusion	LNUMDIFU=T
REL	relaxation	LHORELAX_UVWTH=T or LVE_RELAX=T or LVE_RELAX_GRD=T
HTURB	horizontal turbulent diffusion	CTURB=’TKEL’ and CTURBDIM=’3DIM’
VTURB	vertical turbulent diffusion	CTURB=’TKEL’
GRAV	gravity	no condition
PRES	pressure	no condition
DRAGEOL	drag force due to wind turbine	LMAIN_EOL=T

NAM_CH_MNHCn

NAM_CH_MNHCn content
Fortran name	Fortran type	Default value
LUSECHEM	LOGICAL	.FALSE.
LUSECHAQ	LOGICAL	.FALSE.
LUSECHIC	LOGICAL	.FALSE.
LCH_INIT_FIELD	LOGICAL	.FALSE.
LCH_CONV_SCAV	LOGICAL	.FALSE.
LCH_CONV_LINOX	LOGICAL	.FALSE.
LCH_PH	LOGICAL	.FALSE.
LCH_RET_ICE	LOGICAL	.FALSE.
XCH_PHINIT	REAL	5.2
XRTMIN_AQ	REAL	5.e-8
CCHEM_INPUT_FILE	CHARACTER(LEN=128)	‘EXSEG1.nam’
CCH_TDISCRETIZATION	CHARACTER(LEN=10)	‘SPLIT’
NCH_SUBSTEPS	INTEGER	1
LCH_TUV_ONLINE	LOGICAL	.TRUE.
CCH_TUV_LOOKUP	CHARACTER(LEN=128)	‘PHOTO.TUV39’
CCH_TUV_CLOUDS	CHARACTER(LEN=4)	‘NONE’
XCH_TUV_ALBNEW	REAL	-1.0
XCH_TUV_DOBNEW	REAL	-1.0
XCH_TUV_TUPDATE	REAL	600.0
CCH_VEC_METHOD	CHARACTER(LEN=3)	‘MAX’
NCH_VEC_LENGTH	INTEGER	50
XCH_TS1D_TSTEP	REAL	600.0
CCH_TS1D_COMMENT	CHARACTER(LEN=80)	‘no comment’
CCH_TS1D_FILENAME	CHARACTER(LEN=128)	‘IO1D’

LUSECHEM : switch to activate chemistry.
LUSECHAQ : switch to activate aqueous phase chemistry.
LUSECHIC : switch to activate ice phase chemistry. This means that several pronostics variables are added equal to the number of solubles gases. These variables represent the mixing ratio of the soluble gases inside the precipitating iced hydrometeors.
LCH_INIT_FIELD : switch to activate initialization subroutine CH_INIT_FIELD_n. If .TRUE. initialized with ASCII file, if .FALSE. initialized with MOCAGE.
LCH_CONV_SCAV : switch to activate scavenging of chemical species (gazeous or aerosol) and dusts by convective precipitations.
LCH_CONV_LINOX : switch to activate the production of NOx by LIghtning flashes inside deep convective clouds and its transport (LCHTRANS must be set to TRUE).
- LUSECHEM=.FALSE. : a scalar variable named LINOX are written in the Meso-NH file
- LUSECHEM=.TRUE. : the convective source is added to the NO chemical variable.
LCH_PH : switch to activate the computing of pH in cloud water and rainwater as diagnostic variables. XPHC and XPHR are added in synchronous backup files.
LCH_RET_ICE : switch to activate the retention of solubles gase in iced hydrometeors without considering additional pronostics variables. LUSECHIC is set to FALSE. Be carefull this option leads to a loss of mass.
XCH_PHINIT : pH value when aqueous phase chemistry is activated (LUSECHAQ is set to TRUE).
- LCH_PH=.TRUE. : XCH_PHINIT is the initial pH value,
- LCH_PH=.FALSE. : XCH_PHINIT is the constant pH value during the whole simulation.
XRTMIN_AQ : when aqueous phase chemistry is activated (LUSECHAQ is set to TRUE), XRTMIN_AQ is the threshold value for cloud water (or rainwater) content from which aqueous phase chemistry and exchange between gas and liquid phases are computed.
CCHEM_INPUT_FILE : name of the general purpose input file.
CCH_TDISCRETIZATION : temporal discretization
- ‘SPLIT’ : use time-splitting, input fields for solver are scalar variables at t+dt (derived from XRSVS)
- ‘CENTER’ : use centered tendencies, input fields for solver are scalar variables at t (XSVT)
- ‘LAGGED’ : use lagged tendencies, input fields for solver are scalar variables at t-dt (XSVM)
NCH_SUBSTEPS : number of steps to be taken by the solver during two time steps of MesoNH; the time step of the solver is thus equal to 2*XTSTEP/NCH_SUBSTEPS
LCH_TUV_ONLINE : switch to activate online photolysis rates calculations (only for 1D simulation). If false, photolysis rates are pre-calculated as a function of solar zenith angle and surface albedo and interpolated on the model grid.
CCH_TUV_LOOKUP : name of the lookup table file.
CCH_TUV_CLOUDS : method for calculating the impact of clouds on UV radiations (only for 3-D version)
- ‘NONE’ : No cloud correction on UV radiations
- ‘CHAN’ : Cloud correction on UV radiations following Chang et al., [1987]
XCH_TUV_ALBNEW : surface albedo for photolysis rates calculations (only for 1-D version. For 3-D version, albedos are prescribed as a function of the surface characteristics).
XCH_TUV_DOBNEW : scaling factor for ozone column dobson.
XCH_TUV_TUPDATE : update frequency to refresh photolysis rates.
CCH_VEC_METHOD : type of vectorization mask
- ‘MAX’ : take NCH_VEC_LENGTH points
- ‘TOT’ : take all grid points
- ‘HOR’ : take horizontal layers
- ‘VER’ : take vertical columns
NCH_VEC_LENGTH : number of points for ‘MAX’ option.
XCH_TS1D_TSTEP : time between two call to write_ts1d.
CCH_TS1D_COMMENT : comment for write_ts1d.
CCH_TS1D_FILENAME : filename for write_ts1d files.

NAM_CH_ORILAM

This namelist is used to activate ORILAM chemical aerosols (lognormal distribution for Aitken and accumulation mode). This parameterization include coagulation (intra and inter modal), nucleation, sedimentation, condensation/adsorption of gas phase. This parameterization need to be run together with gas chemical phase (namelist NAM_CH_MNHCn). For correct representation, it is recommended to have severals compounds as HNO3 (nitric acid), H2SO4 (or SULF; sulphates), NH3 (ammonium) and CO (carbon monoxyde) in the chemical scheme.

NAM_CH_ORILAM content
Fortran name	Fortran type	Default value
LORILAM	LOGICAL	.FALSE.
LVARSIGI	LOGICAL	.FALSE.
LVARSIGJ	LOGICAL	.FALSE.
LSEDIMAERO	LOGICAL	.FALSE.
XINIRADIUSI	REAL	0.01
XINIRADIUSJ	REAL	0.5
CRGUNIT	CHARACTER(LEN=4)	‘MASS’
XINISIGI	REAL	1.60
XINISIGJ	REAL	1.60
XN0IMIN	REAL	10.0
XN0JMIN	REAL	1.0
XCOEFRADIMAX	REAL	10.0
XCOEFRADJMAX	REAL	10.0
XCOEFRADIMIN	REAL	0.1
XCOEFRADJMIN	REAL	0.1
CMINERAL	CHARACTER(LEN=5)	‘NONE’
CORGANIC	CHARACTER(LEN=5)	‘NONE’
CNUCLEATION	CHARACTER(LEN=80)	‘MAATTANEN’
LCONDENSATION	LOGICAL	.TRUE.
LCOAGULATION	LOGICAL	.TRUE.
LMODE_MERGING	LOGICAL	.FALSE.

LORILAM : flag to activate chemical aerosol (only if LUSECHEM = .TRUE.).
LVARSIGI : flag to activate variable standard deviation for mode I (Aitken).
LVARSIGJ : flag to activate variable standard deviation for mode J (accumulation).
LSEDIMAERO : flag to activate aerosol sedimentation.
XINIRADIUSI : flag for the initialization of mean radius mode I (Aitken mode) of the distribution (in micrometers).
XINIRADIUSJ : flag for the initialization of mean radius mode J (accumulation mode) of the distribution (in micrometers).
CRGUNIT : type of mean radius given in namelist. Default is for a mass spectral distribution; XINIRADIUSI and XINIRADIUSJ have been converted into a mean radius in number. IF CRGUNIT $\neq$ ‘MASS’ then the mean radius need to be given for a number spectral distribution (no conversion).
XINISIGI : value of standard deviation for mode I (Aitken mode).
XINISIGJ : value of standard deviation for mode J (accumulation mode).
XCOEFRADIMAX : factor to compute maximum value of mean radius mode I (Aitken mode). $R_i^{max} = XCOEFRADIMAX . XINIRADIUSI$
XCOEFRADJMAX : factor to compute maximum value of mean radius mode J (accumulation mode). $R_j^{max} = XCOEFRADJMAX . XINIRADIUSJ$
XCOEFRADIMIN : same as XCOEFRADIMAX but for the minimum value.
XCOEFRADJMIN : same as XCOEFRADIMAX but for the minimum value.
CMINERAL : type of parameterization for mineral gas/particle balance. Possible values are:
- ‘ARES’ : ARES parameterization (non vectorized)
- ‘NARES’: neuronal network of ARES (vectorized)
- ‘ISPIA’: ISORROPIA parameterization (non vectorized)
- ‘TABUL’: tabulation of ISORROPIA (vectorized)
- ‘EQSAM’: EQSAM parameterization (vectorized)
CORGANIC : type of parameterization for organic gas/particle balance. To activate organic parameterization it is necessary to use a chemical scheme capable forming secondary organic aerosol (i.e. RELACS2 or CACM). Possible values are:
- ‘PUN’ : PUN parameterization
- ‘MPMPO’: MPMPO (non vectorized)
CNUCLEATION : type of parameterization for nucleation’s parametrization. Four options are available:
- ‘NONE’ : no nucleation
- ‘KULMALA’ : based on Kulmala et al. [1998]
- ‘VEHKAMAKI’ : based on Vehkamäki [2002]
- ‘MAATTANEN’ : based on Maattanen et al. [2018]
LCONDENSATION : flag to activate the condensation processes.
LCOAGULATION : flag to activate the intra and inter coagulation processes.
LMODE_MERGING : flag to activate the mode merging.
Convective scavenging is activated with LCH_CONV_SCAV in NAM_CH_MNHCn.

NAM_CH_SOLVERn

NAM_CH_SOLVERn content
Fortran name	Fortran type	Default value
CSOLVER	CHARACTER(LEN=32)	‘EXQSSA’
NSSA	INTEGER	0
NSSAINDEX	ARRAY(INTEGER)	1000*0
XRTOL	REAL	0.001
XATOL	REAL	0.1
NRELAB	INTEGER	2
NPED	INTEGER	1
NMAXORD	INTEGER	5
LPETZLD	LOGICAL	.TRUE.
CMETHOD	CHARACTER(LEN=1)	N
CNORM	CHARACTER(LEN=1)	A
NTRACE	INTEGER	0
XALPHA	REAL	0.5
XSLOW	REAL	100.0
XFAST	REAL	0.1
NQSSAITER	INTEGER	1
XDTMIN	REAL	0.1
XDTMAX	REAL	600.0
XDTFIRST	REAL	10.0

CSOLVER : type of numerical method used to resolve the ode system of coupling differential equations for chemistry (chemistry solver). for the description of each method, see the associated ch_routine. rosenbrock’method are gouped in mode_RBK90_Integrator routine. possible values are:
- ‘SIS’
- ‘LINSSA’
- ‘CRANCK’
- ‘QSSA’
- ‘EXQSSA’
- ‘ROS1’
- ‘ROS2’
- ‘ROS3’
- ‘ROS4’
- ‘RODAS3’
- ‘RODAS4’
- ‘ROSENBROCK’: default method ROS1 with ROSENBROCK
NSSA : number of variables to be treated as “steady state”.
NSSAINDEX : index set of steady state variables.
XRTOL : relative tolerance for SVODE and D02EAF, D02EBF, D02NBF methods.
XATOL : absolute tolerance for SVODE and D02NBF.
NRELAB : choose relative error for NAG’s D02EBF solver:
- 1 : for correct decimal places
- 2 : for correct significant digits
- 0 : for a mixture
NPED : calculation parameter of the Jacobian matric for SVODE and NAG’s D02EBF/D02NBF solvers:
- 1 : for analytical Jacobian (using subroutine CH_JAC)
- 0 : for numerical Jacobian
NMAXORD : maximum order for the BDF method (0<NMAXORD<=5) for NAG’s D02NBF solver.
LPETZLD : switch to activate Petzold local error test (recommended) for NAG’s D02NBF solver.
CMETHOD : method to use non-linear system for NAG’s D02NBF solver.
- ‘N’ or ‘D’ : modified Newton iteration
- ‘F’ : functional iteration
CNORM : type of norm to be used for NAG’s D02NBF solver.
- ‘A’ or ‘D’ : averaged L2 norm
- ‘M’ : maximum norm
NTRACE : level of output from D02NBF solver:
- -1 : no output
- 0 : only warnings are printed
- >= 1 : details on Jacobian entries, nonlinear iteration and time integration are given
XALPHA : the Cranck-Nicholson parameter (0,1).
XSLOW : slow species, lifetime > XSLOW * timestep for EXQSSA and QSSA methods.
XFAST : fast species, lifetime < XFAST * timestep for EXQSSA and QSSA methods.
NQSSAITER : number of iterations in QSSA method.
XDTMIN : minimal allowed timestep for EXQSSA.
XDTMAX : maximal allowed timestep for EXQSSA.
XDTFIRST : timestep for first integration step of EXQSSA.

NAM_CONDSAMP

It contains the parameters to activate conditional sampling [Couvreux et al., 2010]. The first tracer is released at the surface, the second one is released XHEIGHT_BASE below the cloud base on XDEPTH_BASE depth the third one is released XHEIGHT_TOP above the cloud top on XDEPTH_TOP depth.

NAM_CONDSAMP content
Fortran name	Fortran type	Default value
LCONDSAMP	LOGICAL	.FALSE.
NCONDSAMP	INTEGER	3
XRADIO	ARRAY(REAL)	3*900.0
XSCAL	ARRAY(REAL)	3*1.0
XHEIGHT_BASE	REAL	100.0
XDEPTH_BASE	REAL	100.0
XHEIGHT_TOP	REAL	100.0
XDEPTH_TOP	REAL	100.0
NFINDTOP	INTEGER	0
XTHVP	REAL	0.25
LTPLUS	LOGICAL	.TRUE.

LCONDSAMP : Flag to activate conditional sampling
NCONDSAMP : Number of conditional samplings
XRADIO : Period of radioactive decay
XSCAL : Scaling factor
XHEIGHT_BASE : Height below the cloud base where the 2nd tracer is released
XDEPTH_BASE : Depth on which the 2nd tracer is released
XHEIGHT_TOP : Height above the cloud top where the 3rd tracer is released
XDEPTH_TOP : Depth on which the 3rd tracer is released
NFINDTOP : Method for identifying the altitude where the 3rd tracer is released :
- 0 (by default) : the top tracer is released above the cloud top
- 1 : the top tracer is released above the layer with the maximum gradient of potential temperature (by default if no clouds)
- 2 : the top tracer is released at the first layer from the surface where the virtual potential temperature exceeds its bottom-up integration plus a threshold XTHVP (by default 0.25K)
XTHVP : Threshold (in Kelvin) to identify the boundary-layer top based on virtual potential temperature (if NFINDTOP = 2)
LTPLUS : Flag to allow the release of 2nd and 3rd tracers one layer below the cloud base and one level above the PBL top (when the layers of emission are not detected)

NAM_CONF

It contains the model configuration parameters common to all the models. They are included in the module MODD_CONF.

NAM_CONF content
Fortran name	Fortran type	Default value
CCONF	CHARACTER(LEN=5)	‘START’
LFLAT	LOGICAL	.FALSE.
CEQNSYS	CHARACTER(LEN=3)	‘DUR’
LFORCING	LOGICAL	.FALSE.
NMODEL	INTEGER	1
NVERB	INTEGER	5
NHALO	INTEGER	1
JPHEXT	INTEGER	1
CSPLIT	CHARACTER(LEN=10)	‘YSPLITTING’
LLG	LOGICAL	.FALSE.
LINIT_LG	LOGICAL	.FALSE.
CINIT_LG	CHARACTER(LEN=6)	‘BACKUP’
LNOMIXLG	LOGICAL	.FALSE.
CEXP	CHARACTER(LEN=32)	‘EXP01’
CSEG	CHARACTER(LEN=32)	‘SEG01’
LCHECK	LOGICAL	.FALSE.

CCONF : configuration of all models
- ‘START’ : for start configuration
- ‘RESTA’ : for restart configuration
CEQNSYS : Equation system resolved by the MESONH model
- ‘LHE’ : Lipps and HEmler anelastic system
- ‘DUR’ : approximated form of the DURran version of the anelastic sytem
- ‘MAE’ : classical Modified Anelastic Equations but with not any approximation in the momentum equation
LFLAT : Flag for zero ororography
- .TRUE. = no orography (zs=0.)
- .FALSE. = the orography is not zero everywhere
LFORCING : Flag to use forcing sources
- .TRUE. : add forcing sources
- .FALSE. : no forcing sources
NMODEL : Number of nested models
NVERB : Level of informations on output-listing
- 0 : for minimum of prints
- 5 : for intermediate level of prints
- 10 : for maximum of prints
NHALO : Size of the halo for parallel distribution. This variable is related to computer performance but has no impact on simulation results. NHALO must be equal to 3 for WENO5 cases in parallel runs.
JPHEXT : Horizontal External points number. JPHEXT must be equal to 3 for cyclic cases with WENO5.
CSPLIT : Kind of domain splitting for parallel distribution. This variable is related to computer performance but has no impact on simulation results
- ‘BSPLITTING’ : domain is decomposed in Box along X and Y
- ‘XSPLITTING’ : the X direction is splitted in stripes along Y
- ‘YSPLITTING’ : the Y direction is splitted in stripes along X
LLG : Flag to use Lagrangian variables
LINIT_LG : Flag to reinitialize Lagrangian variables (with LLG=.T.)
CINIT_LG : with LINIT_LG=T :
- ‘BACKUP’ : each time a backup file is written
- other string : : only when starting a new segment (CCONF=’RESTA’)
LNOMIXLG : Flag to unset the turbulence for LG variables. You must have LNOMIXLG=.TRUE. with CSCONV=’EDKF’
CEXP : Experiment name (name of the set of runs you have performed or want to perform on the same physical subject)
CSEG : Name of segment (name of the future runs you want to perform)
LCHECK : Flag for testing reproducibility

Note

From these last two information, we built the names of the different MESONH backup files: CEXP.n.CSEG.nbr, where n represents the number of the model which generates this output and nbr is the number of the outfile. For instance, if CEXP=’HYDRO’ and CSEG=’INIT1’ and we use only one model (no gridnesting) the different output will be called: HYDRO.1.INIT1.001, HYDRO.1.INIT1.002, …

By default, nbr is coded on 3 digits. This can be modified with the NFILE_NUM_MAX variable of the NAM_CONFIO namelist.

NAM_CONFIO

NAM_CONFIO content
Fortran name	Fortran type	Default value
CIO_DIR	CHARACTER(LEN=512)
LVERB_OUTLST	LOGICAL	.TRUE.
LVERB_STDOUT	LOGICAL	.FALSE.
LVERB_ALLPRC	LOGICAL	.FALSE.
NGEN_VERB	INTEGER	4
NGEN_ABORT_LEVEL	INTEGER	2
NBUD_VERB	INTEGER	4
NBUD_ABORT_LEVEL	INTEGER	2
NIO_VERB	INTEGER	4
NIO_ABORT_LEVEL	INTEGER	2
LIO_COMPRESS	LOGICAL	.TRUE.
CIO_COMPRESS_ALGO	CHARACTER(LEN=10)	‘ZSTD’
NIO_COMPRESS_LEVEL	INTEGER	4
LDIAG_REDUCE_FLOAT_PRECISION	LOGICAL	.FALSE.
LIO_ALLOW_REDUCED_PRECISION_BACKUP	LOGICAL	.FALSE.
LIO_ALLOW_NO_BACKUP	LOGICAL	.FALSE.
LIO_NO_WRITE	LOGICAL	.FALSE.
NFILE_NUM_MAX	INTEGER	999

Warning

If a file is not found in the netCDF fileformat, Meso-NH will check if it exists in the LFI format and use it if found. This could be useful if you need to mix the reading of different files with different fileformats.

CIO_DIR : directory used to write outputs, backups and diachronic files (current directory by default). It can be overridden by CBAK_DIR for backups and diachronic files and by COUT_DIR for outputs.
LVERB_OUTLST : flag to write application messages in OUTPUT_LISTINGn files (in current directory, n is for the current model)
LVERB_STDOUT : flag to write application messages on the standard output
NGEN_VERB : set the verbosity level for generic messages
- 0 : no messages
- 1 : fatal messages
- 2 : error messages (and lower values)
- 3 : warning messages (and lower values)
- 4 : info messages (and lower values)
- 5 : debug messages (and lower values)
NGEN_ABORT_LEVEL : set the minimum level of generic message to abort the application (same levels as for NGEN_VERB)
NBUD_VERB : set the verbosity level for budget messages (same levels as for NGEN_VERB)
NBUD_ABORT_LEVEL : set the minimum level of budget message to abort the application (same levels as for NGEN_VERB)
NIO_VERB : set the verbosity level for IO messages (same levels as for NGEN_VERB)
NIO_ABORT_LEVEL : set the minimum level of IO message to abort the application (same levels as for NGEN_VERB)

Warning

Not all messages use this infrastructure. Therefore, some of them are not affected by these options.

LIO_COMPRESS : enable lossless compression of data for all files. This can have a negative impact on performance. This option takes precedence over their equivalent NAM_BACKUP and NAM_OUTPUT namelists.
CIO_COMPRESS_ALGO: set the compression algorithm (only for files in netCDF format, not for LFI format). The allowed values are ‘ZSTD’ (for Zstandard compression,default value), ‘DEFLATE’ (for zlib compression) or ‘NONE’. This option takes precedence over their equivalent in NAM_BACKUP and NAM_OUTPUT namelists (only if LIO_COMPRESS=.TRUE. which is the default). If set to ‘NONE’, all compression will be disabled (that stands also for lossy compression).
LOUT_COMPRESS_LEVEL : set the compression level. The value must be in the 0 to 9 interval (0 for no compression, 9 for maximum compression). This option takes precedence over their equivalent in NAM_BACKUP and NAM_OUTPUT namelists (only if LIO_COMPRESS=.TRUE. which is the default).
LDIAG_REDUCE_FLOAT_PRECISION : force writing of floating points numbers in single precision for diagnostic files (written by the DIAG program)
LIO_ALLOW_REDUCED_PRECISION_BACKUP : flag to allow writing of backup files with a reduced precision as well as reading of reduced precision files and files written with Meso-NH compiled with a lower precision for integers or reals (ie MNH_INT=4 and MNH_REAL=4).
LIO_ALLOW_NO_BACKUP : allow to have no valid backup time (useful for some tests)
LIO_NO_WRITE : disable file writes (useful for benchs)
NFILE_NUM_MAX : maximum number for numbered files (mainly backup and output files). If less than 1000, the numbers will be on 3 digits. From 1000, they will be on the number of digits of NFILE_NUM_MAX (5 if NFILE_NUM_MAX=12345).

NAM_CONFn

NAM_CONFn content
Fortran name	Fortran type	Default value
LUSERV	LOGICAL	.TRUE.
LUSECI	LOGICAL	.FALSE.
LUSERC	LOGICAL	.FALSE.
LUSERR	LOGICAL	.FALSE.
LUSERI	LOGICAL	.FALSE.
LUSERS	LOGICAL	.FALSE.
LUSERG	LOGICAL	.FALSE.
LUSERH	LOGICAL	.FALSE.
NSV_USER	INTEGER	0

LUSERV : Flag to use vapor mixing ratio ($r_v$)
LUSECI : Flag to use pristine ice ($C_i$)
LUSERC : Flag to use cloud mixing ratio ($r_c$)
LUSERR : Flag to use rain mixing ratio ($r_r$
LUSERI : Flag to use ice mixing ratio ($r_i$)
LUSERS : Flag to use snow mixing ratio ($r_s$)
LUSERG : Flag to use graupel mixing ratio ($r_g$)
LUSERH : Flag to use hail mixing ratio ($r_h$)

Note

You don’t need to fill this records : they are directly managed by CCLOUD.

NSV_USER : Number of user passive scalar variables

Warning

Scalar variables needed for the 2-moment microphysical schemes, lagrangian trajectory, passive pollutants or the chemistry options are treated automatically by the model and should not be counted here.

NAM_CONFZ

NAM_CONFZ content
Fortran name	Fortran type	Default value
NZ_VERB	INTEGER	0
NZ_PROC	INTEGER	0
NB_PROCIO_R	INTEGER	1
NB_PROCIO_W	INTEGER	1
MPI_BUFFER_SIZE	INTEGER	40
LMNH_MPI_BSEND	LOGICAL	.TRUE.
LMNH_MPI_ALLTOALLV_REMAP	LOGICAL	.FALSE.
NZ_SPLITTING	INTEGER	10
NPMAX_T1DFLAT_R	INTEGER	130

NZ_VERB: level of message for NZ solver and I/O
NZ_PROC: number of processes to use in the Z splitting. The default value (0) yields an automatic calculation of the number.
NB_PROCIO_R: number of processes to use for parallel I/O when reading file. The default value (1) yields a reading from 1 file only. If more than 1 file, the 3D field are written as several 2D slices.
NB_PROCIO_W: Number of processes to use for parallel I/O when writing file. The default value (1) yields a writing into 1 file only. If more than 1 file, the 3D field are written as several 2D slices.
MPI_BUFFER_SIZE: default size for MPI_BSEND buffer in $10^6$ bytes. MPI_BUFFER_SIZE corresponds approximately to the size of the domain, that is, $NX*NY*NZ$ for I/O in 1 file, and $NX*NY$ for I/O in N 2D-slice files.
LMNH_MPI_BSEND: during HALO exchange and FFT transposition, switch to use bufferized either MPI_BSEND routine or asynchrone MPI_ISEND routine. Depending on the computer and size of the problem, one or the other option could run faster. MPI_ISEND also uses less memory so MPI_BUFFER_SIZE should be decreased.
LMNH_MPI_ALLTOALLV_REMAP:
- FALSE: FFT remap with send/recv <=> NZ_SPLITTING=10
- TRUE: FFT remap with mpi_alltoallv <=> NZ_SPLITTING=14 (BG/MPICH optimization)
NZ_SPLITTING: setting by namelist for debugging by expert user only. The non-expert user will use LMNH_MPI_ALLTOALLV_REMAP=T/F only: IZ=1=flat_inv; IZ=2=flat_invz; IZ=1+2=the two; +8=P1/P2.
NPMAX_T1DFLAT_R: setting to determine the size of the memory buffer allocated for the GPU version of Meso-NH to store real fields. The total buffer size is this setting multiplied by the number of mesh points. This buffer is used to remove allocations and deallocations that are very costly on GPUs. This value can be increased when needed (if too small, an error will be raised at runtime), but it should not be too large to avoid wasting memory.

NAM_DRAGn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_DRAGn content
Fortran name	Fortran type	Default value
LDRAG	LOGICAL	.FALSE.
LMOUNT	LOGICAL	.FALSE.
NSTART	INTEGER	1
XHSTART	REAL	0.0

LDRAG : Surface no-slip condition activation (instead of free-slip) - Only used with LVISC=T
LMOUNT : Surface no-slip condition activation only over a mountain
NHSTART : Grid point number (in the X-direction) from which the no-slip condition is applied, when LMOUNT = .FALSE.
XHSTART : Height above which the no-slip condition is applied, when LMOUNT = .TRUE..

NAM_DRAGTREEn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

This namelist allows to take into account drag of trees in the atmospheric model instead of SURFEX according to Aumond et al. (2011) in the case of very fine vertical resolution. The Z0 vegetation is therefore reduced to the roughness of grassland in SURFEX (z0v_from_lai.F90). LTREEDRAG in NAM_TREEDRAG of SURFEX must also be activated.

NAM_DRAGTREEn content
Fortran name	Fortran type	Default value
LDRAGTREE	LOGICAL	.FALSE.
LDEPOTREE	LOGICAL	.FALSE.
XVDEPOTREE	REAL	0.02

LDRAGTREE : flag to activate drag of trees
LDEPOTREE : flag for droplet deposition on trees
XVDEPOTREE : Droplet deposition velocity on trees

NAM_DRAGBLDGn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

This namelist allows to couple the Town Energy Balance (SURFEX-TEB) at multiple levels with Meso-NH [Schoetter et al., 2020]. LDRAGBLDG activates the drag force due to buildings at grid points and model levels intersecting the buildings. The prognostic (U,V) wind componentes are reduced, the prognostic subgrid TKE is increased due to the turbulence produced by the wind shear close to the buildings. LFLUXBLDG additionally activates the release of heat and moisture fluxes from buildings at grid points and model levels intersecting the buildings. Otherwise, these fluxes are released at the surface. LDRAGURBVEG activates the drag force due to urban trees at grid points and model levels intersecting the trees. The prognostic (U,V) wind components are reduced, for the prognostic subgrid TKE there is a production term due to the wind shear close to the trees, and a dissipation term representing turbulence destruction by leaves.

When building drag is activated, the roughness length of the urban areas should be reduced to avoid a double counting of building drag via the drag force and the high surface roughness.

Furthermore, for multi-layer coupling, the number of atmospheric model levels sent to SURFEX (NLEV_COUPLE) needs to be specified in NAM_COUPLING_LEVELSn such that all model levels intersecting the buildings are coupled with SURFEX.

NAM_DRAGBLDGn content
Fortran name	Fortran type	Default value
LDRAGBLDG	LOGICAL	FALSE
LFLUXBLDG	LOGICAL	FALSE
LDRAGURBVEG	LOGICAL	FALSE

LDRAGBLDG : flag to activate drag of buildings
LFLUXBLDG : flag to activate release of heat and moisture from buildings at model levels instead of the surface
LDRAGURBVEG : flag to activate drag of urban vegetation

NAM_COUPLING_LEVELSn

This namelist allows to specify the number of atmospheric levels (NLEV_COUPLE) for which the meteorological forcing data is sent to SURFEX. A value of 1 for NLEV_COUPLE corresponds to the standard use of SURFEX; only the lowest atmospheric level is coupled. A value higher than 1 implies multi-layer coupling and is currently only used by the Town Energy Balance TEB, as described in Schoetter et al. [2020].

In the case a value of NLEV_COUPLE greater than 1 is used, the model user must ensure that the height above ground level of the highest model level is larger than the height of the highest building in the domain. Furthermore, the drag force, heat, and moisture fluxes from buildings should be activated in NAM_DRAGBLDGn.

NAM_COUPLING_LEVELSn content
Fortran name	Fortran type	Default value
NLEV_COUPLE	INTEGER	1

NLEV_COUPLE : The number of atmospheric levels sent to SURFEX.

NAM_DUST

This namelist is use to activate explicit aerosol dusts. It is not necessary to use chemistry to activate dusts but it is recommended to activate on-line dust emissions (see SURFEX namelists). Radiative direct effects are automatically deduced from an interpolation table of SHDOM radiative code (Mie).

NAM_DUST content
Fortran name	Fortran type	Default value
LDUST	LOGICAL	.FALSE.
LVARSIG	LOGICAL	.FALSE.
LSEDIMDUST	LOGICAL	.FALSE.
NMODE_DST	INTEGER	3
LRGFIX_DST	LOGICAL	.FALSE.
LDEPOS_DST	LOGICAL	.FALSE.
LPASPOL_DST	LOGICAL	.FALSE.
LSED2MOM_DST	LOGICAL	.FALSE.

LDUST : flag to activate passive dust aerosol.
LVARSIG : flag to activate variable standard deviation for each dust mode.
LSEDIMDUST : flag to activate dust sedimentation.
NMODE_DST : number of lognormal dust modes (maximum of 3 modes).
LRGFIX_DST : flag to use only 1 moment for each dust mode (LRGFIX_DST=’TRUE’ associated to LVARSIG=’FALSE)
LDEPOS_DST : flag to activate wet dust deposition
LPASPOL_DST: emit dust aerosols instead of passive scalar
LSED2MOM_DST: flag to activate multimoment sedimentation

NAM_DYN

It contains the dynamics parameters common to all models. They are included in the module MODD_DYN.

NAM_DYN content
Fortran name	Fortran type	Default value
XSEGLEN	REAL	43200.0
XASSELIN	REAL	0.2
XASSELIN_SV	REAL	0.02
LCORIO	LOGICAL	.TRUE.
LNUMDIFU	LOGICAL	.TRUE.
LNUMDIFTH	LOGICAL	.FALSE.
LNUMDIFSV	LOGICAL	.FALSE.
LZDIFFU	LOGICAL	.FALSE.
XALKTOP	REAL	0.01
XALZBOT	REAL	4000.0
XALKGRD	REAL	0.01
XALZBAS	REAL	0.01

XSEGLEN : Segment length in seconds, corresponding to the duration of the segment simulation.
XASSELIN : Amplitude of the Asselin temporal filter for meteorological variables
XASSELIN_SV : Same as XASSELIN but for scalar variables
LCORIO : Flag to set the Coriolis parameters $f$ and $f^*$ to zero
- .TRUE. the Earth rotation is taken into account
- .FALSE. the Earth rotation effects are neglected
LNUMDIFU : Flag to activate the numerical diffusion for momentum : advised to activate if CUVW_ADV_SCHEME=’CEN4TH’ or ‘CEN2ND’, and to not activate if CUVW_ADV_SCHEME=’WENO_K’ (XT4DIFU in NAM_DYNn defines the intensity of this diffusion).
LNUMDIFTH : Flag to activate the numerical diffusion for meteorological scalar variables (temperature, water substances and TKE) (XT4DIFTH in NAM_DYNn defines the intensity of this diffusion). If CMET_ADV_SCHEME is PPM_01, it is not necessary to activate numerical diffusion.
LNUMDIFSV : Same as LNUMDIFTH but for scalar variables
LZDIFFU : Flag to apply the horizontal diffusion to potential temperature and vapor mixing ratio according to Zängl [2002] adapted to mountainous topography. No amplitude is applied for this type of diffusion.
- .TRUE. : This horizontal diffusion is applied
- .FALSE. : This horizontal diffusion is not applied

Note

This flag is independant from LNUMDIFU and LNUMDIFSV, applied to the dynamical variables and the scalar variables respectively.

XALKTOP : Maximum value of the Rayleigh damping (in $s^{-1}$) for the upper absorbing layer.

The shape of the absorbing layer is a $\sin^2$ of $\hat{z}$ (see the scientific documentation for more details). To use with LVE_RELAX=T in NAM_DYNn.

XALZBOT : Height (in meters) in the physical space of the base of the upper absorbing layer. To use with LVE_RELAX=T in NAM_DYNn.
XALKGRD : Maximum value of the Rayleigh damping (in $s^{-1}$) for the lower absorbing layer. To use with LVE_RELAX_GRD=T in NAM_DYNn.
XALZBAS : Height (in meters) in the physical space of the top of the ground absorbing layer. To use with LVE_RELAX_GRD=T in NAM_DYNn.

NAM_DYNn

It contains the specific dynamic parameters for the model n. They are included in the module MODD_DYNn.

NAM_DYNn content
Fortran name	Fortran type	Default value
XTSTEP	REAL	60.0
CPRESOPT	CHARACTER(LEN=4)	‘CRESI’
NITR	INTEGER	4
LRES	LOGICAL	.FALSE.
XRES	REAL	1.E-07
LITRADJ	LOGICAL	.TRUE.
XRELAX	REAL	1.0
LHORELAX_UVWTH	LOGICAL	.FALSE.
LHORELAX_RV	LOGICAL	.FALSE.
LHORELAX_RC	LOGICAL	.FALSE.
LHORELAX_RR	LOGICAL	.FALSE.
LHORELAX_RI	LOGICAL	.FALSE.
LHORELAX_RS	LOGICAL	.FALSE.
LHORELAX_RG	LOGICAL	.FALSE.
LHORELAX_RH	LOGICAL	.FALSE.
LHORELAX_TKE	LOGICAL	.FALSE.
LHORELAX_SV	array LOGICAL	.FALSE.
LHORELAX_SVC2R2	LOGICAL	.FALSE.
LHORELAX_SVLIMA	LOGICAL	.FALSE.
LHORELAX_SVLG	LOGICAL	.FALSE.
LHORELAX_SVCHEM	LOGICAL	.FALSE.
LHORELAX_SVDST	LOGICAL	.FALSE.
LHORELAX_SVPP	LOGICAL	.FALSE.
LHORELAX_SVAER	LOGICAL	.FALSE.
LHORELAX_SVFIRE	LOGICAL	.FALSE.
LVE_RELAX	LOGICAL	.FALSE.
LVE_RELAX_GRD	LOGICAL	.FALSE.
NRIMX	INTEGER	1
NRIMY	INTEGER	1
XRIMKMAX	REAL	1 / (100*60.)
XT4DIFU	REAL	1800.0
XT4DIFTH	REAL	1800.0
XT4DIFSV	REAL	1800.0
LOCEAN	LOGICAL	.FALSE.

XTSTEP : Time step in seconds. If the model is not the DAD model, XTSTEP is not taken into account but NDTRATIO in NAM_NESTING.
CPRESOPT : Pressure solver option. 3 choices are implemented in Meso-NH for the moment (see the Scientific documentation for more details) :
- ‘RICHA’ Richardson method preconditionned by the flat cartesian operator
- ‘CGRAD’ Generalized pre-conditioned gradient for non-symmetric problems with the same preconditioner
- ‘CRESI’ Conjugate Residual method
- ‘ZRESI’ Parallelized version of Conjugate Residual method

Note

If the problem is flat and cartesian, then the resolution becomes exact and no iteration is performed.

NITR : Number of iterations for the pressure solver. The value of this parameter depends on the maximum slope of the orography in the model.

Note

NITR cannot be set in a restarted simulation (CCONF=’RESTA’) because the value of the previous timestep is used to ensure reproducibility between restarted and non-restarted runs.

LRES : flag to change the residual divergence limit
XRES : Value of the residual divergence limit
LITRADJ : Logical to adjust the number of iterations for the pressure solver according to the range of the residual divergence.
XRELAX : Relaxation coefficient in the Richardson method (CPRESOPT=’RICHA’). This value can be less than 1 only for very steep orography, in general, the optimal value is equal to 1.
LHORELAX_UVWTH : Flag for the horizontal relaxation applied on the outermost verticals of the model for U,V,W TH variables.
- .TRUE. The horizontal relaxation is applied
- .FALSE. The horizontal relaxation is not applied

Note

LHORELAX_RV, LHORELAX_RC, LHORELAX_RR, LHORELAX_RI, LHORELAX_RS, LHORELAX_RG, LHORELAX_RH, LHORELAX_TKE, LHORELAX_SV, LHORELAX_SVCHEM, LHORELAX_SVC2R2, LHORELAX_SVLIMA, LHOREAX_SVLG, LHORELAX_SVDST, LHORELAX_SVPP, LHORELAX_SVAER, LHORELAX_SVELEC, LHORELAX_SVSNW, LHORELAX_SVFIRE : same as LHORELAX_UVWTH
It is safer to set all the LHORELAX values rather than use their default values which can be modified by the descriptive (.des) file.

LVE_RELAX : Flag for the vertical relaxation applied to the outermost verticals of the model.
- .TRUE. The vertical relaxation is applied
- .FALSE. The vertical relaxation is not applied
LVE_RELAX_GRD : Flag for the vertical relaxation applied to the lowest verticals of the model.
- .TRUE. The vertical relaxation is applied
- .FALSE. The vertical relaxation is not applied
NRIMX : number of points in the lateral relaxation in the x axis.
NRIMY : number of points in the lateral relaxation in the Y axis.
XRIMKMAX : maximum value (in $s^{-1}$) of the relaxation coefficient for the lateral relaxation area. This value is applied to all the outermost verticals of the domain if LHO_RELAX.
XT4DIFU : characteristic time (e-folding time) of the fourth order numerical diffusion for momentum (in seconds). Associated to LNUMDIFU in NAM_DYN.
XT4DIFTH : characteristic time (e-folding time) of the numerical diffusion of fourth order for meteorological variables (in seconds). Associated to LNUMDIFTH in NAM_DYN.
XT4DIFSV : characteristic time (e-folding time) of the numerical diffusion of fourth order for scalar variables (in seconds). Associated to LNUMDIFSV in NAM_DYN.
LOCEAN : flag to activate the Ocean version of Meso-NH. Pronostic variables are: Current (U and V), Vertical velocity (W), Temperature (TH), Subgrid Turbulent Kinetic Energy (TKE). Salinity (RV) can be activated with LUSERV=T. The Z-axis is directed upward (as in the atmosphere version), i.e. top of model domain corresponds to the sea surface.

NAM_FIREn

The Blaze fire model is configured by editing this namelist. In grid-nesting, it is only allowed (LBLAZE=T) on the finest models (without child). It contains the variables and types for the Blaze fire model. More informations about the scheme and on input data construction with python Pyrolib package on https://pypi.org/project/pyrolib/ and https://pyrolib.readthedocs.io/en/latest/.

NAM_FIREn content
Fortran name	Fortran type	Default value
LBLAZE	LOGICAL	.FALSE.
NREFINX	INTEGER	1
NREFINY	INTEGER	1
CFIRE_CPL_MODE	CHARACTER(LEN=7)	‘2WAYCPL’
CBMAPFILE	CHARACTER(LEN=128)	CINIFILE
CPROPAG_MODEL	CHARACTER(LEN=11)	‘SANTONI2011’
CHEAT_FLUX_MODEL	CHARACTER(LEN=3)	‘EXS’
CLATENT_FLUX_MODEL	CHARACTER(LEN=3)	‘EXP’
XFERR	REAL	0.8
LSGBAWEIGHT	LOGICAL	.FALSE.
XFLUXZEXT	REAL	3.0
XFLUXZMAX	REAL	4.*XFLUXZEXT
XFLXCOEFTMP	REAL	1.0
NFIRE_WENO_ORDER	INTEGER	3
NFIRE_RK_ORDER	INTEGER	3
XCFLMAXFIRE	REAL	0.8
XLSDIFFUSION	REAL	0.1
XROSDIFFUSION	REAL	0.05
LINTERPWIND	LOGICAL	.TRUE.
LWINDFILTER	LOGICAL	.FALSE.
CWINDFILTER	CHARACTER(LEN=4)	‘EWAM’
XEWAMTAU	REAL	20.0
XWLIMUTH	REAL	8.0
XWLIMUTMAX	REAL	9.0
NNBSMOKETRACER	INTEGER	1
NWINDSLOPECPLMODE	INTEGER	0

LBLAZE : flag to activate the Blaze fire model.
NREFINX : Refinement ratio for fire mesh in the x direction.
NREFINY : Refinement ratio for fire mesh in the y direction.
CFIRE_CPL_MODE : atmosphere/fire coupling mode. Three options are available:
- 2WAYCPL: two-way coupled mode. Fire spread and heat fluxes computations are activated
- ATM2FIR: one way coupling where atmosphere forces the fire. Only fire spread computation is activated.
- FIR2ATM: fire replay mode where the fire spread is derived from an arrival time map and the heat fluxes computation is activated.
CBMAPFILE : File name of arrival time map (burning map) for FIR2ATM mode (current initialisation file as default file).
CPROPAG_MODEL : Rate of spread parameterization. Following options are available:
- SANTONI2011: Balbi’s model based on Santoni et al. [2011] formulation.
CHEAT_FLUX_MODEL : sensible heat flux parameterization. Following options are available:
- EXS: Exponential and smoldering flux model.
- EXP: Exponential flux model.
- CST: Constant flux model.
CLATENT_FLUX_MODEL : latent heat flux parameterization. Following options are available:
- EXP: Exponential flux model.
- CST: Constant flux model.
XFERR : fraction of energy reservoir released during the flaming time ($0 < \mathrm{XFERR} < 1$).
LSGBAWEIGHT : flag to use to use the weighted averaged method to compute the sub-grid burning area instead of the explicite fire front reconstruction (EFFR) method (Recommended to FALSE).
XFLUXZEXT : Characteristic height $z_f$ for vertical exponential distribution of fire heat fluxes.
XFLUXZMAX : maximum height $z_{\mathrm{max}}$ for vertical exponential distribution of fire heat fluxes.
XFLXCOEFTMP : heat fluxes multiplier.
NFIRE_WENO_ORDER : WENO scheme order for fire spread computation. Orders 1 and 3 available (order 3 recommended).
NFIRE_RK_ORDER : Runge-Kutta scheme order for fire spread computation. Orders 1, 2, 3, 4, 5, 6 available (order 3 recommended).
XCFLMAXFIRE : maximum CFL for fire spread computation. If computed CFL is above this value, fire time step is split to match the required maximum CFL.
XLSDIFFUSION : level-set function diffusion coefficient $\epsilon_\phi$.
XROSDIFFUSION : rate of spread diffusion coefficient $\epsilon_{\mathcal R}$.
LINTERPWIND : flag to use horizontal interpolation of surface wind (recommended to .TRUE.).
LWINDFILTER : flag to use temporal filter for surface wind. Recommended for highly fluctuating surface wind.
CWINDFILTER : Method for temporal filtering of surface wind. Follong options are available:
- EWAM: exponential weighted average method used of each wind component (Recommended)
- WLIM: limiter of surface wind on fire spread direction.
XEWAMTAU : averaging time constant for EWAM method. Equivalent to averaging time window for simple moving average method.
XWLIMUTH : wind threshold value for WLIM method.
XWLIMUTMAX : maximum surface wind value for WLIM method.
NNBSMOKETRACER : number of smoke passive scalar fluxes. Made for futur implementation of different smoke flux models. Only 1 smoke passive scalar is currently implemented.
NWINDSLOPECPLMODE : flag for wind/slope use for rate of spread computation. Suitable for testing/sensitivity analysis purposes. Following options are available:
- 0: Wind and slope values are used to compute the rate of spread.
- 1: Only wind is used to compute the rate of spread (slope value is ignored).
- 2: Only slope is used to compute the rate of spread (wind value is ignored).

NAM_FLYERS

This namelist is used to set the number of flyers (aircrafts and balloons) that will be simulated in the run. It is a preliminary phase to use the namelists NAM_AIRCRAFTS and NAM_BALLOONS.

NAM_FLYERS content
Fortran name	Fortran type	Default value
NAIRCRAFTS	INTEGER	0
NBALLOONS	INTEGER	0

NAIRCRAFTS : number of aircrafts to declare in NAM_AIRCRAFTS.
NBALLOONS : number of balloons to declare in NAM_BALLOONS.

NAM_LATZ_EDFLX

NAM_LATZ_EDFLX content
Fortran name	Fortran type	Default value
LUV_FLX	LOGICAL	.FALSE.
XUV_FLX1	REAL	3.E+14
XUV_FLX2	REAL	0
LTH_FLX	LOGICAL	.FALSE.
XTH_FLX	REAL	0.75

LUV_FLX : to activate eddy flux for the UV flux
XUV_FLX1 : Coefficient in the formulation of the UV flux (m3). It gives the magnitude of u’v’ the eddy flux. If 0, there is no UV flux The UV flux mimics the meridional transports of momentum associated with eddies not taken into account in a 2D meridional vertical model.
XUV_FLX2 : Coefficient in the formulation of the UV flux. Add a miminum constant value to the u’v’ flux.
LTH_FLX : to activate eddy flux for the theta flux
XTH_FLX : Coefficient in the formulation of the theta flux. It gives the magnitude of the v’T’ and W’T’ eddy flux. If 0, there is no theta flux The theta flux mimics the meridional transports of potential temperature associated with eddies not taken into account in a 2D model.

NAM_ELEC

It contains the different parameters used by the electrical scheme. They are included in the declarative module MODD_ELEC_DESCRn.

NAM_ELEC content
Fortran name	Fortran type	Default value
LOCG	LOGICAL	.FALSE.
LELEC_FIELD	LOGICAL	.TRUE.
LFLASH_GEOM	LOGICAL	.TRUE.
LFW_HELFA	LOGICAL	.FALSE.
LCOSMIC_APPROX	LOGICAL	.FALSE.
LION_ATTACH	LOGICAL	.TRUE.
CDRIFT	CHARACTER(LEN=3)	‘PPM’
LRELAX2FW_ION	LOGICAL	.FALSE.
LINDUCTIVE	LOGICAL	.FALSE.
LSAVE_COORD	LOGICAL	.FALSE.
LLNOX_EXPLICIT	LOGICAL	.FALSE.
LSERIES_ELEC	LOGICAL	.FALSE.
NTSAVE_SERIES	INTEGER	60
NFLASH_WRITE	INTEGER	100
CNI_CHARGING	CHARACTER(LEN=5)	‘TAKAH’
XQTC	REAL	263.0
XLIM_NI_IS	REAL	10.E-15
XLIM_NI_IG	REAL	30.E-15
XLIM_NI_SG	REAL	100.E-15
CLSOL	CHARACTER(LEN=5)	‘RICHA’
NLAPITR_ELEC	INTEGER	4
XRELAX_ELEC	REAL	1
XETRIG	REAL	200.E3
XEBALANCE	REAL	0.1
XEPROP	REAL	15.E3
XQEXCES	REAL	2.E-10
XQNEUT	REAL	1.E-10
XDFRAC_ECLAIR	REAL	2.3
XDFRAC_L	REAL	1500.0
XWANG_A	REAL	0.34E21
XWANG_B	REAL	1.3E16

LOCG :
- .TRUE. : only the cloud electrification is computed.
- .FALSE. : lightning flashes can be produced.
LELEC_FIELD :
- .TRUE. : the electric field is computed.
- .FALSE. : the electric field is not computed.
LFLASH_GEOM : when .TRUE., the lightning flash branches are produced randomly. (only one lightning scheme implemented, then must be set to .TRUE.)
LFW_HELFA : when .TRUE., Helsdon-Farley Fair Weather field
LCOSMIC_APPROX : when .TRUE., neglecting height variations of fair ion weather ion current in calculating ion source from cosmic rays
LION_ATTACH : when .TRUE., ion attachment to hydrometeors is considered
CDRIFT : ion drift
- ‘PPM’ : PPM advection scheme
- ‘DIV’ : divergence form
LRELAX2FW_ION : when .TRUE., relaxation to fair weather concentration in rim zone and top absorbing layer
LINDUCTIVE : when .TRUE., the inductive charging mechanism is taken into account.
LSAVE_COORD : when .TRUE., the flash coordinates are written in an ascii file.
LSERIES_ELEC : when .TRUE., some dynamical and microphysical parameters are computed and saved in an ascii file
NTSAVE_SERIES : time interval (s) at which data from series_cloud_elec are written in an ascii file
NFLASH_WRITE : number of flashes to be saved before writing the diag and/or coordinates in ascii files
LLNOX_EXPLICIT : when .TRUE., nitrogen oxides are produced along the lightning path (not yet implemented)
CNI_CHARGING : non-inductive charging parameterization
- ‘HELFA’ : based on Helsdon and Farley (1987)
- ‘TAKAH’ : based on Takahashi (1978)
- ‘SAUN1’ : based on Saunders et al. (1991), but does not take into account the marginal positive and negative regions at low liquid water content
- ‘SAUN2’ : based on Saunders et al. (1991)
- ‘SAP98’ : based on Saunders and Peck (1998)
- ‘GARDI’ : based on Gardiner et al. (1985)
XQTC : temperature charge reversal (K), only if CNI_CHARGING = ‘HELFA’
XLIM_NI_IS : max magnitude of dq for I-S non-inductive charging (C)
XLIM_NI_IG : max magnitude of dq for I-G non-inductive charging (C)
XLIM_NI_SG : max magnitude of dq for S-G non-inductive charging (C)
CLSOL : Laplace equation solver for the electric field
NLAPITR_ELEC : number of iterations for the electric field solver
XRELAX_ELEC : relaxation factor for the electric field solver
XETRIG : electric field threshold (V $m^{-1}$) for lightning flash triggering
XEBALANCE : (1-XEBALANCE) is the proportion of XETRIG over which a lightning can be triggerred to take into account the subgrid scale variability
XEPROP : electric field threshold (V $m^{-1}$) for the bidirectional leader propagation
XQEXCES : charge density threshold (C $m^{-3}$) for neutralization
XDFRAC_ECLAIR : fractal dimension of lightning flashes
XDFRAC_L : linear coefficient for the branch number
XWANG_A : a parameter of the Wang et al. (1998) formula for LNOx production (not yet implemented)
XWANG_B : b parameter of the Wang et al. (1998) formula for LNOx production (not yet implemented)

NAM_EOL

For now, simulations of wind turbine have been tested and validated only in ideal cases.

NAM_EOL content
Fortran name	Fortran type	Default value
LMAIN_EOL	LOGICAL	.FALSE.
NMODEL_EOL	INTEGER	1
CMETH_EOL	CHARACTER(LEN=4)	‘ADNR’
CSMEAR	CHARACTER(LEN=4)	‘3LIN’
XKERNEL_RATIO	REAL
LCONTROL_EOL	LOGICAL	.FALSE.
LNACELLE	LOGICAL	.FALSE.
LTOWER	LOGICAL	.FALSE.
LDIA_EOL	LOGICAL	.TRUE.
LFLOAT_EOL	LOGICAL	.FALSE.

LMAIN_EOL : flag to model wind turbines
- .TRUE. to simulate wind turbines.
- .FALSE. to forget about them.
NMODEL_EOL : model number where the wind turbines are included (if nested models). If NMODEL_EOL $\neq 1$ (n $\neq 1$), the namelists NAM_EOL_ALM, NAM_EOL_ADR and NAM_EOL_ADNR have also to be set in EXSEGn.nam
CMETH_EOL : aerodynamic method for wind turbine simulations
- ‘ADNR’ to use the Non-Rotating Actuator Disc method.
- ‘ADR’ to use the Rotating Actuator Disc method.
- ‘ALM’ to use the Actuator Line Method.
CSMEAR : smearing method of the aerodynamic forces field
- ‘NULL’ : no smearing.
- ‘1LIN’ : 1D linear smearing method.
- ‘3LIN’ : 3D linear smearing method.
- ‘3DGA’ : 3D gaussian kernel. Note that this can increase the computational cost of the simulation. This mode is only available for ALM and ADR (not ADNR).
XKERNEL_RATIO : ratio of the kernel size in the 3D Gaussian smearing to the mesh size.
LCONTROL_EOL : flag to use a controller to modify rotational speed and blade pitch angle during the run. Only for CMETH_EOL=’ADR’ or ‘ALM’.
- .TRUE. activates the controller. More parameterizations are available in the EOL_CONTROL namelist.
- .FALSE. the rotational speed and blade pitch angle are constant during the simulation (values imposed in CFARM_CSVDATA).
LNACELLE : flag to model wind turbines nacelle. Only for CMETH_EOL=’ADR’ or ‘ALM’.
- .TRUE. to simulate wind turbine nacelle.
- .FALSE. to remove the nacelle body forces.
LTOWER : flag to model wind turbines tower. Only for CMETH_EOL=’ADR’ or ‘ALM’.
- .TRUE. to simulate wind turbine tower.
- .FALSE. to remove the tower body forces.
LDIA_EOL : flag to write SCADA-like variables in the diachronic file. Only for CMETH_EOL=’ADR’ or ‘ALM’. See Sect. ref{ss:variables_SCADA} for a list of available variables.
- .TRUE. write variables. They are written into subgroup ‘Turbines’, itself containing one subgroup for each turbine.
- .FALSE. do not write variables.
LFLOAT_EOL : flag to activate the floating motions and static positions. Only for CMETH_EOL=’ADR’ or ‘ALM’.
- .FALSE. do not use floating DOF.
- .TRUE. use floating DOFs. Each turbine written in CFARM_CSVDATA must have a last column which contains the name of the CSV field containing the prescribed motions. A mean value for static position as well as an amplitude, frequency and phase for dynamic motion can be given as follows:

LFLOAT content
Motion	Mean [m or rad]	Amplitude [m or rad]	Frequency [Hz]
Surge	0.00000	0.0000	0.000
Sway	0.00000	0.0000	0.000
Heave	10.0000	0.0000	0.000
Roll	0.00000	0.0000	0.000
Pitch	0.08727	0.0349	0.200
Yaw	0.00000	0.0000	0.000

Note that filling the table with 0.000 will lead to the same behavior as if LFLOAT_EOL = .FALSE. This can be useful if some turbines are floating and some are not.

NAM_EOL_ADNR

If the user wants to simulate two wind farms built with two different types of wind turbines, the user can set two Meso-NH son models using two CSV data files.

NAM_EOL_ADNR content
Fortran name	Fortran type	Default value
CFARM_CSVDATA	CHARACTER(LEN=128)	‘data_farm.csv’
CTURBINE_CSVDATA	CHARACTER(LEN=128)	‘data_turbine.csv’
CINTERP	CHARACTER(LEN=3)	‘CLS’

CFARM_CSVDATA : name of the CSV data file containing the description of the wind farm. The file must contain a header and one row of data per wind turbine. The name of the variables in the header can be modified by the user since it is not read by the program. The delimiters of the file are commas. The data and the column order of this file are:
- x-axis position [m] of the base of the tower (ideal conditions only),
- y-axis position [m] of the base of the tower (ideal conditions only),
- thrust coefficient [-] of the rotor, defined with the infinite upstream velocity (see scientific documentation for details).

Note

Note that the ANDR operates only when the disk is normal to the x-direction, facing the upstream wind. An example for two wind turbines is given below: .. code-block:

X [m], Y [m], Ct_inf [-]
1000, 600, 0.8
2500, 600, 0.6

CTURBINE_CSVDATA : name of the CSV data file containing the description of the wind turbine. The file must contain a header and one row of data, as only one type of wind turbine can be simulated in a Meso-NH model (or sub-model). The name of the variables in the header can be modified by the user since it is not read by the program. The delimiters of the file are commas. The data and the column order of this file are:
- name of the wind turbine [-] (not used by the code, useful for the user),
- hub height [m],
- radius of the rotor [m].

Note

One can note that the hub radius, the deport and the tilt are not taken into account with this model. An example for a DTU_10MW rotor is given below:

Turbine name, Hub height [m], Rotor radius [m]
DTU_10MW, 119,  89.15

CINTERP : method of interpolation of wind conditions at disc position:
- `CLS’ closest cell value (no interpolation).
- `8NB’ eigth neighbourhood interpolation.

NAM_EOL_ADR

NAM_EOL_ADR content
Fortran name	Fortran type	Default value
CFARM_CSVDATA	CHARACTER(LEN=128)	‘data_farm.csv’
CTURBINE_CSVDATA	CHARACTER(LEN=128)	‘data_turbine.csv’
CBLADE_CSVDATA	CHARACTER(LEN=128)	‘data_blade.csv’
CAIRFOIL_CSVDATA	CHARACTER(LEN=128)	‘data_airfoil.csv’
CINTERP	CHARACTER(LEN=3)	‘CLS’
NNB_AZIELT	INTEGER	56
NNB_RADELT	INTEGER	18
LTIPLOSSG	LOGICAL	.TRUE.
LTECOUTPTS	LOGICAL	.FALSE.
LCSVOUTFRM	LOGICAL	.FALSE.

CFARM_CSVDATA : name of the CSV data file containing the description of the wind farm. The file must contain a header and one row of data per wind turbine. The name of the variables in the header can be modified by the user since it is not read by the program. The delimiters of the file are commas. The data and the column order of this file are:
- x-axis position [m] of the tower base (if LCARTESIAN = .TRUE.), or latitude [deg] (if LCARTESIAN = .FALSE.),
- y-axis position [m] of the tower base (if LCARTESIAN = .TRUE.), or longitude [deg] (if LCARTESIAN = .FALSE.),
- angular velocity [rad/s] of the rotor (trigonometric convention seen from upstream),
- yaw angle [rad] of the nacelle ($0 \Leftrightarrow$ facing an upstream x-axis wind; trigonometric convention seen from the sky),
- pitch angle [rad] of the blades ($0 \Leftrightarrow$ rotor plane ; $-pi/2 \Leftrightarrow$ feathering. Trigonometric convention seen from blade tip).

Note

An example of data_farm.csv with one wind turbine is given below:

X[m]/Lat[deg], Y[m]/Lon[deg], Omega[rad/s], Nac_yaw[rad], Bla_pitch[rad]
1000, 600, -1.00531, 0.0, -0.07866

If LFLOAT_EOL is activated (only if LCARTESIAN=T.):

X [m], Y [m], Omega [rad/s], N_yaw [rad], B_pitch [rad], Floating Motions file
1000, 600, -1.00531, 0.0, -0.07866, data_float.csv

CTURBINE_CSVDATA : name of the CSV data file containing the description of the wind turbine. The file must contain a header and one row of data, as only one type of wind turbine can be simulated in a Meso-NH modelfootnote{If the user wants to simulate two wind farms built with two different types of wind turbines, the user can set two Meso-NH son models using two CSV data files.} (or sub-model). The name of the variables in the header can be modified by the user since it is not read by the program. The delimiters of the file are commas. The data and the column order of this file are:
- name of the wind turbine [-] (not used by the code, useful for the user),
- number of blades [-],
- hub height [m],
- radius of blade root (or hub radius) [m],
- radius of blade tip (or rotor radius) [m],
- tilt angle [rad] of the nacelle ($0 \Leftrightarrow$ facing an upstream x-axis wind; $pi/2 \Leftrightarrow$ facing the sky),
- hub deport [m],
- tower radius (for computation of tower body forces) [m],
- nacelle radius (for computation of nacelle body forces) [m].

Note

An example of data_turbine.csv for a DTU_10MW rotor is given below:

Turbine, Nb b.[-], H_h [m], R_r [m], R_t [m], N_tilt [rad], H_dep. [m], T_r [m], N_r [m]
DTU10, 3, 119, 2.8, 89.15, 0.0, 7.1, 2.8, 2.8

CBLADE_CSVDATA : name of the CSV data file containing the description of the blade. The file must contain a header and one row of data per blade element centre. The name of the variables in the header can be modified by the user since it is not read by the program. The delimiters of the file are commas. The data and the column order of this file are:
- center position [%] along blade length (from root radius to tip) of the element,
- chord [m] of the element,
- twist angle [rad] of the element ($0 \Leftrightarrow$ rotor plane ; $-pi/2 \Leftrightarrow$ feathering. Trigonometric convention seen from blade tip),
- name of the airfoil [-].

Note

An example of data_blade.csv for a blade description rotor is given below:

Center [%], Chord [m], Twist [rad], Airfoil [-]
03111, 5.37574, -0.25188, Cylinder
07854, 5.40375, -0.25311, Cylinder
11164, 5.53313, -0.24859, FFA-W3-600
...
98605, 1.33250, 0.057858, FFA-W3-241
99527, 0.94924, 0.059291, FFA-W3-241

CAIRFOIL_CSVDATA : name of the CSV data file containing the descprition of the airfoils. The file must contain a header and tabulated polars for all the airfoils of the blade. For each airfoil, one row of data per angle of attack must be specified. The name of the variables in the header can be modified by the user since it is not read by the program. The delimiters of the file are commas. The data and the column order of this file are:
- name of the airfoil [-],
- angle of attack [deg],
- Reynolds number [-] (not used by the code, useful for the user),
- lift coefficient [-],
- drag coefficient [-]
- moment coefficient [-] (not used by the code yet).

Note

An example of data_airfoil.csv for an airfoil data file is given below:

Airfoil name, AoA [deg], Re [-], C_l [-], C_d [-], C_m [-]
Cylinder,     -180,      0.0,    0.0,      0.6,      0.0
Cylinder,      0.0,      0.0,    0.0,      0.6,      0.0
Cylinder,      180,      0.0,    0.0,      0.6,      0.0
FFA-W3-241,   -180,      0.0,    0.0,      0.0,      0.0
FFA-W3-241,   -175,      0.0,    0.1736,   0.01142,  0.0218
FFA-W3-241,   -170,      0.0,    0.3420,   0.04523,  0.0434
...
FFA-W3-600,   170,       0.0,   -0.342,    0.0392,  -0.0434
FFA-W3-600,   175,       0.0,   -0.1736,   0.0099,  -0.0218
FFA-W3-600,   180,       0.0,    0.0,      0.0,      0.0

CINTERP : method of interpolation of wind conditions at blade element position:
- `CLS’ closest cell value (no interpolation).
- `8NB’ eight neighbourhood interpolation.
NNB_AZIELT : number of elements for the azimutal discretisation of the disc. To determine the value to be specified, refer to the scientific documentation.
NNB_RADELT : number of elements for the radial discretisation of the disc. This value is independent of the number of elements in CBLADE_CSVDATA, as the algorithm will proceed to its own discretization through an interpolation of the data given by the blade description (CBLADE_CSVDATA). To determine the value to be specified, refer to the scientific documentation.
LTIPLOSSG : flag to activate the tip loss correction of Glauert. Usually applied to alleviate the over-predicted loads at the blade tip region when the low resolution or the smearing method cannot capture tip vortices. One can note that this correction should only be used with models such as the Actuator Disc with Rotation to correct for finite number of blades.
- .TRUE. activates the tip loss correction of Glauert.
- .FALSE. no activation.
LTECOUTPTS : flag to enable the output of geometrical points (XYZ) for wind turbines in a Tecplot file. This provides spatial positions at each element point of the wind turbine, facilitating setup checks such as geometry and wind farm layout.
- .TRUE. activates Tecplot output.
- .FALSE. deactivates it.
LCSVOUTFRM : flag to enable the output of frames $\left(\overrightarrow{e_x},\overrightarrow{e_y},\overrightarrow{e_z}\right)$ for wind turbines in a CSV file. This describes the spatial positions and orientations of frames for each kinematic part of the wind turbine. Useful for verifying setup details, including positions and orientations of its components.
- .TRUE. activates the CSV output.
- .FALSE. deactivates it.

NAM_EOL_ALM

NAM_EOL_ALM content
Fortran name	Fortran type	Default value
CFARM_CSVDATA	CHARACTER(LEN=128)	‘data_farm.csv’
CTURBINE_CSVDATA	CHARACTER(LEN=128)	‘data_turbine.csv’
CBLADE_CSVDATA	CHARACTER(LEN=128)	‘data_blade.csv’
CAIRFOIL_CSVDATA	CHARACTER(LEN=128)	‘data_airfoil.csv’
CINTERP	CHARACTER(LEN=3)	‘CLS’
NNB_RADELT	INTEGER	42
LTIMESPLIT	LOGICAL	.FALSE.
LTIPLOSSG	LOGICAL	.TRUE.
LTECOUTPTS	LOGICAL	.FALSE.
LCSVOUTFRM	LOGICAL	.FALSE.

CFARM_CSVDATA : see NAM_EOL_ADR
CTURBINE_CSVDATA : see NAM_EOL_ADR
CBLADE_CSVDATA : see NAM_EOL_ADR
CAIRFOIL_CSVDATA : see NAM_EOL_ADR
CINTERP : see NAM_EOL_ADR
NNB_RADELT : number of blade elements for the discretisation of the blade radius. This value is independent of the number of elements in CBLADE_CSVDATA, as the algorithm will proceed to its own discretization through an interpolation of the data given by the blade description (CBLADE_CSVDATA). To determine the value to be specified, refer to the scientific documentation.
LTIMESPLIT : flag to activate time-splitting method (also known as Actuator Sector). The CFL criterion of Meso-NH imposes a time step. Nevertheless, the ALM often requires a smaller time step in order to ensure that a blade element will not skip a mesh cell during this time step. As it could be too restrictive, the ALM algorithm can be called a few times during the main CFL-based time step duration, in order to respect the ALM time step criterion. It allows computational cost saving, but results can be less accurate. Note that in this case, the ADR model can also be considered.
- .TRUE. activates time-splitting method only if XTSTEP (NAM_DYNn) is too high.
- .FALSE. desactivates it.
LTIPLOSSG : see NAM_EOL_ADR
LTECOUTPTS : see NAM_EOL_ADR
LCSVOUTFRM : see NAM_EOL_ADR

NAM_EOL_CONTROL

Parametrization of the turbine’s controller. Default data are given for a typical IEA15MW wind turbine controlled with a velocity table. To use with LCONTROL_EOL=.TRUE. in NAM_EOL.

NAM_EOL_CONTROL content
Fortran name	Fortran type	Default value
CMETH_OPS	CHARACTER(LEN=9)	TABLE
CCONTROL_CSVDATA	CHARACTER(LEN=NFILENAMELGTMAX)	data_TABLE.csv
XCON_AVG_PERIOD	REAL
XCON_DIST_VEL	REAL
XCON_RAD_VEL	REAL

CMETH_OPS: method for operational state control
- ‘TABLE’: the rotational velocity and blade pitch angle are linearly interpolated from a table given in CCONTROL_CSVDATA. The inflow velocity used to interpolate is defined as the mean wind on a virtual disk defined by XCON_DIST_VEL and XCON_RAD_VEL and over a time period XCON_AVG_PERIOD.
- ‘JONKM’: use the ‘baseline’ controller such as proposed in the Ph.D. thesis of JM Jonkman. The pitch control is a PID and the rotational speed is controlled through a mechanical equilibrium based on the 5-region model. This method requires a lot of mechanical data from the turbine, that are given to Meso-NH through the table CCONTROL_CSVDATA.
- ‘ROSCO’: Reference Open-Source Controller is a wind turbine controller developed by NREL (National Renewable Energy Laboratory). It allows a minimal rotor speed control, which is applicable to large wind turbines such as the IEA 15 MW reference turbine. In this implementation, only Mode 1 of the generator torque control mode type has been considered. Controller information can be found in the ROSCO Controller setup file named DISCON.IN, which is specific for each turbine. These files are available open-source from the ROSCO repository for canonical (reference) turbines. The file CCONTROL_CSVDATA contains theses datas.
- ‘NONE’: No operational control method applied. Constant values from CFARM_CSVDATA will be used. Intended for testing purposes only.
CCONTROL_CSVDATA: Data necessary for the turbine controller. Its definition varies as a function of the chosen control method:
- ‘TABLE’: Meso-NH will expect four columns: Turbine Name, Velocity (in m/s), Rotational velocity (in rad/s) and Blade pitch angle (in rad).
Take care of the sign of the variables (use the same convention as in the CSV file data_farm.csv, described in namelist CFARM_CSVDATA in NAM_EOL_ALM. There can be as much lines as known operating points by the user, but it should be sorted in increasing velocity as the following example:

Turbine name, Velocity [m/s], Rotational vel [rad/s], Pitch [rad]
NREL5MW,         3.0,              -0.734,             -0.00000
NREL5MW,         4.0,              -0.755,             -0.00000
...,             ...,                 ...,             ...
NREL5MW,        19.8,              -1.266,             -0.299684

CCONTROL_CSVDATA
- ‘JONKM’: the user must put the 17 parameters needed for this model in columns, and one line for each type of turbine. The columns are (again, take care of the units!):

Parameter	Units
Turbine name
Filter frequency	rad.s-1
Drivetrain Inertia	kg.m²
Gearbox Ratio
Gearbox efficiency
Cut-in gen speed	rad.s-1
Region 2 start gen speed	rad.s-1
Region 2 start end speed	rad.s-1
Rated rotor speed	rad.s-1
Cut-in gen torque	N.m
Rated gen torque	N.m
Min blade pitch angle	rad
Max blade pitch angle	rad
Torque controller gain	$N.m/(rad.s^{-1})^2$
Pitch controller global gain
Pitch proportional gain	s
Pitch integral gain

CCONTROL_CSVDATA
- ‘ROSCO’: if a ROSCO-type controller is chosen, the user must put the 25 parameters needed for this model in columns, and one line for each type of turbine. The columns are described in the following table with the correspondence with DISCON.IN file generated with the ROSCO repository https://github.com/NREL/ROSCO.

Parameter	Units
Turbine name
Pitch to switch to rng 3	rad
Rated Generator speed	rad/s	$VS_{RefSpd}$
Min. Generator speed Rng 2	rad/s	$VS_{MinOMSpd}$
Generator torque constant in rng 2	$N.m/(rad.s^{-1})^2$	$VS_{Rgn2K}$ convert from $Nm/rpm^2$
Prop. Gain gen PI torque controller		$VS_{KP}$
Int. Gain gen PI torque controller	s	$VS_{KI}$
Above Rated generator torque PI sat.	Nm	$VS_{ArSatTq}$
Min generator torque	Nm	$VS_{MinTq}$
Wind Turbine rated power	W	$VS_{RtPwr}$
Generator efficiency	%	$VS_{GenEff}$
Max. torque generator	Nm	$VS_{MaxTq}$
Gearbox ratio		$WE_{GearboxRatio}$
Rotor inertia	kg m²
Corner freq. LPF	rad/s	$F_{LPFCornerFreq}$
Damping coef.		$F_{LPFDamping}$
Prop. Gain pitch poly coeff. a	$s.rad^{-2}$	fit $PC_{GS_{KP}}$
Prop. Gain pitch poly coeff. B	s/rad	fit $PC_{GS_{KP}}$
Prop. Gain pitch poly coeff. C	s	fit $PC_{GS_{KP}}$
Int. Gain pitch poly coeff. a	$rad.s^{-2}$	fit $PC_{GS_{KI}}$
Int. Gain pitch poly coeff. B	$rad.s^{-1}$	fit $PC_{GS_{KI}}$
Int. Gain pitch poly coeff. C		fit $PC_{GS_{KI}}$
Pitch control generator Rated speed	$rad.s^{-1}$	$PC_{RefSpd}$
Max. Physical pitch	rad	$PC_{MaxPit}$
File name table Min. Pitch Vs Rotor Torque	.csv

XCON_AVG_PERIOD: used if CMETH_OPS = ‘TABLE’. Time period (in seconds) used for the averaging of the upstream wind.
XCON_DIST_VEL: used if CMETH_OPS = ‘TABLE’. Distance (in meters) in the hub frame between the hub and the center of the virtual disk used to sample the velocity (positive is upstream, negative is downstream).
XCON_RAD_VEL: used if CMETH_OPS = ‘TABLE’. Radius (in meters) of the virtual disk used to sample velocity.

NAM_EOL_TOWNAC

Parametrization of the turbine’s tower and nacelle. In the current implementation, the tower is represented by a cylinder with NNB_TOWELT sections and the nacelle by a disk of radius R_r (defined in the data_turbine.csv file). Drag forces are deduced from these geometrical shapes. The user can modify the modified drag coefficient. These drag forces are smeared the same way as the body forces of the blades.

NAM_EOL_TOWAC content
Fortran name	Fortran type	Default value
NNB_TOWELT	INTEGER	84
XCD_NAC	REAL	0.68
XCD_TOW	REAL	4.0

NEMITTING_ROT: number of rotor that emit tracers. We recommend to limit this number to the number of wind turbines for which the wake meandering will be studied. Having too many additional variables will reduce the code’s performance.
NNB_TOWELT: number of elements to add a drag to the tower. We recommend having at least one element per cell size.
XCD_NAC: modified drag coefficient of the nacelle.
XCD_TOW: modified drag coefficient of the tower.

NAM_EOL_TRACERS

NAM_EOL_TRACERS content
Fortran name	Fortran type	Default value
NEMITTING_ROT	INTEGER	1
NNB_EMITTING_ROT	INTEGER(:)	(1,0,0,..)
XTRAC_DIST	REAL	120
XTRAC_RAD	REAL	-60

NEMITTING_ROT: number of rotor that emit tracers. We recommend to limit this number to the number of wind turbines for which the wake meandering will be studied. Having too many additional variables will reduce the code’s performance.
NNB_EMITTING_ROT: list of size NEMITTING_ROT which indicates the indices of tracked turbines.
XTRAC_DIST: Distance (in meters) in the hub frame between the rotor hub and the centre of the emitting disk (positive is upstream, negative is downstream).
XTRAC_RAD: Radius (in meters) of the emitting disk.

NAM_FRC

Application of a specific forcing is enabled by a dedicated flag. When a Newtonian relaxation is requested, the damping time XRELAX_TIME_FRC and the height (fixed or physically based) above which the forcing is applied, XRELAX_HEIGHT_FRC and CRELAX_HEIGHT_TYPE, must be set.

NAM_FRC content
Fortran name	Fortran type	Default value
LGEOST_UV_FRC	LOGICAL	.FALSE.
LGEOST_TH_FRC	LOGICAL	.FALSE.
LTEND_THRV_FRC	LOGICAL	.FALSE.
LTEND_UV_FRC	LOGICAL	.FALSE.
LVERT_MOTION_FRC	LOGICAL	.FALSE.
LRELAX_THRV_FRC	LOGICAL	.FALSE.
LRELAX_UV_FRC	LOGICAL	.FALSE.
LRELAX_UVMEAN_FRC	LOGICAL	.FALSE.
XRELAX_TIME_FRC	REAL	10800.0
XRELAX_HEIGHT_FRC	REAL	0.0
CRELAX_HEIGHT_TYPE	CHARACTER(LEN=4)	‘FIXE’
LTRANS	LOGICAL	.FALSE.
XUTRANS	REAL	0.0
XVTRANS	REAL	0.0
LDEEPOC	LOGICAL	.FALSE.
XCENTX_OC	REAL	16000.0
XCENTY_OC	REAL	16000.0
XRADX_OC	REAL	8000.0
XRADY_OC	REAL	8000.0

LGEOST_UV_FRC : flag to use a prescribed geostrophic wind.
- .TRUE. to integrate a geostrophic wind with a constant Coriolis parameter $f=2 \times \Omega \times SIN(XLAT0)$. The LCORIO flag of NAM_DYN must be .TRUE.
- .FALSE. not active
LGEOST_TH_FRC : flag to apply a large scale horizontal advection on the potential temperature field. The gradients result from the thermal wind balance.
- .TRUE. to integrate an horizontal advection of $\theta$.
- .FALSE. not active
LTEND_THRV_FRC : flag to simulate a large scale $\theta$ and humidity tendency.
- .TRUE. to integrate a tendency for $\theta$ and $r_v$.
- .FALSE. not active
LTEND_UV_FRC : flag to simulate a large scale wind tendency.
- .TRUE. to integrate a tendency for u and v.
- .FALSE. not active
LVERT_MOTION_FRC : flag to simulate a large scale vertical transport of all the prognostic fields.
- .TRUE. to integrate a vertical transport with an upstream scheme.
- .FALSE. not active
LRELAX_THRV_FRC : flag to apply a Newtonian relaxation on the potential temperature and humidity fields.
- .TRUE. to relax $\theta$ and $r_v$ towards large scale values.
- .FALSE. not active
LRELAX_UV_FRC : flag to apply a Newtonian relaxation on each horizontal wind component.
- .TRUE. to relax the horizontal wind towards large scale values.
- .FALSE. not active
LRELAX_UVMEAN_FRC : flag to apply a Newtonian relaxation on the horizontal mean value of each horizontal wind component.
- .TRUE. to relax the horizontal mean wind towards large scale values.
- .FALSE. not active
XRELAX_TIME_FRC : constant damping time for the forced relaxation.
XRELAX_HEIGHT_FRC : height above which a forced relaxation is enabled when CRELAX_HEIGHT_TYPE=’FIXE’ or minimal height if ‘THGR’ is used.
CRELAX_HEIGHT_TYPE : definition of the height above which a forced relaxation is enabled.
- ‘FIXE’ means that a forced relaxation is never applied below XRELAX_HEIGHT_FRC.
- ‘THGR’ means that a forced relaxation is never applied below the maximal height between XRELAX_HEIGHT_FRC and the height above which $\partial \theta / \partial z$ is the highest for each column.
LTRANS : flag to apply a Galilean translation of the domain of simulation
- .TRUE. The translation speed of the domain of simulation will be XUTRANS,XVTRANS
- .FALSE. : not active
LDEEPOC : flag to activate an idealized forcing at the surface for oceanic deep convection (if LOCEAN=T)
XCENTX_OC : x-position (in meters) of the center of the surface forcing for ideal ocean deep convection (if LOCEAN=T and LDEEPOC=T)
XCENTY_OC : y-position (in meters) of the center of the surface forcing for ideal ocean deep convection (if LOCEAN=T and LDEEPOC=T)
XRADX_OC : x-radius (in meters) of the surface forcing for ideal ocean deep convection (if LOCEAN=T and LDEEPOC=T)
XRADY_OC : y-radius (in meters) of the surface forcing for ideal ocean deep convection (if LOCEAN=T and LDEEPOC=T)

NAM_IBM_PARAMn

NAM_IBM_PARAMn content
Fortran name	Fortran type	Default value
LIBM	LOGICAL	.FALSE.
LIBM_TROUBLE	LOGICAL	.FALSE.
CIBM_ADV	CHARACTER(LEN=6)	‘NOTHIN’
XIBM_EPSI	REAL	1.E-9
XIBM_RUG	REAL	0.01
XIBM_CNU	REAL	0.06
NIBM_LAYER_V	INTEGER	2
NIBM_LAYER_T	INTEGER	2
NIBM_LAYER_R	INTEGER	2
NIBM_LAYER_E	INTEGER	2
NIBM_LAYER_S	INTEGER	2
CIBM_MODE_INTE3_V	CHARACTER(LEN=3)	‘LAI’
CIBM_MODE_INTE3_T	CHARACTER(LEN=3)	‘LAI’
CIBM_MODE_INTE3_R	CHARACTER(LEN=3)	‘LAI’
CIBM_MODE_INTE3_E	CHARACTER(LEN=3)	‘LAI’
CIBM_MODE_INTE3_S	CHARACTER(LEN=3)	‘LAI’
CIBM_MODE_INTE1NV	CHARACTER(LEN=3)	‘CL2’
CIBM_MODE_INTE1TV	CHARACTER(LEN=3)	‘CL2’
CIBM_MODE_INTE1CV	CHARACTER(LEN=3)	‘CL2’
CIBM_MODE_INTE1_T	CHARACTER(LEN=3)	‘CL2’
CIBM_MODE_INTE1_R	CHARACTER(LEN=3)	‘CL2’
CIBM_MODE_INTE1_E	CHARACTER(LEN=3)	‘CL2’
CIBM_MODE_INTE1_S	CHARACTER(LEN=3)	‘CL2’
XIBM_RADIUS_V	REAL	2.0
XIBM_RADIUS_T	REAL	2.0
XIBM_RADIUS_R	REAL	2.0
XIBM_RADIUS_E	REAL	2.0
XIBM_RADIUS_S	REAL	2.0
XIBM_POWERS_V	REAL	1.0
XIBM_POWERS_T	REAL	1.0
XIBM_POWERS_R	REAL	1.0
XIBM_POWERS_E	REAL	1.0
XIBM_POWERS_S	REAL	1.0
CIBM_MODE_BOUNN_V	CHARACTER(LEN=3)	‘ASY’
CIBM_MODE_BOUNT_V	CHARACTER(LEN=3)	‘ASY’
CIBM_MODE_BOUNC_V	CHARACTER(LEN=3)	‘ASY’
CIBM_MODE_BOUND_T	CHARACTER(LEN=3)	‘SYM’
CIBM_MODE_BOUND_R	CHARACTER(LEN=3)	‘SYM’
CIBM_MODE_BOUND_E	CHARACTER(LEN=3)	‘SYM’
CIBM_MODE_BOUND_S	CHARACTER(LEN=3)	‘SYM’
XIBM_FORC_BOUNN_V	REAL	0.0
XIBM_FORC_BOUNT_V	REAL	0.0
XIBM_FORC_BOUNC_V	REAL	0.0
XIBM_FORC_BOUND_T	REAL	0.0
XIBM_FORC_BOUND_R	REAL	0.0
XIBM_FORC_BOUND_E	REAL	0.0
XIBM_FORC_BOUND_S	REAL	0.0
CIBM_TYPE_BOUNT_V	CHARACTER(LEN=3)	‘DIR’
CIBM_TYPE_BOUNN_V	CHARACTER(LEN=3)	‘DIR’
CIBM_TYPE_BOUNC_V	CHARACTER(LEN=3)	‘DIR’
CIBM_TYPE_BOUND_T	CHARACTER(LEN=3)	‘NEU’
CIBM_TYPE_BOUND_R	CHARACTER(LEN=3)	‘NEU’
CIBM_TYPE_BOUND_E	CHARACTER(LEN=3)	‘NEU’
CIBM_TYPE_BOUND_S	CHARACTER(LEN=3)	‘NEU’
CIBM_FORC_BOUNN_V	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUNT_V	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUNC_V	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUNR_V	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUND_T	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUND_R	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUND_E	CHARACTER(LEN=3)	‘CST’
CIBM_FORC_BOUND_S	CHARACTER(LEN=3)	‘CST’

LIBM : Flag to activate Immersed Boundary Method (IBM) or not.
- .TRUE.: Immersed Boundary Method is activated.
- .FALSE.: Immersed Boundary Method is not activated.

Warning

In their current version, IBM can only be used in combination with flat terrain (LFLAT=.TRUE.), cartesian coordinates (LCARTESIAN=.TRUE.), and near-neutral atmospheric conditions. It is furthermore recommended to use IBM in combination with the WENO5 or WENO3 momentum advection scheme.

LIBM_TROUBLE : Flag to deal with too small obstacles or too small space in between obstacles (underresolved obstacles). Recommended is to filter the obstacles during the preprocessing and not to use LIBM_TROUBLE=.TRUE..
- .TRUE.: Flag to deal with too small obstacles is activated.
- .FALSE.: Flag to deal with too small obstacles is not activated.
CIBM_ADV : How to deal with the Immersed Boundary Conditions in the Runge Kutta time stepping. Recommended is ‘LOWORD’.
- ‘NOTHIN’: Nothing special is done - One ghost cell technique forcing is used per time step and the same advection scheme (WENO or CENTERED) is used close to the obstacles than in the rest of the model domain.
- ‘LOWORD’: Low order - One ghost cell technique forcing is used per time step and a lower order advection scheme (WENO3 instead of WENO5 or CEN2 instead of CEN4) is used close to the obstacles.
- ‘FORCIN’: Forcing - The ghost cell technique is used at all intermediate time steps of the Runge Kutta scheme.
- ‘FREEZE’: Freeze - A quasi-static approach for the Immersed Boundary Conditions is used at the intermediate time steps of the Runge Kutta scheme.
XIBM_EPSI : Very small REAL number value to be used in computations related to the Immersed Boundary Method.
XIBM_RUG : Aerodynamical roughness length [m] of obstacles. A constant value is used for all obstacles.
XIBM_CNU : Parameter in the IBM wall model.
NIBM_LAYER_V,T,R,E,S : Number of ghost point layers for wind velocity components, potential temperature,mixing ratio of water vapour, subgrid turbulekinetic energy, mixing ratio of scalar variables.
CIBM_MODE_INTE3_V,T,R,E,S : Method for 3D interpolation to calculate the values of wind velocity, potential temperature,mixing ratio of water vapour,subgrid turbulent kinetic energy, mixing ratio of scalar variables at mirror, image1, and image2 points.
- ‘LAI’: Inverse distance weighting.
- ‘LAM’: Modified distance weighting.
CIBM_MODE_INTE1_NV,TV,CV : Method for 1D interpolation to calculate the value of velocity normal,tangential,tangential to the obstacles at ghost points.
- ‘CL1’: Lagrange Polynomials - 1 point.
- ‘CL2’: Lagrange Polynomials - 2 points.
- ‘CL3’: Lagrange Polynomials - 3 points.
CIBM_MODE_INTE1_T,R,E,S : Method for 1D interpolation to calculate the value of potential temperature,mixing ratio of water vapour,subgrid turbulent kinetic energy,mixing ratio of scalar variables at ghost points.
- ‘CL1’: Lagrange Polynomials - 1 point.
- ‘CL2’: Lagrange Polynomials - 2 points.
- ‘CL3’: Lagrange Polynomials - 3 points.
XIBM_RADIUS_V,T,R,E,S : Radius (in number of grid points) for modified distance weighting (‘LAM’) of wind velocity components,potential temperature, mixing ratio of water vapour,subgrid turbulent kinetic energy,mixing ratio of scalar variables.
XIBM_POWERS_V,T,R,E,S : Exponent to be used in inverse (‘LAI’) or modified distance weighting (‘LAM’) of wind velocity components,potential temperature, mixing ratio of water vapour,subgrid turbulent kinetic energy,mixing ratio of scalar variables.
CIBM_MODE_BOUNN,T,C_V : The way the value at the ghost point for wind velocity normal,tangential,tangential to the obstacles is calculated based on the value at the image point and the value at the interface.
- ‘SYM’: Symmetrical: VALUE_GHOST = VALUE_IMAGE.
- ‘ASY’: Asymmetrical: VALUE_GHOST = -VALUE_IMAGE + 2.*VALUE_INTERFACE.
- ‘CST’: Constant: VALUE_GHOST = VALUE_INTERFACE.
CIBM_MODE_BOUND_T,R,E,S : The way the value at the ghost point for potential temperature,mixing ratio of water vapour,subgrid turbulent kinetic energy,mixing ratio of scalar variables is calculated based on the value at the image point and the value at the interface.
- ‘SYM’: Symmetrical: VALUE_GHOST = VALUE_IMAGE.
- ‘ASY’: Asymmetrical: VALUE_GHOST = -VALUE_IMAGE + 2.*VALUE_INTERFACE.
- ‘CST’: Constant: VALUE_GHOST = VALUE_INTERFACE.
XIBM_FORC_BOUNN,T,C_V : The value of the boundary condition for wind velocity normal,tangential,tangential to the obstacles specified at the interface.
XIBM_FORC_BOUND_T,R,E,S : The value of the boundary condition for potential temperature,water vapour mixing ratio,subgrid turbulent kinetic energy,mixing ratio of scalar variables specified at the interface.
CIBM_TYPE_BOUNN,T,C_V : The type of boundary condition for wind velocity normal,tangential,tangential to the obstacles.
- ‘DIR’: Dirichlet boundary condition - the value of the boundary condition is the value of the parameter.
- ‘NEU’: Neumann boundary condition - the value of the boundary condition is the gradient of the parameter.
- ‘ROB’: Robin boundary condition - linear combination between Dirichlet and Neumann.
CIBM_TYPE_BOUND_T,R,E,S : The type of boundary condition for potential temperature,mixing ratio of water vapour,subgrid turbulent kinetic energy,mixing ratio of scalar variables.
- ‘DIR’: Dirichlet boundary condition - the value of the boundary condition is the value of the parameter.
- ‘NEU’: Neumann boundary condition - the value of the boundary condition is the gradient of the parameter.
- ‘ROB’: Robin boundary condition - linear combination between Dirichlet and Neumann.
CIBM_FORC_BOUNN,T,C_V : The way to calculate the value at the interface for wind velocity normal,tangential,tangential to the obstacles.
- ‘CST’: VALUE_INTERFACE is taken.
- ‘WN1’: A wall model is activated between the first layer image point and the interface.
- ‘WN3’: A wall model is activated between the second layer image point and the interface.
CIBM_FORC_BOUND_T,R,E,S : The way to calculate the value at the interface for potential temperature,mixing ratio of water vapour,subgrid turbulent kinetic energy,mixing ratio of scalar variables.
- ‘CST’: VALUE_INTERFACE is taken.
- ‘WN1’: A wall model is activated between the first layer image point and the interface.
- ‘WN3’: A wall model is activated between the second layer image point and the interface.
CIBM_FORC_BOUNR_V : Parameter for the interpolation when performing the change of basis (u,v,w) to (n,t,c) of the wind vector close to the obstacles.
- ‘CST’: Interpolation in the direction of the first image layer.
- ‘LIN’: Linear evolution between first and second image layer.

NAM_LBCn

It contains the parameters needed to specify the lateral boundary conditions for the model n. They are included in the declarative module MODD_LBCn.

NAM_LBCn content
Fortran name	Fortran type	Default value
CLBCX	ARRAY(2*CHARACTER(LEN=4))	2*’CYCL’
CLBCY	ARRAY(2*CHARACTER(LEN=4))	2*’CYCL’
XCPHASE	REAL	20.0
XCPHASE_PBL	REAL	0.0
XCARPKMAX	REAL	XUNDEF
XPOND	REAL	1.0

CLBCX : represent the type of lateral boundary condition at the left and right boundaries along x (CLBCX(1) and CLBCX(2) respectively). The possible values are :
- ‘CYCL’ : for cyclic boundary conditions (in this case CLBCX(1)=CLBCX(2)=’CYCL’)
- ‘OPEN’ : for open boundary condition (Sommerfeld equation for the normal velocity)
- ‘WALL’ : for wall boundary condition (zero normal velocity)
CLBCY : array containing 2 elements: they represent the type of lateral boundary condition at the left and right boundaries along y (CLBCY(1) and CLBCY(2) respectively). The possible values are identical to those for CLBCX.
XCPHASE : imposed phase velocity of the outgoing gravity waves. This phase velocity can be used in the Sommerfeld equation which gives the temporal evolution of the normal velosity at the open lateral boundary.
XCPHASE_PBL : imposed phase velocity of the outgoing gravity waves in the PBL.
XCARPKMAX : maximum value (in $s^{-1}$) of the relaxation coefficient used to relaxe the normal wind in the Carpenter equation for open lbc conditions. If not specified, XCARPKMAX=1/(10.* XTSTEP), that is the advised value, is imposed.
XPOND : relaxation coefficient for LBC.

NAM_LES

This namelist controls the diagnostics of turbulence, especially for Large Eddy Simulations. The diagnostics are saved in the diachronic file (.000).

NAM_LES content
Fortran name	Fortran type	Default value
LLES_MEAN	LOGICAL	.FALSE.
LLES_RESOLVED	LOGICAL	.FALSE.
LLES_SUBGRID	LOGICAL	.FALSE.
LLES_UPDRAFT	LOGICAL	.FALSE.
LLES_DOWNDRAFT	LOGICAL	.FALSE.
LLES_SPECTRA	LOGICAL	.FALSE.
LLES_CS_MASK	LOGICAL	.FALSE.
NLES_LEVELS	INTEGER(:)	all levels in physical domain
XLES_ALTITUDES	REAL(:)
NSPECTRA_LEVELS	INTEGER(:)
XSPECTRA_ALTITUDES	REAL(:)
CLES_NORM_TYPE	CHARACTER(LEN=4)	‘NONE’
CBL_HEIGHT_DEF	CHARACTER(LEN=3)	‘KE ‘
XLES_TEMP_SAMPLING	REAL	60 s if CTURB=’3DIM’
		300 s if CTURB=’1DIM’
XLES_TEMP_MEAN_START	REAL
XLES_TEMP_MEAN_END	REAL
XLES_TEMP_MEAN_STEP	REAL	3600 s
LLES_CART_MASK	LOGICAL	.FALSE.
NLES_IINF	INTEGER	1 (physical domain boundary)
NLES_ISUP	INTEGER	NIMAX physical domain boundary)
NLES_JINF	INTEGER	1 (physical domain boundary)
NLES_JSUP	INTEGER	NJMAX (physical domain boundary)
LLES_NEB_MASK	LOGICAL	.FALSE.
LLES_CORE_MASK	LOGICAL	.FALSE.
LLES_MY_MASK	LOGICAL	.FALSE.
NLES_MASKS_USER	INTEGER	NUNDEF
LCOARSEGRAIN	LOGICAL	.FALSE.
NCOARSEGRAIN	INTEGER	1
NSIZECOARSEGRAIN	INTEGER(:)

LLES_MEAN : flag for computation of the mean vertical profiles of the model variables
LLES_RESOLVED : flag for computation of the mean vertical profiles of the resolved fluxes, variances and covariances
LLES_SUBGRID : flag for computation of the mean vertical profiles of the subgrid fluxes, variances and covariances
LLES_UPDRAFT : flag for computation of the updraft vertical profiles of some resolved and subgrid fluxes, variances and covariances
LLES_DOWNDRAFT : Same as LLES_UPDRAFT but for downdrafts.
LLES_SPECTRA : flag for computation of the non-local diagnostics (2 points correlations and spectra)
LLES_CS_MASK : flag for computation of the conditional sampling diagnostics
NLES_LEVELS : list of model levels in physical domain where the local quantities are computed. Default is: all physical model levels (by default, the vertical profiles are computed on the Meso-NH grid).
XLES_ALTITUDES : list of constant altitude levels where the local quantities are computed. Not used by default.
NSPECTRA_LEVELS : list of model levels in physical domain where the non-local quantities are computed. Any number is allowed, but too many will be costly in CPU time and memory.
XSPECTRA_ALTITUDES : list of constant altitude levels where the non-local quantities are computed. Any number is allowed, but too many will be costly in CPU time and memory.
CLES_NORM_TYPE : type of normalization for the fluxes and variances:
- ‘NONE’: no normalization is computed (however, the quantities necessary to perform these are computed, and stored in the file)
- ‘CONV’: convective normalization, using $Q_0$, $w_*$, h, $<\overline{w'r'_v}>_{surf}$.
- ‘EKMA’: Ekman normalization, using $u_*$ and $L_{Ekman}$.
- ‘MOBU’: Monin-Obukhov normalization, using $L_{MO}$, $u_*$, $Q_0$, $<\overline{w'r'_v}>_{surf}$.
CBL_HEIGHT_DEF : definition of the Boundary Layer height h:
- ‘KE ‘: test on total kinetic energy: $E(h) + e(h) = 0.05 \frac{1}{h} \int_0^h{(E(z)+e(z))dz}$
- ‘WTV’: test on $<w'\theta'_v + \overline{w'\theta'_v }>$: height h where this flux is most negative.
- ‘DTH’ : test on $\theta$ profile.
- ‘FRI’ : test on the momentum flux, h is the height where the momentum flux is 5% its value at the surface.
XLES_TEMP_SAMPLING : time (seconds) between two samplings of the LES profiles and non-local quantities
XLES_TEMP_MEAN_START : time (seconds from the beginning of the simulation) at which the averaging begins. If not defined, no averaging is performed.
XLES_TEMP_MEAN_END : time (seconds from the beginning of the simulation) at which the averaging ends. If not defined, no averaging is performed.
XLES_TEMP_MEAN_STEP : time step (seconds) for averaging.
LLES_CART_MASK : flag to compute the LES diagnostics only inside a cartesian subdomain defined with the indexes of the model 1. Both local and non-local quantities can be computed.
NLES_IINF : lower i index of the cartesian subdomain in the physical domain. The default value is the physical domain left boundary.
NLES_ISUP : upper i index of the cartesian subdomain in the physical domain. The default value is the physical domain right boundary.
NLES_JINF : lower j index of the cartesian subdomain in the physical domain. The default value is the physical domain bottom boundary.
NLES_JSUP : upper j index of the cartesian subdomain in the physical domain. The default value is the physical domain top boundary.
LLES_NEB_MASK : Flag to compute the LES diagnostics separately inside and outside the model columns where clouds are present. Only local quantities can be computed.
LLES_CORE_MASK : Flag to compute the LES diagnostics separately inside and outside the model columns where cloud core is present. Only local quantities can be computed.
LLES_MY_MASK : Flag to compute the LES diagnostics on a mask defined by the user as a 2D horizontal mask. It must be coded at the beginning of the LES monitor routine. Only local quantities can be computed with this mask.
NLES_MASKS_USER : number of user’s masks
LCOARSEGRAIN: flag to activate coarse-graining online diagnostics of resolved TKE, turbulent vertical flux of $r_t$ and $\theta_l$. Additionnal fluxes terms are saved on if LCONDSAMP=T
NCOARSEGRAIN: number of coarse-graining sub-domains
NSIZECOARSEGRAIN: dimension sizes in terms of number of points for all coarse-graining sub-domains

NAM_LUNITn

NAM_LUNITn content
Fortran name	Fortran type	Default value
CINIFILE	CHARACTER(LEN=128)	‘INIFILE’
CINIFILEPGD	CHARACTER(LEN=128)	‘ ‘
CCPLFILE	CHARACTER(LEN=128)(:)	NONE

Warning

This namelist is shared in by PREP_IDEAL_CASE and MESONH programs but the CCPLFILE option is only relevant for MESONH.

CINIFILE : name of the initial Meso-NH file produced by PREP_IDEAL_CASE, it will then be used as initial file in a MESONH simulation.
CINIFILEPGD : name of the PGD file if CSURF $\neq$ ‘NONE’ :
- If you use an input PGD file for the step PREP_IDEAL_CASE (CPGD_FILE in NAM_REAL_PGD), you must have CINIFILEPGD=CPGD_FILE.
- If there is no input PGD, CINIFILEPGD is the name of the PGD file produced by PREP_IDEAL_CASE.
CCPLFILE : name of the files which contains the field values used for the coupling of the outermost MESONH model. No more than JPCPLFILEMAX=1000 (since MNH-V6-0-0) files can be used in a simulation. These CCPLFILE file names are only meaningful for the outermost model which finds its boundary conditions from a previously executed run of Meso-NH or another model (prepared by PREP_REAL_CASE). No constraint are imposed on the coupling file names only that they must be temporally ordered
If the coupling files are given by
CCPLFILE(1)= ’F_1’ -> t1

CCPLFILE(2)= ’F_2’ -> t2

CCPLFILE(3)= ’A_2’ -> t3

CCPLFILE(4)= ’A_5’ -> t4
then, the instants must satisfy : tsegment ≤ t1 < t2 < t3 < t4. If it is not the case, the program stops. If the coupling fields are not time dependent, no coupling files are required because the coupling fields are read from the inital MESONH file of model 1 as the Larger scale fields ( LSUM, LSVM, LSWM, LSTHM, LSRVM ). More details can be found in the scientific documentation of the model.

NAM_MEAN

NAM_MEAN content
Fortran name	Fortran type	Default value
LMEAN_FIELD	LOGICAL	.FALSE.
LCOV_FIELD	LOGICAL	.FALSE.
LUH_MAX	LOGICAL	.FALSE.
LMINMAX_MSLP	LOGICAL	.FALSE.
LMINMAX_VORT	LOGICAL	.FALSE.
LMINMAX_WINDFFTKE	LOGICAL	.FALSE.

LMEAN_FIELD : flag for computation of the mean and maximum values of variables between two backup outputs. The list of variables available can be modified in mean_field.f90.
LCOV_FIELD : flag for computation of covariances values of variables between two backup outputs. The list of variables available can be modified in mean_field.f90.
LUH_MAX : flag for computation of the maximum values between two backup outputs of the updraft helicity.
LMINMAX_MSLP : flag for computation of the minimum and maximum values between two backup outputs of the mean sea-level pressure.
LMINMAX_VORT : flag for computation of the minimum and maximum values between two backup outputs of the vorticities.
LMINMAX_WINDFFTKE : flag for computation of the minimum and maximum values between two backup outputs of the TKE at first level, 10 and 20 meters height; the wind gust (FF) at 10 and 20 meters and an AROME-like wind gust diagnostic.

NAM_NEBn

This namelist is new and regroup options related to internal clouds life cycle.

NAM_NEBn content
Fortran name	Fortran type	Default value
LHGT_QS	LOGICAL	.FALSE.
LSTATNW	LOGICAL	.FALSE.
XTMINMIX	REAL	253.16
XTMAXMIX	REAL	273.16
LSUBG_COND	LOGICAL	.TRUE.
CCONDENS	CHARACTER(LEN=80)	‘CB02’
CLAMBDA3	CHARACTER(LEN=4)	‘CB’
LSIGMAS	LOGICAL	.TRUE.
VSIGQSAT	REAL	0.02
CFRAC_ICE_ADJUST	CHARACTER(LEN=1)	‘S’
CFRAC_ICE_SHALLOW_MF	CHARACTER(LEN=1)	‘S’
LCONDBORN	LOGICAL	.FALSE.

LHGT_QS : flag to activate height dependence of qsat variance (VSIGQSAT)
LSTATNW : flag to switch on the full updated statistical cloud scheme
XTMINMIX : minimum temperature of mixed phase (K)
XTMAXMIX : maximum temperature of mixed phase (K)
LSUBG_COND : flag to activate the subgrid condensation scheme (refer to the scientific documentation for more details). It is strongly recommended to activate it at kilometric horizontal resolution (such as in AROME). With the microphysics scheme LIMA (CCLOUD=’LIMA’ in NAM_PARAMn), it must be used with time-splitting LPTSPLIT=T in NAM_PARAM_LIMA.
CCONDENS : subgrid distribution used in the saturation adjustment
- ‘CB02’ : to use the Chaboureau and Bechtold [2002] formulations
- ‘GAUS’ : to use a gaussian PDF
CLAMBDA3 : modulation of s’r’ computation in the saturation adjustment
- ‘CB’ : to use the formulation originally associated to the use of CCONDENS=’CB02’
- ‘NONE’ : to use a value of 1 (no modulation)
VSIGQSAT : coefficient applied to qsat variance contribution. Only available if LSIGMAS=.TRUE.. Use VSIGQSAT=0 tu turn off the qsat variance contribution
LSIGMAS : flag for using Sigma_s from turbulence scheme instead parameterized values in ice subgrid condensation scheme
CFRAC_ICE_ADJUST : Way to compute ice fraction
- ‘T’ : linear formulation according to temperature
- ‘O’ : Tao et al. (1989) formulation
- ‘N’ : No ice
- ‘S’ : Ice fraction given by the slow microphysics
CFRAC_ICE_SHALLOW_MF : Way to compute ice fraction for MF contribution
- ‘T’ : linear formulation according to temperature
- ‘O’ : Tao et al. (1989) formulation
- ‘N’ : No ice
- ‘S’ : Ice fraction given by the slow microphysics
LCONDBORN : true to limit condensation: reduce the distribution width with respect to te total water content to avoid condensate too much water vapor not present

NAM_NESTING

NAM_NESTING content
Fortran name	Fortran type	Default value
NDAD	ARRAY(8*REAL)	m-1
NDTRATIO	ARRAY(8*INTEGER)	1
XWAY	ARRAY(8*REAL)	2
LCOUPLES	LOGICAL	.FALSE.

NDAD(m) : is the model number of the father of each model “m”
NDTRATIO(m) : is the ratio between time step of model m and its father NDAD(m)
XWAY(m) : is the interactive nesting level for model m and its father NDAD(m)
- 1 one-way interactions
- 2 two-way interactions : upward information are given to the father (also for 2D fields (Surface precipitation and short wave radiative fluxes) that are used by the surface
LCOUPLES : flag to activate the auto-coupling ocean-atmosphere version of Meso-NH. Domains 1 and 2 correspond to the atmosphere model and the ocean model respectively. This work is still in development.

NAM_NUDGINGn

It contains the parameters needed for nudging of U, V, W, TH and Rv fields of model n towards large scale values. They are included in the declarative module MODD_NUDGINGn.

NAM_NUDGINGn content
Fortran name	Fortran type	Default value
LNUDGING	LOGICAL	.FALSE.
XTNUDGING	REAL	21600.0

LNUDGING : flag to activate nudging for model n.
XTNUDGING : time scale for nudging towards Large Scale values.

NAM_OUTPUT

This namelist allows to write selected fields in output files.

NAM_OUTPUT content
Fortran name	Fortran type	Default value
COUT_DIR	CHARACTER(LEN=512)	‘’
LOUT_FILESPLIT_DISABLE	LOGICAL(:,:)	.FALSE.
COUT_VAR	CHARACTER(LEN=32)(:,:,:)	‘’
XOUT_TIME	REAL(:,:,:)	-999.0
NOUT_STEP	INTEGER(:,:,:)	-999
XOUT_TIME_FREQ	REAL(:,:)	-999.0
XOUT_TIME_FREQ_FIRST	REAL(:,:)	XOUT_TIME_FREQ
NOUT_STEP_FREQ	INTEGER(:,:)	-999
NOUT_STEP_FREQ_FIRST	INTEGER(:,:)	XOUT_TIME_FREQ
LOUT_BEG	LOGICAL(:)	.FALSE.
LOUT_END	LOGICAL(:)	.FALSE.

NAM_OUTPUT content
Fortran name	Fortran type	Default value
LOUT_REDUCE_FLOAT_PRECISION	LOGICAL(:,:)	.FALSE.
LOUT_COMPRESS	LOGICAL(:,:)	.FALSE.
COUT_COMPRESS_ALGO	CHARACTER(LEN=10)(:,:)	‘ZSTD’
NOUT_COMPRESS_LEVEL	INTEGER(:,:)	4
LOUT_COMPRESS_LOSSY	LOGICAL(:,:)	.FALSE.
COUT_COMPRESS_LOSSY_ALGO	CHARACTER(LEN=10)(:,:)	‘GRANULARBR’
NOUT_COMPRESS_LOSSY_NSD	INTEGER(:,:)	3

NAM_OUTPUT content
Fortran name	Fortran type	Default value
NOUT_VAR_REDUCE_FLOAT_PRECISION	INTEGER(:,:,:)	-888
NOUT_VAR_COMPRESS_LEVEL	INTEGER(:,:,:)	-888
COUT_VAR_COMPRESS_LOSSY_ALGO	CHARACTER(LEN=10)(:,:,:)	‘NOT_SET’
NOUT_VAR_COMPRESS_LOSSY_NSD	INTEGER(:,:,:)	-888
XOUT_VAR_THR_MIN	REAL(:,:,:)	not set
XOUT_VAR_THR_MAX	REAL(:,:,:)	not set
XOUT_VAR_THR_ABSMIN	REAL(:,:,:)	not set
XOUT_VAR_THR_ABSMAX	REAL(:,:,:)	not set
COUT_VAR_THR_MIN_BEHAVIOR	CHARACTER(LEN=9)(:,:,:)	‘NOT_SET’
COUT_VAR_THR_MAX_BEHAVIOR	CHARACTER(LEN=9)(:,:,:)	‘NOT_SET’
COUT_VAR_THR_ABSMIN_BEHAVIOR	CHARACTER(LEN=9)(:,:,:)	‘NOT_SET’
COUT_VAR_THR_ABSMAX_BEHAVIOR	CHARACTER(LEN=9)(:,:,:)	‘NOT_SET’
XOUT_VAR_RND_FACTOR	REAL(:,:,:)	-999.0

NAM_OUTPUT content
Fortran name	Fortran type	Default value
LOUT_BOTTOM_ABSORBING_LAYER_REMOVE	LOGICAL(:,:)	.TRUE.
LOUT_TOP_ABSORBING_LAYER_REMOVE	LOGICAL(:,:)	.TRUE.
LOUT_UNPHYSICAL_HOR_CELLS_REMOVE	LOGICAL(:,:)	.TRUE.
LOUT_UNPHYSICAL_VER_CELLS_REMOVE	LOGICAL(:,:)	.TRUE.
LOUT_PHYSICAL_SIMPLIFIED	LOGICAL(:,:)	.FALSE.

NAM_OUTPUT content
Fortran name	Fortran type	Default value
NOUT_BOXES	INTEGER(:,:)	0
COUT_BOX_NAME	CHARACTER(LEN=32)(:,:,:)	‘Box_nnnn’
NOUT_BOX_IINF	INTEGER(:,:,:)	-999.0
NOUT_BOX_ISUP	INTEGER(:,:,:)	-999.0
NOUT_BOX_JINF	INTEGER(:,:,:)	-999.0
NOUT_BOX_JSUP	INTEGER(:,:,:)	-999.0
NOUT_BOX_KINF	INTEGER(:,:,:)	-999.0
NOUT_BOX_KSUP	INTEGER(:,:,:)	-999.0
COUT_BOX_VAR_SUPP	CHARACTER(LEN=32)(:,:,:,:)	‘’
LOUT_MAINDOMAIN_WRITE	LOGICAL(:,:)	.FALSE.

NAM_OUTPUT content
Fortran name	Fortran type	Default value
NOUT_BOX_VAR_REDUCE_FLOAT_PRECISION	INTEGER(:,:,:,:)	-888
NOUT_BOX_VAR_COMPRESS_LEVEL	INTEGER(:,:,:,:)	-888
COUT_BOX_VAR_COMPRESS_LOSSY_ALGO	CHARACTER(LEN=10)(:,:,:,:)	‘NOT_SET’
NOUT_BOX_VAR_COMPRESS_LOSSY_NSD	INTEGER(:,:,:,:)	-888
XOUT_BOX_VAR_THR_MIN	REAL(:,:,:,:)	not set
XOUT_BOX_VAR_THR_MAX	REAL(:,:,:,:)	not set
XOUT_BOX_VAR_THR_ABSMIN	REAL(:,:,:,:)	not set
XOUT_BOX_VAR_THR_ABSMAX	REAL(:,:,:,:)	not set
COUT_BOX_VAR_THR_MIN_BEHAVIOR	CHARACTER(LEN=9)(:,:,:,:)	‘NOT_SET’
COUT_BOX_VAR_THR_MAX_BEHAVIOR	CHARACTER(LEN=9)(:,:,:,:)	‘NOT_SET’
COUT_BOX_VAR_THR_ABSMIN_BEHAVIOR	CHARACTER(LEN=9)(:,:,:,:)	‘NOT_SET’
COUT_BOX_VAR_THR_ABSMAX_BEHAVIOR	CHARACTER(LEN=9)(:,:,:,:)	‘NOT_SET’
XOUT_BOX_VAR_RND_FACTOR	REAL(:,:,:,:)	-999.0

Note

Most of the parameters of this namelist have several dimensions. The first one is for the series number (noted s in the description below). It allows to define several output series with different times and variables. This dimension has been introduced in the 6.0.0 version of MesoNH and is always of size 1 for the moment (the possibility to have several series is not yet available). The second dimension is for the model number (noted m in the description below, of size 1 if the simulation is not using grid-nesting). The other dimensions depends on the parameter (b for boxes, f for fields, i for irregular times)

COUT_VAR(s,m,f): list of the field names to output for each model m (all listed in mode_field.f90). If boxes/subdomains are selected (NOUT_BOXES > 0), these fields will also be written in all the boxes (use COUT_BOX_VAR_SUPP to be more specific)
XOUT_TIME(s,m,i): array of increments in seconds from the beginning of the segment to the instant where the i-th output is REALized by the model m
NOUT_STEP(s,m,i): array of increments in timesteps from the beginning of the segment to the instant where the i-th output is REALized by the model m
XOUT_TIME_FREQ(s,m): time between 2 outputs for each model m
XOUT_TIME_FREQ_FIRST(s,m): time of the first output for each model m (if XOUT_TIME_FREQ(m) is set). If not set, the first output will be at time = XOUT_TIME_FREQ.
NOUT_STEP_FREQ(s,m): number of timesteps between 2 outputs for each model m
NOUT_TIME_FREQ_FIRST(s,m): timestep number of the first output for each model m (if NOUT_STEP_FREQ(m) is set). If not set, the first output will be at time = NOUT_STEP_FREQ.
LOUT_BEG(s): force an output at the first timestep
LOUT_END(s): force an output at the last timestep
LOUT_REDUCE_FLOAT_PRECISION(s,m): force writing of floating points numbers in single precision for each model m
LOUT_COMPRESS(s,m): enable lossless compression of data for each model mThis can have a negative impact on performance. This option loses precedence over LIO_COMPRESS of NAM_CONFIO.
COUT_COMPRESS_ALGO(s,m): set the compression algorithm (only for files in netCDF format, not for LFI format). The allowed values are ‘ZSTD’ (for Zstandard compression,default value), ‘DEFLATE’ (for zlib compression) or ‘NONE’. If set to ‘NONE’, all compression will be disabled (that stands also for lossy compression). This option loses precedence over LIO_COMPRESS_ALGO of NAM_CONFIO if LIO_COMPRESS=.TRUE.
LOUT_COMPRESS_LEVEL(s,m): set the compression level for each model m. The value must be in the 0 to 9 interval (0 for no compression, 9 for maximum compression). This option loses precedence over LIO_COMPRESS_LEVEL of NAM_CONFIO if LIO_COMPRESS=.TRUE.
LOUT_COMPRESS_LOSSY(s,m): enable lossy compression of data for each model m
COUT_COMPRESS_LOSSY_ALGO(s,m): algorithm used to reduce the number of significants digits or bits. Available algorithms: ‘BitGroom’, ‘GranularBR’, ‘BitRound’ and ‘None’ (case insensitive). Default: ‘GranularBR’
NOUT_COMPRESS_LOSSY_NSD(s,m): number of significants digits (for ‘BitGroom’, ‘GranularBR’) or bits (for ‘BitRound’) to keep. Allowed values for ‘BitGroom’, ‘GranularBR’: 1 to 15 for floats stored with 64 bits and 1 to 7 on 32 bits. And for ‘BitRound’, 1 to 23 for 32-bit floats and 1 to 52 for 64-bit floats. Default value: 3
NOUT_VAR_REDUCE_FLOAT_PRECISION(s,m,f): force writing of floating points numbers in single precision for the selected variables. If set to 0, no reduction of precision will be done. If set to 1 (or > 0), reduction of precision will be done. By default, the value for the file (LOUT_REDUCE_FLOAT_PRECISION) is taken into account.
NOUT_VAR_COMPRESS_LEVEL(s,m,f): set the compression level per variable. The value must be in the 0 to 9 interval (0 for no compression, 9 for maximum compression). By default, the value for the file (LOUT_COMPRESS and LOUT_COMPRESS_LEVEL) is taken into account.
COUT_VAR_COMPRESS_LOSSY_ALGO(s,m,f): algorithm used to reduce the number of significants digits or bits per variable. Set to ‘NONE’ to disable lossy compression. By default, the value for the file (LOUT_COMPRESS_LOSSY and LOUT_COMPRESS_LOSSY_ALGO) is taken into account.
NOUT_VAR_COMPRESS_LOSSY_NSD(s,m,f): number of significants digits (for ‘BitGroom’, ‘GranularBR’) or bits (for ‘BitRound’) to keep per variable. By default, the value for the file (LOUT_COMPRESS_LOSSY_ALGO_NSD) is taken into account.
XOUT_VAR_THR_MIN(s,m,f): minimum threshold per variable. If a value of the variable is strictly below this threshold, it is set to the one chosen with the COUT_VAR_THR_MIN_BEHAVIOR parameter. By default, no threshold is applied.
XOUT_VAR_THR_MAX(s,m,f): maximum threshold per variable. If a value of the variable is strictly above this threshold, it is set to the one chosen with the COUT_VAR_THR_MAX_BEHAVIOR parameter. By default, no threshold is applied.
XOUT_VAR_THR_ABSMIN(s,m,f): absolute minimum threshold per variable. If an absolute value of the variable is strictly below this threshold, it is set to the one chosen with the COUT_VAR_THR_ABSMIN_BEHAVIOR parameter. By default, no threshold is applied.
XOUT_VAR_THR_ABSMAX(s,m,f): absolute maximum threshold per variable. If an absolute value of the variable is strictly above this threshold, it is set to the one chosen with the COUT_VAR_THR_ABSMAX_BEHAVIOR parameter. By default, no threshold is applied.
COUT_VAR_THR_MIN_BEHAVIOR(s,m,f): behavior to apply when a value is below the minimum threshold. Allowed values (described later in this section): ‘ZERO’, ‘MIN’ (default if threshold is not negative), ‘FILLVALUE’ (default if threshold is negative), ‘VALIDMIN’, ‘UNDEF’, ‘NEGUNDEF’, ‘EXCLRANGE’ and ‘NONE’ (default if no threshold is set).
COUT_VAR_THR_MAX_BEHAVIOR(s,m,f): behavior to apply when a value is above the maximum threshold. Allowed values (described later in this section): ‘ZERO’, ‘MAX’, ‘FILLVALUE’ (default if threshold is set), ‘VALIDMAX’, ‘UNDEF’, ‘NEGUNDEF’, ‘EXCLRANGE’ and ‘NONE’ (default if no threshold is set).
COUT_VAR_THR_ABSMIN_BEHAVIOR(s,m,f): behavior to apply when an absolute value is below the absolute minimum threshold. Allowed values (described later in this section): ‘ZERO’ (default if threshold is set), ‘ABSMIN’, ‘FILLVALUE’, ‘UNDEF’, ‘NEGUNDEF’ and ‘NONE’ (default if no threshold is set).
COUT_VAR_THR_ABSMAX_BEHAVIOR(s,m,f): behavior to apply when an absolute value is above the absolute maximum threshold. Allowed values (described later in this section): ‘ABSMAX’, ‘FILLVALUE’ (default if threshold is set), ‘UNDEF’, ‘NEGUNDEF’, ‘ZERO’ and ‘NONE’ (default if no threshold is set).
XOUT_VAR_RND_FACTOR(s,m,f): rounding factor per variable. This factor is applied to the variable values. Each value is rounded to a multiple of it. It has to be positive. This allows to significantly reduce the size of the output files if compression is enabled with a loss of precision. This approach is complementary to the lossy compression which manage the number of significant digits or bits.
COUT_DIR: directory used to write outputs and diachronic files (current directory by default). It overrides CIO_DIR in NAM_CONFIO.
LOUT_FILESPLIT_DISABLE(s,m): disable splitting of files in vertical levels (in the case it was enabled with NB_PROCIO_W > 1 in NAM_CONFZ. Default: .FALSE.
LOUT_BOTTOM_ABSORBING_LAYER_REMOVE(s,m): remove the grid layers corresponding to the bottom absorbing layer (if they exist) for each model m. Default: .TRUE.
LOUT_TOP_ABSORBING_LAYER_REMOVE(s,m): remove the grid layers corresponding to the top absorbing layer (if they exist) for each model m. Default: .TRUE.
LOUT_UNPHYSICAL_HOR_CELLS_REMOVE(s,m): remove the non-physical horizontal grid cells on the borders of the domain for each model m. Default: .TRUE.
LOUT_UNPHYSICAL_VER_CELLS_REMOVE(s,m): remove the non-physical vertical grid cells on the top and upper borders of the domain for each model m. Default: .TRUE.
LOUT_PHYSICAL_SIMPLIFIED(s,m): simplify the domain by removing 1 extra layer of grid points for some fields located on non mass-point positions on the C-grid in the Arakawa convention. Enabling this option provides the advantage to get the same number of points for all fields in a given direction at the cost of losing some physical data on the borders. If disabled (default behaviour), some fields will have one more point in some directions.
NOUT_BOXES(s,m): number of subdomains/boxes to write for each model m. If set to 0 (default value), the whole domain will be written. If set to more than 0, the whole domain will not be written except if forced with LOUT_MAINDOMAIN_WRITE=.TRUE. The maximum number of boxes is 20 (can be modified with the modification of a parameter and a recompilation of Meso-NH).
COUT_BOX_NAME(s,m,b): name of the boxes for each model m
NOUT_BOX_IINF(s,m,b): lower i index of the cartesian subdomain in the physical domain. This value must be provided (if the box is enabled).
NOUT_BOX_ISUP(s,m,b): upper i index of the cartesian subdomain in the physical domain. This value must be provided (if the box is enabled).
NOUT_BOX_JINF(s,m,b): lower j index of the cartesian subdomain in the physical domain. This value must be provided (if the box is enabled).
NOUT_BOX_JSUP(s,m,b): upper j index of the cartesian subdomain in the physical domain. This value must be provided (if the box is enabled).
NOUT_BOX_KINF(s,m,b): lower k index of the cartesian subdomain in the physical domain. This value must be provided (if the box is enabled).
NOUT_BOX_KSUP(s,m,b): upper k index of the cartesian subdomain in the physical domain. This value must be provided (if the box is enabled).
COUT_BOX_VAR_SUPP(s,m,b,f): list of the variables to write for the model m and the box b. List of fields common to all the boxes can be provided with the COUT_VAR parameter.
LOUT_MAINDOMAIN_WRITE(s,m): write also the main domain in the case when NOUT_BOXES>0 (no effect if NOUT_BOXES=0). Default: .FALSE.
NOUT_BOX_VAR_REDUCE_FLOAT_PRECISION(s,m,b,f): force writing of floating points numbers in single precision for the selected variables in the box. If set to 0, no reduction of precision will be done. If set to 1 (or > 0), reduction of precision will be done. By default, the value for the file (LOUT_REDUCE_FLOAT_PRECISION) is taken into account.
OUT_BOX_VAR_COMPRESS_LEVEL(s,m,b,f): set the compression level per variable in the box. The value must be in the 0 to 9 interval (0 for no compression, 9 for maximum compression). By default, the value for the file (LOUT_COMPRESS and LOUT_COMPRESS_LEVEL) is taken into account.
COUT_BOX_VAR_COMPRESS_LOSSY_ALGO(s,m,b,f): algorithm used to reduce the number of significants digits or bits per variable in the box. Set to ‘NONE’ to disable lossy compression. By default, the value for the file (LOUT_COMPRESS_LOSSY and LOUT_COMPRESS_LOSSY_ALGO) is taken into account.
NOUT_BOX_VAR_COMPRESS_LOSSY_NSD(s,m,b,f): number of significants digits (for ‘BitGroom’, ‘GranularBR’) or bits (for ‘BitRound’) to keep per variable in the box. By default, the value for the file (LOUT_COMPRESS_LOSSY_ALGO_NSD) is taken into account.
XOUT_BOX_VAR_THR_MIN(s,m,b,f): minimum threshold per variable in the box. If a value of the variable is strictly below this threshold, it is set to the one chosen with the COUT_BOX_VAR_THR_MIN_BEHAVIOR parameter. By default, no threshold is applied.
XOUT_BOX_VAR_THR_MAX(s,m,b,f): maximum threshold per variable in the box. If a value of the variable is strictly above this threshold, it is set to the one chosen with the COUT_BOX_VAR_THR_MAX_BEHAVIOR parameter. By default, no threshold is applied.
XOUT_BOX_VAR_THR_ABSMIN(s,m,b,f): absolute minimum threshold per variable in the box. If an absolute value of the variable is strictly below this threshold, it is set to the one chosen with the COUT_BOX_VAR_THR_ABSMIN_BEHAVIOR parameter. By default, no threshold is applied.
XOUT_BOX_VAR_THR_ABSMAX(s,m,b,f): absolute maximum threshold per variable in the box. If an absolute value of the variable is strictly above this threshold, it is set to the one chosen with the COUT_BOX_VAR_THR_ABSMAX_BEHAVIOR parameter. By default, no threshold is applied.
COUT_BOX_VAR_THR_MIN_BEHAVIOR(s,m,b,f): behavior to apply when a value is below the minimum threshold in the box. Allowed values (described later in this section): ‘ZERO’, ‘MIN’ (default if threshold is not negative), ‘FILLVALUE’ (default if threshold is negative), ‘VALIDMIN’, ‘UNDEF’, ‘NEGUNDEF’, ‘EXCLRANGE’ and ‘NONE’ (default if no threshold is set).
COUT_BOX_VAR_THR_MAX_BEHAVIOR(s,m,b,f): behavior to apply when a value is above the maximum threshold in the box. Allowed values (described later in this section): ‘ZERO’, ‘MAX’, ‘FILLVALUE’ (default if threshold is set), ‘VALIDMAX’, ‘UNDEF’, ‘NEGUNDEF’, ‘EXCLRANGE’ and ‘NONE’ (default if no threshold is set).
COUT_BOX_VAR_THR_ABSMIN_BEHAVIOR(s,m,b,f): behavior to apply when an absolute value is below the absolute minimum threshold in the box. Allowed values (described later in this section): ‘ZERO’ (default if threshold is set), ‘ABSMIN’, ‘FILLVALUE’, ‘UNDEF’, ‘NEGUNDEF’ and ‘NONE’ (default if no threshold is set).
COUT_BOX_VAR_THR_ABSMAX_BEHAVIOR(s,m,b,f): behavior to apply when an absolute value is above the absolute maximum threshold in the box. Allowed values (described later in this section): ‘ABSMAX’, ‘FILLVALUE’ (default if threshold is set), ‘UNDEF’, ‘NEGUNDEF’, ‘ZERO’ and ‘NONE’ (default if no threshold is set).
XOUT_BOX_VAR_RND_FACTOR(s,m,b,f): rounding factor per variable in the box. This factor is applied to the variable values. Each value is rounded to a multiple of it. It has to be positive. This allows to significantly reduce the size of the output files if compression is enabled with a loss of precision. This approach is complementary to the lossy compression which manage the number of significant digits or bits.

Note

The following behaviors are available for thresholds (allowed choices depend on the type of the threshold):

‘ZERO’: set the value to 0
‘MIN’: set the value to the minimum threshold
‘MAX’: set the value to the maximum threshold
‘ABSMIN’: set the value to the absolute minimum threshold with the sign of the original value
‘ABSMAX’: set the value to the absolute maximum threshold with the sign of the original value
‘FILLVALUE’: set the value to the fill value (seen as an empty value in netCDF files)
‘VALIDMIN’: set the value to the valid minimum value of the variable (netCDF metadata attribute)
‘VALIDMAX’: set the value to the valid maximum value of the variable (netCDF metadata attribute)
‘UNDEF’: set the value to the undefined value XUNDEF ( 999.0 )
‘NEGUNDEF’: set the value to the negative undefined value XNEGUNDEF ( -999.0 )
‘EXCLRANGE’: exclude the value from the range defined by the min and max thresholds (if used, it must be set for both the min and max thresholds). Replacement value is the fill value.
‘NONE’: do nothing

Warning

Not all fieldnames are possible. If a field is not (yet) known, it is possible to add a personalized one by modifying the IO_WRITE_FIELD_USER subroutine.
A choosen time must be a multiple of the timestep.
Different ways to choose the output times can be combined: a regular series (given with a frequency) + irregular times. Duplicate times will be automatically removed.
In grid-nesting, output times are propagated from the parent model to its children (children are allowed to have other output times). Children regular series must be aligned with parent ones. A regular parent output must always be at the same time than a regular children output. However, children may have more frequent regular backups (parent time frequency must be a multiple of children frequencies).
Lossy compression is possible for output files. This kind of compression leads to a loss of data but allows high reduction in the size of the output files. The procedure to reduce filespace is a two-phase process. Firstly, the last bits of each array elements are all set to 0 or 1 (alternatively to try to keep the average value). And secondly, standard compression is applied. Three algorithms are available. They are provided by the netCDF library. For each of them, it is possible to choose the number of significants digits or bits to keep.
Data in boxes (if NOUT_BOXES>0) is not written in Z-split files even if NB_PROCIO_W > 1
Lossy compression is only available for float numbers.
Thresholds and rounding factors are available only for float numbers.
Rounding factors are applied after thresholds.
It is not recommended (but not forbidden) to mix lossy compression and rounding factor for a variable.

NAM_PARAMn

It contains the different types of parameterizations used by the model n. They are included in the declarative module MODD_PARAMn.

NAM_PARAMn content
Fortran name	Fortran type	Default value
CTURB	CHARACTER(LEN=4)	‘NONE’
CRAD	CHARACTER(LEN=4)	‘NONE’
CCLOUD	CHARACTER(LEN=4)	‘NONE’
CDCONV	CHARACTER(LEN=4)	‘NONE’
CSCONV	CHARACTER(LEN=4)	‘NONE’
CELEC	CHARACTER(LEN=4)	‘NONE’
CACTCCN	CHARACTER(LEN=4)	‘NONE’

CTURB : type of turbulence scheme used to parameterize the transfers from unresolved scales to resolved scales.
- ‘NONE’ : no turbulence scheme.
- ‘TKEL’ : turbulence scheme with a one and a half order closure (i.e. prognostic turbulent kinetic energy (TKE) and diagnostic mixing length). Specific options have to be set in NAM_TURBn.
CRAD : type of radiative transfer scheme used to parameterize the effects of the solar and infrared radiations.
- ‘NONE’ : then the downward surface fluxes are set to zero
- ‘TOPA’ : the solar flux is equal to the one at TOP of Atmosphere. The infra-red flux is equal to 300 ${\rm W.m}^{-2}$.
- ‘FIXE’ : then the daily evolutions of the downward surface fluxes are prescribed. The temporal evolution is done in the routine PHYS_PARAMn by fixing the hourly value of the infrared and solar fluxes and can be modified for personal application.
- ‘ECMW’ : the ECMWF radiation scheme code is used. Specific options have to be set in NAM_PARAM_RADn.
- ‘ECRA’ : the ECRAD radiation scheme code is used. Specific options have to be set in NAM_PARAM_RADn and NAM_PARAM_ECRADn.
CCLOUD : type of the microphysical scheme used to parameterize the different water phases’ transformations.
- ‘NONE’ no microphysical scheme is used. You can still use water vapor if you want (LUSERV= TRUE or FALSE)
- ‘REVE’ only the saturation adjustment is used to create cloud water. This liquid water is never transformed in rain water.
- ‘KESS’ a warm Kessler microphysical scheme is used. It allows transformations between the 3 classes of water: vapor, cloud water and rain.
- ‘C2R2’ a 2-moment warm microphysical scheme according to Cohard and Pinty (2000). Specific options have to be set in NAM_PARAM_C2R2.
- ‘KHKO’ a 2-moment warm microphysical scheme for LES of Stratocumulus according to Khairoudinov and Kogan (2000). Specific options have to be set in NAM_PARAM_C2R2.
- ‘ICE3’ a mixed microphysical scheme including ice, snow, and graupel (6 classes of hydrometeors).
- ‘LIMA’ a mixed 2-moment microphysical scheme (6 classes of hydrometeors ). Specific options have to be set in NAM_PARAM_LIMA.
- ‘ICE4’ same as ICE3 but with hail (7 classes of hydrometeors).
CDCONV : type of deep convection scheme used to parameterize the effects of unresolved convective clouds.
- ‘NONE’ : no convection scheme.
- ‘KAFR’ : Kain-Fritsch-Bechtold scheme. Specific options have to be set in NAM_PARAM_KAFRn.
CSCONV : type of shallow convection scheme used to parameterize the effects of unresolved shallow convective clouds.
- ‘NONE’ : no convection scheme.
- ‘KAFR’ : Kain-Fritsch-Bechtold scheme. Specific options have to be set in NAM_PARAM_KAFRn.
- ‘EDKF’ : Eddy-Diffusivity-Kain-Fritsch scheme (according to Pergaud et al., 2008). Can only be used with CTURB=’TKEL’. Specific options have to be set in NAM_PARAM_MFSHALLn.
CELEC : type of electricity-lightning scheme used to parameterize electrification of hydrometeors
- ‘NONE’ : no electricity-lightning scheme.
- ‘ELE3’ : original scheme CELLS based on duplication of microphysics ICE3 code. Works only with NAM_PARAM_ICEn LRED=F, LSNOW_T=F. Specific options have to be set in NAM_ELEC.
- ‘ELE4’ : externalization and modernization of ELE3 with possibility to use with LIMA and ICE3 with time-splitting. Specific options have to be set in NAM_ELEC.

Note

With LIMA, two configurations are possible in NAM_PARAM_LIMA:

LPTSPLIT=T, NMOM_C=NMOM_R=NMOM_I=2, NMOM_S=NMOM_G=1, NMOM_H=0, and LSNOW_T=F

LPTSPLIT=T, NMOM_C=NMOM_R=NMOM_I=NMOM_S=NMOM_G=2, NMOM_H=0, and LSNOW_T=F.

With ICE3, set LRED=T and LSNOW_T=F in NAM_PARAM_ICEn.

CACTCCN : type of CCN activation scheme
- ‘NONE’ : no CCN activation scheme.

NAM_PARAM_C2R2

It contains the control parameters for the C2R2 warm microphysical scheme (CCLOUD = “C2R2” or “KHKO” in NAM_PARAMn).

NAM_PARAM_C2R2 content
Fortran name	Fortran type	Default value
HPARAM_CCN	CHARACTER(LEN=3)	‘XXX’
HINI_CCN	CHARACTER(LEN=3)	‘XXX’
HTYPE_CCN	CHARACTER(LEN=1)	‘X’
XCHEN	REAL	0.0
XKHEN	REAL	0.0
XMUHEN	REAL	0.0
XBETAHEN	REAL	0.0
XCONC_CCN	REAL	0.0
XR_MEAN_CCN	REAL	0.0
XLOGSIG_CCN	REAL	0.0
XFSOLUB_CCN	REAL	1.0
XACTEMP_CCN	REAL	280.0
XALPHAC	REAL	3.0
XNUC	REAL	1.0
XALPHAR	REAL	1.0
XNUR	REAL	2.0
LRAIN	LOGICAL	.TRUE.
LSEDC	LOGICAL	.TRUE.
LACTIT	LOGICAL	.FALSE.
LSUPSAT	LOGICAL	.FALSE.
LDEPOC	LOGICAL	.FALSE.
XVDEPOC	REAL	0.02
LACTTKE	LOGICAL	.TRUE.

HPARAM_CCN : Acronym of the CCN activation parameterization to use (‘CPB’,’TFH’ or ‘TWO’). The ‘TFH’ and ‘TWO’ need only to prescribe the XCHEN and XKHEN parameters.
- ‘TWO’ refers to the classical activation spectrum of Twomey in the form $N_{CCN}(s)= C s^k$
- ‘TFH’ includes some improvements brought by Feingold and Heymsfield [1992] to the original activation spectrum of Twomey.
- ‘CPB’ refers to an activation spectrum in the form defined in Cohard et al. [1998] with
\[N_{CCN}(s)= C s^k F(\mu,\frac{\displaystyle{k}}{\displaystyle{2}},\frac{\displaystyle{k}}{\displaystyle{2}}+1;-\beta s^2)\]

where F is the hypergeometric function and $[C, k, \mu, \beta]$, four adjustable coefficients.
HINI_CCN : If HPARAM_CCN=’CPB’ then the initial CCN characteristics are given in the ‘CCN’ or ‘AER’ format. In the ‘CCN’ case, the parameters XCHEN, XKHEN, XMUHEN and XBETAHEN must be given while it is the case for XCONC_CCN, XR_MEAN_CCN, XLOGSIG_CCN, XFSOLUB_CCN and XACTEMP_CCN if the ‘AER’ option is chosen.
- ‘CCN’ The aerosols are directly characterized by their activation spectrum $N_{CCN}(s)$ in the form $C s^k$ or
\[C s^k F(\mu,\frac{\displaystyle{k}}{\displaystyle{2}},\frac{\displaystyle{k}}{\displaystyle{2}}+1;-\beta s^2)\]
- ‘AER’ The aerosols are particles which are characterized by a lognormal distribution law in the form:
\[{\displaystyle N}/{\displaystyle {\sqrt {2 \pi}} {\rm ln}(\sigma)} exp \Big ( - {\displaystyle {\rm ln} (r/\overline{r})^2}/{\displaystyle 2 {\rm ln}(\sigma)^2} \Big )\]

with distribution parameters ($\overline{r}$ is the geometric mean radius, $\sigma$ the geometric standard deviation and N the total particle number), by their solubility ($\epsilon_m$) and by their activation temperature (T) as described by Cohard et al. [2000].
HTYPE_CCN : Aerosol type (‘M’ or ‘C’) if HPARAM_CCN==’CPB’ and HINI_CCN==’AER’ is chosen.
- ‘M’: NaCl composition (large size maritime aerosols)
- ‘C’: (NH4)2SO4 composition (small size continental aerosols)
XCHEN : C parameter in the generic activation spectrum $N_{CCN}(s)$
XKHEN : k parameter in the generic activation spectrum $N_{CCN}(s)$
XMUHEN : $\mu$ parameter in the hypergeometric function of the CPB form of the activation spectrum $N_{CCN}(s)$
XBETAHEN: :math:beta` parameter in the hypergeometric function of the CPB form of the activation spectrum $N_{CCN}(s)$
XCONC_CCN : aerosol concentration number (N)
XR_MEAN_CCN : geometric mean radius of the aerosol distribution ($\overline{r}$)
XLOGSIG_CCN : natural logarithm of the geometric standard deviation of the aerosol distribution (${\rm ln}(\sigma)$)
XFSOLUB_CCN : Mean solubility of the aerosols ($\epsilon_m$)
XACTEMP_CCN : Mean air temperature at which activation will occur.
XALPHAC : First dispersion parameter ($\alpha_c$) of the $\gamma$-distribution law of the cloud droplets :

\[\gamma_c (D)=\frac{\displaystyle{\alpha_c}}{\displaystyle{\Gamma(\nu_c)}} \lambda_c^{\alpha_c \nu_c} D ^{\alpha_c \nu_c -1} exp\big(-(\lambda_c D)^{\alpha_c}\big)\]
XNUC : Second dispersion parameter ($\nu_c$) of the $\gamma$-distribution law of the cloud droplets
XALPHAR : First dispersion parameter ($\alpha_r$) of the $\gamma$-distribution law of the rain drops

\[\gamma_r (D)=\frac{\displaystyle{\alpha_r}}{\displaystyle{\Gamma(\nu_r)}} \lambda_r^{\alpha_r \nu_r} D ^{\alpha_r \nu_r -1} exp\big(-(\lambda_r D)^{\alpha_r}\big))\]
XNUR : Second dispersion parameter ($\nu_r$) of the $\gamma$-distribution law of the rain drops
LRAIN : Enables the rain formation (by cloud droplet autoconversion) if set to TRUE
LSEDC : Cloud droplets are allowed to sediment if set to TRUE
LACTIT : Activation by radiative cooling is taken into account if set to TRUE
LSUPSAT : Pseudo-prognostic supersaturation according to Thouron et al. [2012] taken into account if set to TRUE
LDEPOC : TRUE to enable cloud droplet deposition
XVDEPOC : Droplet deposition velocity
LACTTKE : TRUE to take into account TKE in the calculation of vertical velocity for activation

NAM_PARAM_ECRADn

It contains the options for the ECRAD radiative scheme (CRAD = “ECRA” in NAM_PARAMn). ECRAD version is defined in the compilation procedure by setting VERSION_ECRAD.

Note

Since the version 1.4.0, ECRAD is open-source. To use ECRAD, you must link specific files found at $SRC_MESONH/src/LIB/RAD/ecrad-VERSION_ECRAD/data/ in the folder of the simulation.

NAM_PARAM_ECRADn content
Fortran name	Fortran type	Default value
CDATADIR	CHARACTER(LEN=511)	.
LDO_SW	LOGICAL	.TRUE.
LDO_LW	LOGICAL	.TRUE.
LDO_SW_DIRECT	LOGICAL	.TRUE.
LDO_CLEAR	LOGICAL	.TRUE.
LDO_CLOUD_AEROSOL_PER_SW_G_POINT	LOGICAL	.TRUE.
LDO_CLOUD_AEROSOL_PER_LW_G_POINT	LOGICAL	.TRUE.
CGAS_MODEL_NAME	CHARACTER(LEN=63)	RRTMG-IFS
CSW_SOLVER_NAME	CHARACTER(LEN=63)	Tripleclouds
CLW_SOLVER_NAME	CHARACTER(LEN=63)	Tripleclouds
COVERLAP_SCHEME_NAME	CHARACTER(LEN=63)	Exp-Ran
CGAS_OPTICS_SW_OVERRIDE_FILE_NAME	CHARACTER(LEN=511)
CGAS_OPTICS_LW_OVERRIDE_FILE_NAME	CHARACTER(LEN=511)
LUSE_AEROSOLS	LOGICAL	.TRUE.
LUSE_GENERAL_AEROSOL_OPTICS	LOGICAL	.FALSE.
LDO_LW_AEROSOL_SCATTERING	LOGICAL	.TRUE.
NAEROSOL_TYPES	INTEGER	12
NI_AEROSOL_TYPE_MAP	INTEGER(NMAXAEROSOLTYPES)	(1,2,3,4,5,6/)
CAEROSOL_OPTICS_OVERRIDE_FILE_NAME	CHARACTER(LEN=511)	aerosol_ifs_rrtm_49R1.nc
CLIQUID_MODEL_NAME	CHARACTER(LEN=63)	SOCRATES
CICE_MODEL_NAME	CHARACTER(LEN=63)	Fu-IFS
LUSE_GENERAL_CLOUD_OPTICS	LOGICAL	.TRUE.
LDO_LW_CLOUD_SCATTERING	LOGICAL	.TRUE.
CIQ_OPTICS_OVERRIDE_FILE_NAME	CHARACTER(LEN=511)
CICE_OPTICS_OVERRIDE_FILE_NAME	CHARACTER(LEN=511)
CCLOUD_TYPE_NAME	CHARACTER(LEN=511)(:)	mie_droplet
LUSE_THICK_CLOUD_SPECTRAL_AVERAGING(:)	LOGICAL	.TRUE.
LUSE_BETA_OVERLAP	LOGICAL	.FALSE.
XCLOUD_INHOM_DECORR_SCALING	REAL	1.0
XCLOUD_FRACTION_THRESHOLD	REAL	1.0E-6
XCLOUD_MIXING_RATIO_THRESHOLD	REAL	1.0E-9
CCLOUD_PDF_SHAPE_NAME	CHARACTER(LEN=63)	Gamma
CCLOUD_PDF_OVERRIDE_FILE_NAME	CHARACTER(LEN=511)
LDO_SW_DELTA_SCALING_WITH_GASES	LOGICAL	.FALSE.
LDO_3D_EFFECTS	LOGICAL	.TRUE.
LDO_LW_SIDE_EMISSIVITY	LOGICAL	.TRUE.
CSW_ENTRAPMENT_NAME	CHARACTER(LEN=63)	Explicit
LDO_3D_LW_MULTILAYER_EFFECTS	LOGICAL	.FALSE.
XMAX_3D_TRANSFER_RATE	REAL	10.0
XMAX_GAS_OD_3D	REAL	8.0
XMAX_CLOUD_OD	REAL	16.0
LUSE_EXPM_EVERYWHERE	LOGICAL	.FALSE.
XCLEAR_TO_THICK_FRACTION	REAL	0.0
XOVERHEAD_SUN_FACTOR	REAL	0.0
XOVERHANG_FACTOR	REAL	0.0
LDO_NEAREST_SPECTRAL_SW_ALBEDO	LOGICAL	.FALSE.
LDO_NEAREST_SPECTRAL_LW_EMISS	LOGICAL	.FALSE.
XSW_ALBEDO_WAVELENGTH_BOUND	REAL(:)	-10
XLW_EMISS_WAVELENGTH_BOUND	REAL(:)	-10
ISW_ALBEDO_INDEX	INTEGER(:)	0
ILW_EMISS_INDEX	INTEGER(:)	0
LDO_WEIGHTED_SURFACE_MAPPING	LOGICAL	.TRUE.
IVERBOSESETUP	INTEGER	3
IVERBOSE	INTEGER	1
LDO_SAVE_SPECTRAL_FLUX	LOGICAL	.FALSE.
LDO_SAVE_GPOINT_FLUX	LOGICAL	.FALSE.
LDO_SAVE_RADIATIVE_PROPERTIES	LOGICAL	.FALSE.
NRADLP	INTEGER	1
NRADIP	INTEGER	1
NREG	INTEGER	3
XCLOUD_FRAC_STD	REAL	1.0
LSPEC_EMISS	LOGICAL	.FALSE
LSPEC_ALB	LOGICAL	.FALSE.
SURF_TYPE	CHARACTER(LEN=4)	‘SNOW’

CDATADIR: Directory containing NetCDF data files
LDO_SW: flag to compute shortwave fluxes
LDO_LW: flag to compute longwave fluxes
LDO_SW_DIRECT: flag to compute direct shortwave fluxes
LDO_CLEAR: flag to ompute clear-sky fluxes
LDO_CLOUD_AEROSOL_PER_SW_G_POINT: flag to ompute cloud, aerosol and surface shortwave optical properties per g-point
LDO_CLOUD_AEROSOL_PER_LW_G_POINT: flag to compute cloud, aerosol and surface longwave optical properties per g-point
CGAS_MODEL_NAME: Gas optics model: ‘RRTMG-IFS’, ‘ECCKD’ or ‘Monochromatic’.
CGAS_OPTICS_SW_OVERRIDE_FILE_NAME: Path to alternative shortwave ecCKD gas optics file
CGAS_OPTICS_LW_OVERRIDE_FILE_NAME: Path to alternative longwave ecCKD gas optics file
LUSE_AEROSOLS: flag to represent aerosols
LUSE_GENERAL_AEROSOL_OPTICS: Support arbitrary spectral discretization for aerosols (not just RRTMG)
LDO_LW_AEROSOL_SCATTERING: Include longwave aerosol scattering?
NAEROSOL_TYPES: Number of aerosol types
NI_AEROSOL_TYPE_MAP(:): Mapping from input aerosol types to aerosol optics NetCDF file. By default the mapping is 1: Continental background, 2: Maritime, 3: Desert, 4: Urban, 5: Volcanic active, 6: Stratospheric background. Positive integers indexe hydrophobic types, negative integers index hydrophilic types and zero indicates a type should be ignored
CAEROSOL_OPTICS_OVERRIDE_FILE_NAME: Path to alternative aerosol optics file
CLIQUID_MODEL_NAME: Liquid optics model: ‘SOCRATES’, ‘Slingo’ (1989) or ‘Monochromatic’
CICE_MODEL_NAME: Ice optics model: ‘Fu-IFS’, ‘Baran2016’, ‘Yi’ or ‘Monochromatic’. From Fu(1996), Fu et al. (1998), Baran et al. (2016) and Yi et al. (2013)
LUSE_GENERAL_CLOUD_OPTICS: Support arbitrary hydrometeor types?
LDO_LW_CLOUD_SCATTERING: Include longwave cloud scattering?
CLIQ_OPTICS_OVERRIDE_FILE_NAME: Alternative liquid optics file name
CICE_OPTICS_OVERRIDE_FILE_NAME: Alternative ice optics file name
CCLOUD_TYPE_NAME(:): Optical property model name for each generalized hydrometeor species: ‘mie_droplet’, ‘baum-general-habit-mixture_ice’
LUSE_THICK_CLOUD_SPECTRAL_AVERAGING(:): Use thick spectral averaging?
CSW_SOLVER_NAME: Shortwave solver. ‘Cloudless’, ‘Homogeneous’, ‘McICA’, ‘Tripleclouds’, ‘SPARTACUS’. Note that the homogeneous solver assumes cloud fills the gridbox horizontally (so ignores cloud fraction) while the cloudless solver ignores clouds completely
CLW_SOLVER_NAME: Longwave solver: ‘Cloudless’, ‘Homogeneous’, ‘McICA’, ‘Tripleclouds’ or ‘SPARTACUS’
COVERLAP_SCHEME_NAME: Cloud overlap scheme: ‘Max-Ran’, ‘Exp-Ran’, ‘Exp-Exp’ Note that SPARTACUS and Tripleclouds only work with the Exp-Ran overlap scheme
LUSE_BETA_OVERLAP: Use Shonk et al . 2010 $\beta$ overlap parameter definition, rather than the default $\alpha$
NREG: Number of regions, where one is clear sky and one or two are cloud (the Tripleclouds solver always assumes three regions regardless of this parameter)
XCLOUD_INHOM_DECORR_SCALING: Ratio of overlap decorrelation lengths for cloud inhomogeneities and boundaries
XCLOUD_FRACTION_THRESHOLD: Ignore clouds with fraction below this. Set to 2.5e-5 if COVERLAP_SCHEME_NAME=’Exp-Ran’
XCLOUD_FRAC_STD : Cloud water content horizontal fractional standard deviation in a gridbox
XCLOUD_MIXING_RATIO_THRESHOLD: Ignore clouds with total mixing ratio below this
CCLOUD_PDF_SHAPE_NAME: Cloud water PDF shape: ‘Gamma’ or ‘Lognormal’
CCLOUD_PDF_OVERRIDE_FILE_NAME: Name of NetCDF file of alternative cloud PDF look-up table
LDO_SW_DELTA_SCALING_WITH_GASES: Apply delta-Eddington scaling to particle-gas mixture, rather than particles only (see Hogan and Bozzo, 2018)
LDO_3D_EFFECTS: Represent cloud edge effects when SPARTACUS solver selected; note that this option does not affect entrapment, which is also a 3D effect
LDO_LW_SIDE_EMISSIVITY: Represent effective emissivity of the side of clouds (Schafer et al., 2016)
CSW_ENTRAPMENT_NAME: Entrapment model (Hogan et al. 2019): ‘Zero’, ‘Edge-only’, ‘Explicit’, ‘Non-fractal’ or ‘Maximum’.
LDO_3D_LW_MULTILAYER_EFFECTS: Maximum entrapment for longwave radiation?
XMAX_3D_TRANSFER_RATE: Maximum rate of lateral exchange between regions in one layer, for stability of matrix exponential (where the default means that as little as e−10 of the radiation could remain in a region)
XMAX_GAS_OD_3D: 3D effects ignored for spectral intervals where gas optical depth of a layer exceeds this, for stability
XMAX_CLOUD_OD: Maximum in-cloud optical depth, for stability
LUSE_EXPM_EVERYWHERE: Use matrix-exponential method even when 3D effects not important, such as clear-sky layers and parts of the spectrum where the gas optical depth is large?
XCLEAR_TO_THICK_FRACTION: Fraction of cloud edge interfacing directly to the most optically thick cloudy region
XOVERHEAD_SUN_FACTOR: Minimum tan-squared of solar zenith angle to allow some ‘direct’ radiation from overhead sun to pass through cloud sides (0.06 used by Hogan et al., 2016)
XOVERHANG_FACTOR: A detail of the entrapment representation described by Hogan et al. (2019)
LDO_NEAREST_SPECTRAL_SW_ALBEDO: Surface shortwave albedos may be supplied in their own spectral intervals: do we select the nearest to each band of the gas optics scheme, rather than using a weighted average?
LDO_NEAREST_SPECTRAL_LW_EMISS: same as LDO_NEAREST_SPECTRAL_SW_ALBEDO for longwave emissivity
XSW_ALBEDO_WAVELENGTH_BOUND(:): Vector of the wavelength bounds (m) delimiting the shortwave albedo intervals
XLW_EMISS_WAVELENGTH_BOUND(:): Vector of the wavelength bounds (m) delimiting the longwave emissivity intervals
ISW_ALBEDO_INDEX(:): Vector of indices mapping albedos to wavelength intervals
ILW_EMISS_INDEX(:): Vector of indices mapping emissivities to wavelength intervals
LDO_WEIGHTED_SURFACE_MAPPING: Planck-weighted surface mapping?
IVERBOSESETUP: Setup verbosity level. 1=warning, 2=info, 3=progress, 4=detailed, 5=debug
IVERBOSE: Execution verbosity level
LDO_SAVE_SPECTRAL_FLUX: Save flux profiles in each band
LDO_SAVE_GPOINT_FLUX: Save flux profiles in each g-point
LDO_SAVE_RADIATIVE_PROPERTIES: Write intermediate NetCDF file(s) of properties sent to solver (radiative_properties*.nc)?
NRADLP : liquid effective radius calculation
- 0: ERA-15,
- 1: Zhang and Rossow,
- 2: Martin (1994),
- 3: Martin (1994) and Woods (2000)
- 4: use droplets mixing ratio and concentration from LIMA
NRADIP : ice water effective radius calculation
- 0: 40 mum
- 1: Liou and Ou (1994)
- 2: Liou and Ou (1994) improved
- 3: Sun and Rikus (1999)
- 4: use ice crystals mixing ratio and concentration from LIMA
LSPEC_EMISS : flag to use an idealized (horizontally homogeneous) spectral emissivity defined by SURF_TYPE
LSPEC_ALB : flag to use an idealized (horizontally homogeneous) spectral albedo defined by SURF_TYPE
SURF_TYPE : type of surface for idealized spectral emissivity and albedo among “VEGE”, “SNOW”, “OCEA”, “DESE”, “ZERO”, “UNIT”. Values are read in ECRAD data files (spectral_albedo.nc spectral_emissivity.nc (these files are in src/LIB/RAD/data_mnh).

NAM_PARAM_ICEn

It contains the options for the mixed phase cloud parameterizations used by the model (CCLOUD = “ICE3” or “ICE4” in NAM_PARAMn).

NAM_PARAM_ICEn content
Fortran name	Fortran type	Default value
LWARM	LOGICAL	TRUE
CPRISTINE_ICE	CHARACTER(LEN=4)	‘PLAT’
LSEDIC	LOGICAL	TRUE
CSEDIM	CHARACTER(LEN=4)	‘SPLI’
LCONVHG	LOGICAL	FALSE
LDEPOSC	LOGICAL	FALSE
XVDEPOSC	REAL	0.02
LRED	LOGICAL	TRUE
LFEEDBACKT	LOGICAL	TRUE
LEVLIMIT	LOGICAL	TRUE
LNULLWETG	LOGICAL	TRUE
LWETGPOST	LOGICAL	TRUE
LNULLWETH	LOGICAL	TRUE
LWETHPOST	LOGICAL	TRUE
CSNOWRIMING	CHARACTER(LEN=4)	‘M90 ‘
XFRACM90	REAL	0.1
NMAXITER_MICRO	INTEGER	1
XMRSTEP	REAL	0.00005
XTSTEP_TS	REAL	0.0
LADJ_BEFORE	LOGICAL	TRUE
LADJ_AFTER	LOGICAL	TRUE
LCRFLIMIT	LOGICAL	TRUE
XSPLIT_MAXCFL	REAL	0.8
LSEDIM_AFTER	LOGICAL	FALSE
CSUBG_RC_RR_ACCR	CHARACTER(LEN=80)	‘NONE’
CSUBG_RR_EVAP	CHARACTER(LEN=80)	‘NONE’
CSUBG_PR_PDF	CHARACTER(LEN=80)	‘SIGM’
CSUBG_AUCV_RC	CHARACTER(LEN=4)	‘NONE’
CSUBG_AUCV_RI	CHARACTER(LEN=80)	‘NONE’
CSUBG_MF_PDF	CHARACTER(LEN=80)	‘TRIANGLE’
LSNOW_T	LOGICAL	.FALSE.
LPACK_INTERP	LOGICAL	TRUE
LPACK_MICRO	LOGICAL	TRUE
NPROMICRO	INTEGER	0
LCRIAUTI	LOGICAL	FALSE
LOCND2	LOGICAL	FALSE
XCRIAUTI_NAM	REAL	0.2E-4
XT0CRIAUTI_NAM	REAL	(LOG10(XCRIAUTI_NAM)
		-XBCRIAUTI_NAM)/0.06
XBCRIAUTI_NAM	REAL	-3.5
XACRIAUTI_NAM	REAL	0.06
XCRIAUTC_NAM	REAL	0.5E-3
XRDEPSRED_NAM	REAL	1.0
XRDEPGRED_NAM	REAL	1.0
XFRMIN_NAM	REAL(40)
LKOGAN	LOGICAL	.FALSE.
LMODICEDEP	LOGICAL	.FALSE.
LEXCLDROP	LOGICAL	.FALSE.
LEXT_TEND	LOGICAL	.FALSE.

LWARM : When .TRUE. activates the formation of rain by the warm microphysical processes
CPRISTINE_ICE : Pristine ice crystal type
- ‘PLAT’ : plates
- ‘COLU’ : columns
- ‘BURO’ : bullet rosettes
LSEDIC : Cloud droplets are allowed to sediment if set to TRUE
CSEDIM : Sedimentation algorithm type
- ‘SPLI’ : Splitting method (original one)
- ‘STAT’ : Statistic method (accordingly to Bouteloup and Seity in AROME)
LCONVHG : For ICE4, .TRUE. activates the reconversion of hail to graupel for low values of supercooled cloud water or hail contents.
LDEPOSC : TRUE to enable cloud droplet deposition
XVDEPOSC : Droplet deposition velocity
LRED : To use modified ICE3/ICE4 to reduce time step dependency
LFEEDBACKT : .TRUE. when feedback on temperature is taken into account (active when LRED=T)
LEVLIMIT : .TRUE. when water vapour pressure is limited by saturation (active when LRED=T)
LNULLWETG : .TRUE. when graupel wet growth is activated with null rate (to allow water shedding) (active when LRED=T)
LWETGPOST : .TRUE. when graupel wet growth is activated with positive temperature (to allow water shedding) (active when LRED=T)
LNULLWETH : Same as LNULLWETG but for hail
LWETHPOST : Same as LWETGPOST but for hail
CSNOWRIMING : Parametrization for snow riming (active when LRED=T)
- ‘OLD’ : standard parametrization
- ‘M90’ : Murakami 1990 formulation
XFRACM90 : Fraction used for the Murakami 1990 formulation (active when LRED=T)
NMAXITER_MICRO : Maximum number of iterations for mixing ratio or time splitting (active when LRED=T)
XMRSTEP : Maximum mixing ratio step for mixing ratio splitting (active when LRED=T)
XTSTEP_TS : Approximative time step for time-splitting (0 for no time-splitting) (active when LRED=T)
LADJ_BEFORE : .TRUE. when an adjustment before rain_ice call is performed (active when LRED=T)
LADJ_AFTER : .TRUE. when an adjustment after rain_ice call is performed (equal to T when LRED=F)
LSNOW_T : Switch to activate the representation of snow proposed by Wurtz et al. 2023 which improves the extension and cloud composition of anvils in convective systems.
LPACK_INTERP : to save computation time, some mycrophysical processes (especially collections) are tabulated. If this key is .TRUE., the input variables for the interpolations are packed to limit the computation to the necessary points; otherwise, the interpolations are performed everywhere.
LPACK_MICRO : the microphysics input variables are packed to perform the computation only on points with hydrometeors; otherwise, computations are performed everywhere..
LCRFLIMIT : .TRUE. to limit rain contact freezing to possible heat exchange (active when LRED=T)
XSPLIT_MAXCFL : Maximum CFL number allowed for SPLIT scheme (active when LRED=T)
LSEDIM_AFTER : sedimentation done before (.FALSE.) or after (.TRUE.) microphysics (active when LRED=T)
CSUBG_AUCV_RC : Type of subgrid $r_c$ - $r_r$ autoconversion scheme.
- ‘NONE’
- ‘SIGM’ for Redelsperger and Sommeria (1982) scheme using $\overline{s'r'_{c}}$ (if LSUBG_COND is set to TRUE and only with the mixed phase for the moment)
- ‘CLFR’ from the convective cloud fraction given by EDKF (if CSCONV=’EDKF’ only)
- ‘PDF’ for subgrid warm precipitation (not only autoconversion) according to Turner et al. (2012). Only if LRED=TRUE.
- ‘ADJU’ to use a diagnostic computed in the saturation adjustment when CCONDENS is set to GAUS.
CSUBG_AUCV_RI : Type of subgrid $r_i$ - $r_s$ autoconversion scheme.
- ‘NONE’ for considering a homogeneous cloud over the entire grid-cell
- ‘CLFR’ for considering a homogeneous cloud over its cloud fraction
- ‘ADJU’ to use a diagnostic computed in the saturation adjustment when CCONDENS is set to GAUS.
CSUBG_MF_PDF : PDF used to diagnose autoconversion from the shallow convection cloud.
- ‘NONE’ for considering a homogeneous cloud over its fraction.
- ‘TRIANGLE’ to use a triangular PDF.
- ‘BIGA’ from the Gaussian PDF (if activated in the shallow convection scheme)
CSUBG_RC_RR_ACCR : Subgrid $r_c$-$r_r$ accretion
- ‘NONE’ : cloud and rain occupy the entire grid cell of the model
- ‘PRFR’ : the cloud is concentrated on the cloud fraction and the rain on the rain fraction
CSUBG_RR_EVAP : Subgrid rr evaporation
- ‘NONE’ : rain occupies the entire grid cell and evaporation can only occur on grid cells that are completely free of clouds
- ‘CLFR’ : rain occupies the entire grid cell and evaporation can only occur on the clear sky part of the grid cell
- ‘PRFR’ : same as CLFR but rain is concentrated on the rain fraction
CSUBG_PR_PDF : PDF for subgrid precipitation
- ‘SIGM’ : use of the Redelsperger and Sommeria (1986) PDF
- ‘HLCRECTPDF’ : rectangular PDF
- ‘HLCTRIANGPDF’ : triangular PDF
- ‘HLCQUADRAPDF’ : second order quadratic PDF
- ‘HLCISOTRIPDF’ : isocele triangular PDF
NPROMICRO : size of cache-blocking bloc (0 to deactivate)
LCRIAUTI : True to compute XACRIAUTI and XBCRIAUTI (from XCRIAUTI and XT0CRIAUTI); False to compute XT0CRIAUTI (from XCRIAUTI and XBCRIAUTI)
LOCND2 : flag to switch on the OCND2 scheme that separates liquid and ice (full documentation herefootnote{https://hirlam.github.io/HarmonieSystemDocumentation/dev/ForecastModel/OCDN2/})
XCRIAUTI_NAM : minimum value for the ice $\rightarrow$ snow autoconversion threshold
XT0CRIAUTI_NAM : threshold temperature for the ice $\rightarrow$ snow autoconversion threshold
XBCRIAUTI_NAM : B parameter for the ice $\rightarrow$ snow autoconversion 10**(aT+b) law
XACRIAUTI_NAM : A parameter for the ice $\rightarrow$ snow autoconversion 10**(aT+b) law
XCRIAUTC_NAM : threshold for liquid cloud $\rightarrow$ rain autoconversion (kg/m**3)
XRDEPSRED_NAM : tuning factor of sublimation of snow
XRDEPGRED_NAM : tuning factor of sublimation of graupel
XFRMIN_NAM : parameters to modify melt and growth of graupels
LKOGAN: true to use Kogan autocoversion of liquid
LMODICEDEP: flag for alternative deposition/evaporation coefficients of water vapor on ice, snow and graupel
LEXCLDROP: true to use of external cloud droplet concentration (as from near-real time aerosols) instead of constant values on land/sea masks. Only

useable in HARMONIE-AROME and not yet Meso-NH

LEXT_TEND: true to use external tendencies during the time-splitting

NAM_PARAM_KAFRn

It contains the options for deep and shallow convection parameterizations used by the model (CSCONV = “KAFR” or CDCONV = “KAFR” in NAM_PARAMn).

NAM_PARAM_KAFRN content
Fortran name	Fortran type	Default value
XDTCONV	REAL	MAX(300.0,XTSTEP)
NICE	INTEGER	1
LREFRESH_ALL	LOGICAL	.TRUE.
LCHTRANS	LOGICAL	.FALSE.
LDOWN	LOGICAL	.TRUE.
LSETTADJ	LOGICAL	.FALSE.
XTADJD	REAL	3600
XTADJS	REAL	10800
LDIAGCONV	LOGICAL	.FALSE.
NENSM	INTEGER	0

XDTCONV : timestep for the call of the convective scheme. Maximum value is 300s.
NICE : flag to include ice proceses in convection scheme ( 1 = yes, 0 = no ice ).
LREFRESH_ALL : flag to refresh convective columns at every call of the convection scheme.
LCHTRANS : flag to take into account the convective transport for scalar variables (chemical variables, passive pollutants, …). Can only be used with the options CDCONV=’KAFR’.
LDOWN : flag to use downdrafts in deep convection.
LSETTADJ : flag to allow user to define adjustment time.
XTADJD : deep convective adjustment time (if LSETTADJ=TRUE).
XTADJS : shallow convective adjustment time (if LSETTADJ=TRUE).
LDIAGCONV : flag to store diagnostic variables in module MODD_DEEP_CONVECTIONn (CAPE, deep and shallow convective cloud top and base levels, up-and downdraft mass fluxes).
NENSM : number of additional convective ensemble members for deep convection (for the moment limited to 3).

NAM_PARAM_LIMA

It contains the options for the 2 moment mixed phase cloud parameterizations used by the model (CCLOUD = “LIMA” in NAM_PARAMn).

NAM_PARAM_LIMA content
Fortran name	Fortran type	Default value
NMOM_C	INTEGER	2
NMOM_R	INTEGER	2
NMOM_I	INTEGER	2
NMOM_S	INTEGER	1
NMOM_G	INTEGER	1
NMOM_H	INTEGER	0
LNUCL	LOGICAL	.TRUE.
LSEDI	LOGICAL	.TRUE.
LHHONI	LOGICAL	.FALSE.
LMEYERS	LOGICAL	.FALSE.
NMOD_IFN	INTEGER	1
XIFN_CONC	REAL	100.0
LIFN_HOM	LOGICAL	.TRUE.
CIFN_SPECIES	CHARACTER(LEN=8)	‘PHILLIPS’
CINT_MIXING	CHARACTER(LEN=8)	‘DM2 ‘
NMOD_IMM	INTEGER	0
NIND_SPECIE	INTEGER	1
CPRISTINE_ICE_LIMA	CHARACTER(LEN=4)	‘PLAT’
XFACTNUC_DEP	REAL	1.0
XFACTNUC_CON	REAL	1.0
NPHILLIPS	INTEGER	8
LACTI	LOGICAL	.TRUE.
LSEDC	LOGICAL	.TRUE.
LACTIT	LOGICAL	.FALSE.
NMOD_CCN	INTEGER	1
XCCN_CONC	REAL	300.0
LCCN_HOM	LOGICAL	.TRUE.
CCCN_MODES	CHARACTER(LEN=8)	‘COPT ‘
HINI_CCN	CHARACTER(LEN=3)	‘AER’
HTYPE_CCN	CHARACTER(LEN=10)	‘M’
XALPHAC	REAL	3.0
XNUC	REAL	1.0
XALPHAR	REAL	1.0
XNUR	REAL	2.0
XFSOLUB_CCN	REAL	1.0
XACTEMP_CCN	REAL	280.0
LSCAV	LOGICAL	.FALSE.
LAERO_MASS	LOGICAL	.FALSE.
LACTTKE	LOGICAL	.TRUE.
LDEPOC	LOGICAL	.TRUE.
XVDEPOC	REAL	0.02
LPTSPLIT	LOGICAL	.TRUE.
LFEEDBACKT	LOGICAL	.TRUE.
NMAXITER	INTEGER	5
XMRSTEP	REAL	0.005
XTSTEP_TS	REAL	20.0
LADJ	LOGICAL	.TRUE.
LSPRO	LOGICAL	.FALSE.
LKHKO	LOGICAL	.FALSE.
LCIBU	LOGICAL	.FALSE.
LRDSF	LOGICAL	.FALSE.
XNDEBRIS_CIBU	REAL	50.0
LMURAKAMI	LOGICAL	.TRUE.
LSNOW_T	LOGICAL	.FALSE.
LKESSLERAC	LOGICAL	.FALSE.
LICE3	LOGICAL	.FALSE.
LSIGMOIDE_G	LOGICAL	.FALSE.
LSIGMOIDE_NG	LOGICAL	.FALSE.
XSIGMOIDE_G	LOGICAL	1E8
XMVDMIN_G	LOGICAL	125E-6
LCRIAUTI	LOGICAL	.FALSE.
XPSH_MAX_RDSF	REAL	0.2
XT0CRIAUTI	LOGICAL	(LOG10(XCRIAUTI)-XBCRIAUTI)/0.06
XCRIAUTI	REAL	0.2E-4
XCRIAUTC	REAL	0.5E-3
XACRIAUTI	REAL	0.06
XBCRIAUTI	REAL	-3.5
CSUBG_PR_PDF	CHARACTER(LEN=4)	‘SIGM’
CSUBG_AUCV_RC	CHARACTER(LEN=4)	‘NONE’
CSUBG_AUCV_RI	CHARACTER(LEN=4)	‘NONE’
LCRYSTAL_SHAPE	LOGICAL	.FALSE.
NNB_CRYSTAL_SHAPE	INTEGER	1
HTYPE_CRYSTAL	CHARACTER(LEN=4)(:)	NNB_CRYSTAL_SHAPE * ‘’
LICE_ISC	LOGICAL	.FALSE.
LINITORILAM	LOGICAL	.FALSE.
LINTERP_CAMS	LOGICAL	.FALSE.
LFREEZ_RATE	LOGICAL	.TRUE.

NMOM_C : number of prognostic moments for cloud droplets.
NMOM_R : number of prognostic moments for rain drops.
NMOM_I : number of prognostic moments for ice crystals.
NMOM_S : number of prognostic moments for snow/aggregates.
NMOM_G : number of prognostic moments for graupel.
NMOM_H : number of prognostic moments for hail.

Note

Note that the full flexibility is only available with the time-splitted version of LIMA (with LPTSPLIT=T). With the original version, two configurations only are available : the original parameterization with NMOM_C=NMOM_R=NMOM_I=2 and NMOM_S=NMOM_G=1; and 2 moments for all species with NMOM_x=2.

LNUCL : Switch to activate pristine ice crystals nucleation (both from IFN and homogeneous freezing)
LSEDI : Switch to activate the sedimentation of pristine ice crystals
LSNOW_T : Switch to activate the representation of snow proposed by Wurtz et al. 2023 which improves the extension and cloud composition of anvils in convective systems.
LMURAKAMI : Switch to activate the snow riming and conversion to graupel process can be computed following Murakami (1990). Only avaiable with LPTSPLIT=T.
LCIBU : swith to activate the representation of collisional ice break-up (CIBU, Hoarau et al., 2018), a secondary ice production mechanism (ice is produced by the fragmentation of snow upon impact with graupel). The number of fragments formed per collision can be fixed by XNDEBRIS_CIBU.
XNDEBRIS_CIBU : number of fragments formed per collision in the ice collisional break-up mechanism. Negative values result in a random number of fragments formed for each collision.
LRDSF : switch to activate raindrop shattering freezing, a secondary ice production mechanism.
LKHKO : switch to activate a replicate behaviour of the KHKO scheme (useful for stratocumulus clouds and drizzle formation) with LIMA code.
LHHONI : Switch to activate CCN homogeneous freezing
LMEYERS : Switch to activate the ice nucleation parameterization by Meyers (1992) instead of using the IFN
NMOD_IFN : Number of IFN modes
XIFN_CONC : Initial reference number concentration for each IFN mode (verb?#/L?)
LIFN_HOM : If set to true, the initial concentration of IFN is homogeneous on the vertical. If set to false, the IFN concentration is equal to the reference value XIFN_CONC below 1000m and exponentially decreasing above.
CINT_MIXING : String to select the proportion of each IFN type in each IFN mode. Possible values :
- ‘DM1’ pure small dust particles
- ‘DM2’ pure large dust particles
- ‘BC’ pure black carbon
- ‘O’ pure organics
- ‘CAMS’, ‘CAMS_JPP’, ‘CAMS_AIT’, ‘CAMS_ACC’, ‘MOCAGE’, mix for use of CAMS or MOCAGE aerosols
- ‘DEFAULT’ mix as in Phillips et al 2008 or 2013
CIFN_SPECIES : String to select the IFN modes size distribution parameters. Available options are :
- ‘MOCAGE’, ‘CAMS_JPP’, ‘CAMS_AIT’, ‘CAMS_ACC’ for use with MOCAGE/CAMS aerosols
- ‘DEFAULT’ to use the same parameters as in Phillips et al. 2008 or 2023
NMOD_IMM :Number of “coated IFN” modes
NIND_SPECIE : Type of the “coated IFN” mode. 1 for dust, 2 for black carbon or 3 for organics
CPRISTINE_ICE_LIMA : Select the shape of pristine ice among:
- ‘PLAT’ : plates
- ‘COLU’ : columns
- ‘BURO’ : bullet rosettes
- ‘YPLA’ : plates from Yang et al. 2013
- ‘YCOL’ : column from Yang et al. 2013
- ‘YBUR’ : solid bullet rosette from Yang et al. 2013
- ‘YDRO’ : droxtal from Yang et al. 2013
- ‘YHCO’ : hollow column from Yang et al. 2013
- ‘YHBU’ : hollow bullet rosette from Yang et al. 2013
XFACTNUC_DEP : Amplification factor for IN nucleation by deposition (only used if LMEYERS=T)
XFACTNUC_CON : Amplification factor for IN nucleation by contact (only used if LMEYERS=T)
NPHILLIPS : Version of the Phillips parameterization : 8 for the 2008 paper ; 13 for the 2013 paper
LACTI : Switch to activate the CCN activation
LSEDC : Switch to activate the cloud droplets sedimentation
LACTIT : Switch to activate the representation of radiative cooling in the diagnostic maximum supersaturation computation
NMOD_CCN : Number of CCN modes
XCCN_CONC : Reference concentration for each CCN mode (verb?#/cm3?)
LCCN_HOM : If set to true, the initial concentration of CCN is homogeneous on the vertical. If set to false, the CCN concentration is equal to the reference value XCCN_CONC below 1000m and exponentially decreasing above.
CCCN_MODES : Select the size distribution of CCN modes (‘JUNGFRAU’,’COPT’,’CAMS’, ‘CAMS_JPP’,’CAMS_ACC’,’CAMS_AIT’,’SIRTA’,’CPS00’,’FREETROP’)
HINI_CCN : Switch to use aerosols as CCN or to describe directly the CCN activation spectrum : ‘AER’ (use aerosols) or ‘CCN’ (use the CCN activation spectrum directly)
HTYPE_CCN : Switch to affect maritime or continental activation properties to each CCN mode : ‘C’ continental or ‘M’ maritime. NH42SO4 (=C), NH4NO3, NaCl (=M), H2SO4, NaNO3, NaHSO4, Na2SO4, NH43HSO42, SOA
XALPHAC,XNUC : Droplets size distribution parameter
XALPHAR,XNUR : Rain size distribution parameter
XFSOLUB_CCN : Fractional solubility of the CCN
XACTEMP_CCN : Expected temperature of CCN activation
LSCAV : Switch to activate below cloud scavenging of aerosols by rain
LAERO_MASS : Switch to track the mass of scavenged aerosols
LACTTKE : flag to use TKE in the CCN activation formulation
LDEPOC : flag to activate droplet deposition
XVDEPOC : Droplet deposition velocity
LPTSPLIT : flag to activate the time-splitting scheme
LFEEDBACKT : Flag to recompute tendencies if temperature reaches 0 (for the time-splitting scheme)
NMAXITER : Maximum number of iterations (for the time-splitting scheme)
XMRSTEP : Recompute tendencies if any mixing ratio changes by more than XMRSTEP (0=no limit) (for the time-splitting scheme)
XTSTEP_TS : Maximum length of sub-time-steps (for the time-splitting scheme)
LSPRO : flag to activate the saturation adjustement from Thouron et al. 2012 (diagnostic supersaturation)
LADJ : flag to use a saturation adjustment for cloud droplets (if set to T) or the “diagnostic supersaturation” from Thouron et al. 2012 (if set to F and LSPRO=F).
LKESSLERAC : Set to T to use the Kessler autoconversion of cloud droplets into rain drops, based on the droplets mixing ratio. Useful if NMOM_C=1 to have results closer to ICE3 simulations.

Note

Use of CAMS with LIMA. You must have set HCAMSFILE and HCAMSFILETYPE at the PREP_REAL_CASE step).

&NAM_PARAM_LIMA  HTYPE_CCN(1)='NaCl',
                  HTYPE_CCN(2)='NH42SO4',
                  HTYPE_CCN(3)='SOA',
                  NMOD_CCN=3,
                  CCCN_MODES='CAMS_AIT',
                  NMOD_IFN=2,
                  CIFN_SPECIES='CAMS_AIT',
                  CINT_MIXING='CAMS',
                  NMOD_IMM=1 /

LICE3: Use to mimic the ICE3 scheme. If set to .TRUE., some parameters are set :

NMOM_C=1
NMOM_R=1
NMOM_I=1
NMOM_S=1
NMOM_G=1
NMOM_H=MIN(NMOM_H,1)
NMOD_CCN=0
NMOD_IFN=0
LMURAKAMI=.TRUE.
LKESSLERAC=.TRUE.
XALPHAR=1.
XNUR=1.

LSIGMOIDE_G: true to limit graupel growth by XSIGMOIDE_G
XSIGMOIDE_G: sigmoide parameter for graupel growth limitation
LSIGMOIDE_NG: true to force lambda to be < lambda(Dmin)
XMVDMIN_G: minimum MVD for graupel growth lim or lambda(Dmin) calculation
LCRIAUTI: true to compute XACRIAUTI and XBCRIAUTI (from XCRIAUTI and XT0CRIAUTI). If false, XT0CRIAUTI is computed from XCRIAUTI and XBCRIAUTI.
XPSH_MAX_RDSF: shattering probability normal distribution maximum
XT0CRIAUTI: threshold temperature for the ice->snow autoconversion threshold
XCRIAUTI: minimum value for the ice $\rightarrow$ snow autoconversion threshold
XACRIAUTI: A parameter for the ice $\rightarrow$ snow autoconversion 10**(aT+b) law
XBCRIAUTI: B parameter for the ice $\rightarrow$ snow autoconversion 10**(aT+b) law
CSUBG_PR_PDF: PDF for subgrid precipitation. Options are the same as in NAM_PARAM_ICEn.
CSUBG_AUCV_RC: type of subgrid rc->rr autoconversion method. Options are the same as in NAM_PARAM_ICEn.
CSUBG_AUCV_RI: type of subgrid ri->rs autoconversion method. Options are the same as in NAM_PARAM_ICEn.
LCRYSTAL_SHAPE: true to enable several ice crystal shapes. It can only be used if LPTSPLIT=T.
NNB_CRYSTAL_SHAPE: number of ice crystal shapes ; taken into account if LCRYSTAL_SHAPE=T. For the moment, only 4 ice crystal shapes are allowed.
HTYPE_CRYSTAL_SHAPE: ice crystal shapes if LCRYSTAL_SHAPE=T. Can be set to YPLA, YCOL, YBUR or YDRO.
LICE_ISC: true to enable self collection of ice crystals
LINITORILAM: true to initialize CCN and IF by ORILAM
LINTERP_CAMS: true to interpolate CAMS data at each time step (from Large-Scale fields)
LFREEZ_RATE: true to limit riming efficiency (heat budget on icy hydrometeors collecting supercooled liquid water)

NAM_PARAM_MFSHALLn

It contains the options retained for the EDKF shallow convection scheme used by the model n (CSCONV = “EDKF” in NAM_PARAMn). Contrary to the “KAFR” scheme, “EDKF” can only be called at every time step.

NAM_PARAM_MFSHALLn content
Fortran name	Fortran type	Default value
XIMPL_MF	REAL	1
CMF_UPDRAFT	CHARACTER(LEN=4)	‘EDKF’
CMF_CLOUD	CHARACTER(LEN=4)	‘DIRE’
CWET_MIXING	CHARACTER(LEN=4)	‘PKFB’
CKIC_COMPUTE	CHARACTER(LEN=4)	‘KFB’
CDETR_DRY_LUP	CHARACTER(LEN=4)	‘SURF’
LMIXUV	LOGICAL	TRUE
LMIXTKE	LOGICAL	FALSE
LMF_FLX	LOGICAL	FALSE
XALP_PERT	REAL	0.3
XABUO	REAL	1.0
XBENTR	REAL	1.0
XBDETR	REAL	0.0
XCMF	REAL	0.065
XENTR_MF	REAL	0.035
XCRAD_MF	REAL	50.0
XENTR_DRY	REAL	0.55
XDETR_DRY	REAL	10.0
XDETR_LUP	REAL	1.0
XKCF_MF	REAL	2.75
XKRC_MF	REAL	1.0
XTAUSIGMF	REAL	600.0
XPRES_UV	REAL	0.5
XALPHA_MF	REAL	2.0
XSIGMA_MF	REAL	20.0
XSIGMA_ENV	REAL	0.0
XFRAC_UP_MAX	REAL	0.33
XA1	REAL	2.0/3.0
XB	REAL	0.002
XC	REAL	0.012
XBETA1	REAL	0.9
XR	REAL	2.0
LTHETAS_MF	LOGICAL	.FALSE.
LGZ	LOGICAL	.FALSE.
XGZ	REAL	1.83
LVERLIMUP	LOGICAL	.TRUE.
LPZ_EXP_LOG	LOGICAL	.FALSE.
XBRIO	REAL	0
XAADVEC	REAL	0
LRELAX_ALPHA_MF	LOGICAL	.FALSE.

XIMPL_MF : degree of implicitness
CMF_UPDRAFT : type of Mass Flux Scheme (‘EDKF’, ‘RHCJ’ or ‘NONE’ )
CMF_CLOUD : type of statistical cloud (‘DIRE’ for the direct calculation of the cloud fraction as a function of the updraft fraction or ‘STAT’ given by the subgrid condensation scheme)
CWET_MIXING : type of env mixing for buoyancy sorting scheme (‘PKFB’ for the original Pergaud code, ‘LR01’ for Lappen and Randall [2001])
CKIC_COMPUTE : method to compute KIC (‘KFB’ to use the PMMC09 original method, like in KFB, ‘RS08’ to use the De Rooy and Siebesma [2008] formulation)
CDETR_DRY_LUP : upward length to use in the dry detrainement (‘SURF’ to use $L_{UP}$ at surface (original PMMC09 Pergaud et al. [2009]),

‘UPDR’ to compute $L_{UP}$ in updraft)

LMIXUV : flag to take into account the mixing on momentum
LMIXTKE : flag to mix the prognostic variable TKE by updrafts. Only implemented with CMF_UPDRAFT='EDKF'
LMF_FLX : flag to compute and store the mass fluxes on every synchronous output file
XALP_PERT : coefficient for the perturbation of theta_l and r_t at the first level of the updraft
XABUO : coefficient of the buoyancy term in the w_up equation
XBENTR : coefficient of the entrainment term in the w_up equation
XBDETR : coefficient of the detrainment term in the w_up equation
XCMF : coefficient for the mass flux at the first level of the updraft (closure)
XENTR_MF : entrainment constant (m/Pa)
XCRAD_MF : cloud radius in cloudy part
XENTR_DRY : coefficient for entrainment in dry part
XDETR_DRY : coefficient for detrainment in dry part
XDETR_LUP : coefficient for detrainment in dry part
XKCF_MF : coefficient for cloud fraction
XKRC_MF : coefficient for convective rc
XPRES_UV : coefficient for pressure term in wind mixing
XALPHA_MF : coefficient for cloudy fraction
XSIGMA_MF : coefficient for sigma computation for the updraft (bi-Gaussian scheme)
XSIGMA_ENV : coefficient for sigma computation for the environment (bi-Gaussian scheme)
XFRAC_UP_MAX : maximum Updraft fraction
XA1 : Tuning variable for RHCJ10 updraft
XB : Tuning variable for RHCJ10 updraft
XC : Tuning variable for RHCJ10 updraft
XBETA1 : Tuning variable for RHCJ10 updraft
XR : Aspect ratio of updraft
LTHETAS_MF : True to compute ThetaS from ThetaL
LGZ : flag to turn on the reduction of the mass-flux surface closure with the resolution. Must be used in the turbulence grey-zone (~500 meters horizontal resolution)
XGZ : parameter for the reduction the surface closure of the Mass-Flux thermal plume if LGZ = TRUE.
LVERLIMUP : flag to allow a smooth vertical decrease of the mass-flux as soon as the updraft reaches a specific altitude, instead of a sharp limit of 0.
LPZ_EXP_LOG: true to use exp/log during dP/dZ conversion to respect hydrostatic approximation to interpolate z and p between two half-level and full-level points,

false to use linear interpolation (old interpolation, not recommended)

XBRIO : coefficient to slow down wup equa like Rio et al. [2010]
XAADVEC : coefficient for advective pressure perturbation like He et al. [2020]
LRELAX_ALPHA_MF: true to relax the small fraction assumption

NAM_PARAM_RADn

It contains some options retained for the radiative scheme used by the model n CRAD = “ECMWF”; and some options common for both CRAD = “ECMWF” or “ECRA” in NAM_PARAMn)

NAM_PARAM_RADN content
Fortran name	Fortran type	Default value
XDTRAD	REAL	60.0
XDTRAD_CLONLY	REAL	60.0
NRAD_AGG	INTEGER	1
LCLEAR_SKY	LOGICAL	FALSE
NRAD_COLNBR	INTEGER	1000
NRAD_DIAG	INTEGER	0
LAERO_FT	LOGICAL	FALSE
LFIX_DAT	LOGICAL	FALSE

CLW	CHARACTER(LEN=4)	‘RRTM’
CAER	CHARACTER(LEN=4)	‘SURF’
CEFRADL	CHARACTER(LEN=4)	‘MART’
CEFRADI	CHARACTER(LEN=4)	‘LIOU’
COPWLW	CHARACTER(LEN=4)	‘SMSH’
COPILW	CHARACTER(LEN=4)	‘EBCU’
COPWSW	CHARACTER(LEN=4)	‘FOUQ’
COPISW	CHARACTER(LEN=4)	‘EBCU’
CAOP	CHARACTER(LEN=4)	‘CLIM’
XFUDG	REAL	1.0

Note

The following options are common for CRAD = “ECMWF” or “ECRA”:

XDTRAD : Interval of time (in seconds) between two full radiation computations. ( the radiative tendency is computed for all verticals levels). This is done to save CPU time because the radiation scheme is very expensive and the radiative tendency is not evolving too much, in some cases, during periods greater than the model timestep XTSTEP. In this case, the “radiation timestep” is increased to XDTRAD
XDTRAD_CLONLY : Interval of time (in seconds) between two radiation computations for the cloudy columns only. This is based on the same principle as the intermittent full radiation call: the cloudy column radiative tendency may, in some cases, evolve faster than the dry ones but still slower than the timestep XTSTEP. In this case, the “cloudy radiation timestep” is increased from XDTRAD to XDTRAD_CLONLY. Of course, when all and part of the radiative tendencies must be refreshed at the same MESONH timestep, only the full radiation call is performed.
LCLEAR_SKY : When this flag is set to .TRUE., the radiative computations are made for a mean clear-sky and for the whole cloudy columns. This is still the way to spare some CPU time, by postulating that the clear sky columns do not lead to very different radiative tendencies. This hypothesis is only valid in academical cases.
NRAD_COLNBR : Maximal number of air columns called by a single call of the radiative subroutine. This is performed in order to save memory, because the radiation subroutine allocate for every column of size NKMAX , NKMAX working arrays . This leads to a quadratic dependency of the memory with the number of vertical levels of the model. A way to limit the necessary memory is to split the number of columns passed to the radiation subroutine in several sets of NRAD_COLNBR column. Finally, all the desired columns (depending on the preceding parameters ) will be treated by sequentially calling the radiation subroutine for every set of column.
NRAD_DIAG : number of diagnostic fields related to the radiative scheme stored in every output synchronous file (same fields as NRAD_3D in DIAG program). WARNING, a lot of variables are written only if NAM_DIAG_SURFn N2M=2.
LAERO_FT : for a temporal interpolation of aerosol and ozone distribution. By default, they consist of monhtly averages kept constant for each month If true, the climatology of O3 and aerosols (only in TEGE case) are interpolated at each call of phys_paramnn. It is not usefull if your simulation lasts less than a month or does not contain any restard. It is necessary for long-term simulation with several segments to avoid too strong a perturbation at the beginning of each month.
LFIX_DAT : flag to fix the date to a constant perpetual day. It is set by the initial SOUNDING date (RSOU). Note that the diurnal cycle is still considered.
NRAD_AGG : side of a square of aggregated columns on which the radiation code will be called. This allows cheaper numerical cost of the radiation code and reduce its cost by ${NRAD\_AGG}^{2}$. If NRAD_AGG = 1, the radiation code is called on every columns (historical version). May be useful for very high resolution LES on which calling radiation on every columns is not necessary

Note

The following options are only used by CRAD = “ECMWF”

CLW : choice of long wave radiative code
- ‘RRTM’: RAPID RADIATIVE TRANSFER MODEL
- ‘MORC’: MORCRETTE model
CAER : type of aerosol distribution
- ‘SURF’: deduced from cover data
- ‘TEGE’: computed from Tegen et al. (1997) mensual climatology (horizontal resolution is 4 degrees of latitude by 5 degrees fo longitude
- ‘TANR’: computed from ECMWF T5 climatology
- ‘NONE’: no aerosol
CEFRADL : liquid effective radius calculation
- ‘MART’ : based on Martin et al. (1994, JAS)
- ‘2MOM’ : based on the prediction of the number concentrations. Recommended with the 2-moment microphysical schemes.
- ‘PRES’ : very old parametrization as f(pressure)
- ‘OCLN’ : simple distinction between land (10) and ocean (13)
CEFRADI : ice water effective radius calculation
- ‘LIOU’ : ice particle effective radius =f(T) from Liou and Ou (1994)
- ‘SURI’ : ice particle effective radius =f(T,IWC) from Sun and Rikus (1999)
- ‘2MOM’ : based on the prediction of the number concentrations. Recommended with the 2-moment microphysical schemes (not yet available for mixed clouds).
- ‘FX40’ : fixed 40 micron effective radius
COPWLW : cloud water LW optical properties
- ‘SMSH’: Smith-Shi formulation
- ‘SAVI’: Savijarvi formulation (recommended only with 1-moment microphysical schemes with small precipitation)
- ‘MALA’: Malavelle formulation (recommended only with 2-moment microphysical schemes with small precipitation)
COPILW : ice water LW optical properties
- ‘EBCU’: Ebert-Curry formulation
- ‘SMSH’: Smith-Shi formulation, only with CLW=’RRTM’
- ‘FULI’: Fu-Liou formulation, only with CLW=’MORC’
COPWSW : cloud water short wave optical properties
- ‘FOUQ’: Fouquart, 1991 formulation
- ‘SLIN’: Slingo, 1989 formulation
- ‘MALA’: Only for 2-moment microphysical schemes. According to Malavelle.
COPISW : ice water short wave optical properties
- ‘EBCU’: Ebert-Curry formulation
- ‘FULI’: Fu-Liou formulation
CAOP : type of aerosol optical properties calculation
- ‘CLIM’: climatological aerosols
- ‘EXPL’: explicit aerosols (if LORILAM=.T. in NAM_CH_ORILAM or LDUST=.T. in NAM_DUST)
XFUDG : subgrid cloud inhomogeneity factor.

Note

The cloud overlap assumption for CRAD=’ECMW’ is defined in the routine ini_radconf.f90. The different assumptions are :

NOVLP=5 : Random overlap for Clear Sky fraction and Effective Zenithal Angle. It is the best choice without subgrid condensation.
NOVLP=6 : Maximum Random Overlap for Clear Sky fraction, and Random Overlap for Effective Zenithal Angle (DEFAULT VALUE). This option is well adapted to multi-layer clouds.
NOVLP=7 : Maximum overlap for Clear Sky fraction and Random Overlap for Effective Zenithal Angle. This option is well adapted in the absence of multi-layer clouds.
NOVLP=8 : Maximum Random overlap for Clear Sky fraction and Effective Zenithal Angle.

NAM_PASPOL

It contains the parameters to activate passive pollutants, by specifying the position and the kinetic of the release.

NAM_PASPOL content
Fortran name	Fortran type	Default value
LPASPOL	LOGICAL	.FALSE.
NRELEASE	INTEGER	0
NMODEL_PP	INTEGER	1
CPPINIT	ARRAY(100*CHARACTER(LEN=3))	100*’1PT’
XPPLAT	ARRAY(100*REAL)	100*0.0
XPPLON	ARRAY(100*REAL)	100*0.0
XPPMASS	ARRAY(100*REAL)	100*0.0
XPPBOT	ARRAY(100*REAL)	100*0.0
XPPTOP	ARRAY(100*REAL)	100*0.0
CPPT1	ARRAY(100*CHARACTER(LEN=14))	100*’20010921090000’
CPPT2	ARRAY(100*CHARACTER(LEN=14))	100*’20010921090000’
CPPT3	ARRAY(100*CHARACTER(LEN=14))	100*’20010921091500’
CPPT4	ARRAY(100*CHARACTER(LEN=14))	100*’20010921091500’

LPASPOL : Flag to activate passive pollutants
NRELEASE : Number of releases (up to 100).
CPPINIT : Type of initialization of the source (‘1PT’ or ‘9PT’)
XPPLAT : Latitude of the release
XPPLON : Longitude of the release
XPPMASS : Released mass (in g)
XPPBOT : Height of the bottom of the release (in m)
XPPTOP : Height of the top of the release (in m)
CPPT1 : Starting date of the release (in YYYYMMDDHHMMSS)
CPPT2 : Starting date of the constant rate (in YYYYMMDDHHMMSS)
CPPT3 : Ending date of the constant rate (in YYYYMMDDHHMMSS)
CPPT4 : Ending date of the release (in YYYYMMDDHHMMSS)
NMODEL_PP: model number where passive pollutants are emitted

NAM_PDF

Each PDF includes NPDF intervals number between X_PDF_MIN and X_PDF_MAX.

NAM_PDF content
Fortran name	Fortran type	Default value
LLES_PDF	LOGICAL	.FALSE.
NPDF	INTEGER	1
XTH_PDF_MIN	REAL	270.0
XTH_PDF_MAX	REAL	350.0
XW_PDF_MIN	REAL	-10.0
XW_PDF_MAX	REAL	10.0
XTHV_PDF_MIN	REAL	270.0
XTHV_PDF_MAX	REAL	350.0
XRV_PDF_MIN	REAL	0.0
XRV_PDF_MAX	REAL	20.0
XRC_PDF_MIN	REAL	0.0
XRC_PDF_MAX	REAL	1.0
XRR_PDF_MIN	REAL	0.0
XRR_PDF_MAX	REAL	1.0
XRI_PDF_MIN	REAL	0.0
XRI_PDF_MAX	REAL	1.0
XRS_PDF_MIN	REAL	0.0
XRS_PDF_MAX	REAL	1.0
XRG_PDF_MIN	REAL	0.0
XRG_PDF_MAX	REAL	1.0
XRT_PDF_MIN	REAL	0.0
XRT_PDF_MAX	REAL	20.0
XTHL_PDF_MIN	REAL	270.0
XTHL_PDF_MAX	REAL	350.0

LLES_PDF : Flag for pdf computation
NPDF : Number of PDF intervals
XTH_PDF_MIN : Minimum value of potential temperature pdf
XTH_PDF_MAX : Maximum value of potential temperature pdf
XW_PDF_MIN : Minimum value of vertical velocity pdf
XW_PDF_MAX : Maximum value of vertical velocity pdf
XTHV_PDF_MIN : Minimum value of virtual potential temperature pdf
XTHV_PDF_MAX : Maximum value of virtual potential temperature pdf
XRV_PDF_MIN : Minimum value of vapor mixing ratio pdf
XRV_PDF_MAX : Maximum value of vapor mixing ratio pdf
XRC_PDF_MIN : Minimum value of cloud mixing ratio pdf
XRC_PDF_MAX : Maximum value of cloud mixing ratio pdf
XRR_PDF_MIN : Minimum value of rain mixing ratio pdf
XRR_PDF_MAX : Maximum value of rain mixing ratio pdf
XRI_PDF_MIN : Minimum value of ice mixing ratio pdf
XRI_PDF_MAX : Maximum value of ice mixing ratio pdf
XRS_PDF_MIN : Minimum value of snow mixing ratio pdf
XRS_PDF_MAX : Maximum value of snow mixing ratio pdf
XRG_PDF_MIN : Minimum value of graupel mixing ratio pdf
XRG_PDF_MAX : Maximum value of graupel mixing ratio pdf
XRT_PDF_MIN : Minimum value of total mixing ratio pdf
XRT_PDF_MAX : Maximum value of total mixing ratio pdf
XTHL_PDF_MIN : Minimum value of $\theta_l$ pdf
XTHL_PDF_MAX : Maximum value of $\theta_l$ pdf

NAM_PROFILERn

This namelist is used to configure virtual vertical profilers by using the following described parameters or a .csv file. Calculations are done for all the nested models for which the namelist is provided and recorded in the corresponding diachronic files.

NAM_PROFILERn content
Fortran name	Fortran type	Default value
NNUMB_PROF	INTEGER	0
XSTEP_PROF	REAL	60.0
XX_PROF	REAL(:)	NNUMB_PROF * XUNDEF
XY_PROF	REAL(:)	NNUMB_PROF * XUNDEF
XLAT_PROF	REAL(:)	NNUMB_PROF * XUNDEF
XLON_PROF	REAL(:)	NNUMB_PROF * XUNDEF
XZ_PROF	REAL(:)	NNUMB_PROF * XUNDEF
CNAME_PROF	ARRAY(CHARACTER(LEN=10))	NNUMB_PROF * ‘ ‘
CFILE_PROF	CHARACTER(LEN=128)	‘NO_INPUT_CSV’
LDIAG_SURFRAD	LOGICAL	TRUE

NNUMB_PROF : number of profilers. Limited to 100 if not using a .csv file.
XSTEP_PROF : time (in seconds) between two sampling written in the diachronic file
XX_PROF : X-position (in meters) of the profiler in the cartesian coordinates (with LCARTESIAN=T only)
XY_PROF : Y-position (in meters) of the profiler in the cartesian coordinates (with LCARTESIAN=T only)
XLAT_PROF : latitude (in degrees) of the profiler (with LCARTESIAN=F only)
XLON_PROF : longitude (in degrees) of the profiler (with LCARTESIAN=F only)
XZ_PROF : height above the model orography (in meters) of the profiler
CNAME_PROF : name of the profiler
CFILE_PROF : name of the .csv file containing the definition of the profilers (see below). If CFILE_PROF=’NO_INPUT_CSV’, the .csv file is not read.
LDIAG_SURFRAD : if True, the surface and radiation variables are written. You must also set N2M=2 in NAM_DIAG_SURFn for a correct saving of SURFEX variables.

Note

If a .csv file is provided, coordinates given in the namelist will be ignored. The .csv file should follow the format example hereafter:

Name, X[m]/Lat[deg], Y[m]/Lon[deg], Z[m]
prof1, 50.0,  50.0, 10.0
prof2, 50.0,   1.0, 11.25
prof3, 350.0, 50.0, 10.0

The values of X,Y or Lat/Lon are read depending on LCARTESIAN.

NAM_RECYCL_PARAMn

NAM_RECYCL_PARAMn content
Fortran name	Fortran type	Default value
LRECYCL	LOGICAL	.FALSE.
LRECYCLW	LOGICAL	.FALSE.
LRECYCLE	LOGICAL	.FALSE.
LRECYCLS	LOGICAL	.FALSE.
LRECYCLN	LOGICAL	.FALSE.
XDRECYCLW	REAL	0.0
XDRECYCLE	REAL	0.0
XDRECYCLS	REAL	0.0
XDRECYCLN	REAL	0.0
XARECYCLW	REAL	0.0
XARECYCLE	REAL	0.0
XARECYCLS	REAL	0.0
XARECYCLN	REAL	0.0
NTMOY	INTEGER	0
NNUMBELT	INTEGER	28
NTMOYCOUNT	INTEGER	0
XRCOEFF	REAL	0.2
XTBVTOP	REAL	500.0
XTBVBOT	REAL	300.0

LRECYCL : Flag to activate turbulence recycling method or not.
- .TRUE. : turbulence recycling method is activated.
- .FALSE. : turbulence recycling method is not activated.

Warning

In its current version, the turbulence recycling method has only been validated with flat terrain (LFLAT=.TRUE.), cartesian coordinates (LCARTESIAN=.TRUE.), and a near-neutral boundary layer.

LRECYCLW,E,S,N : Flag to activate turbulence recycling method on the West, East, South, North boundaries of the domain or not.
- .TRUE.: turbulence recycling method is activated on the West, East, South, North boundaries of the domain.
- .FALSE.: turbulence recycling method is not activated on the West, East, South, North boundaries of the domain.
XDRECYCLW,E,S,N : Distance (in meters) of the recycling plan to the West, East, South, North boundary (1/4 of the domain is recommended).
XARECYCLW,E,S,N : Angle between the recycling plan and the West, East, South, North boundary (0. for X-direction and $\frac{\pi}{2}$ for Y-direction).
NTMOY : Total number of time-steps within time window for the calculation of the moving temporal average.
NNUMBELT : Number of elements used for the variable averaging.
NTMOYCOUNT : Number of time-steps between an update of the averaged variable (NTMOYCOUNT=NTMOY/NNUMBELT)
XRCOEFF : Weighting coefficient for the turbulent fluctuations, preventing calculation divergence. XRCOEFF in [0.1-0.3] for near-neutral simulations.
XTBVTOP : Threshold to filter the gravity waves. Shoud be equal to approximatively 4 times the Brunt-Vaisala period.
XTBVBOT : Threshold to filter the gravity waves. Shoud be equal to approximatively 2 times the Brunt-Vaisala period.

NAM_SALT

This namelist is used to active explicit sea salt aerosols. It is not necessary to use chemistry to activate sea salt but it is recommended to activate on-line sea salt emissions.

NAM_SALT content
Fortran name	Fortran type	Default value
LSALT	LOGICAL	.FALSE.
LVARSIG_SLT	LOGICAL	.FALSE.
LSEDIMSALT	LOGICAL	.FALSE.
NMODE_SLT	INTEGER	8
LRGFIX_SLT	LOGICAL	.FALSE.
LDEPOS_SLT	LOGICAL	.FALSE.
LSED2MOM_SLT	LOGICAL	.FALSE.

LSALT : flag to activate passive salt aerosol.
LVARSIG_SLT : flag to activate variable standard deviation for each salt modes.
LSEDIMSALT : flag to activate salt sedimentation.
NMODE_SLT : number of lognormal salt modes (a maximum of 8 modes is allowed).
LRGFIX_SLT : flag to use only 1 moment by salt mode (LRGFIX_SLT=’TRUE’ associated to LVARSIG_SLT=’FALSE)
LDEPOS_SLT : flag to activate salt wet deposition
LSED2MOM_SLT: flag to activate multimoment sedimentation on sea salts

NAM_SERIES

NAM_SERIES content
Fortran name	Fortran type	Default value
LSERIES	LOGICAL	.FALSE.
LMASKLANDSEA	LOGICAL	.FALSE.
LWMINMAX	LOGICAL	.FALSE.
LSURF	LOGICAL	.FALSE.

LSERIES : flag to write temporal series in the diachronic file (.000) of each model:
- evolution of horizontally and vertically averaged fields (t),
- evolution of horizontally averaged vertical profiles (z,t),
- evolution of y-horizontally averaged fields at one level or vertically averaged between 2 levels (x,t).
LMASKLANDSEA : flag to separate sea and land points in temporal series (t) and (z,t),
LWMINMAX : flag to compute minimum and maximum of vertical velocity W in temporal serie (t).
LSURF : flag to compute temporal series on surface fields. You have to introduce in the code the surface fields you want :
- In get_seriesn.f90 of SURFEX : put the requested fields in ZINF. In the example of the current version XTS, XT_MNW,XT_BOT, XCT, XH_ML from modd_flaken.f90 are requested.
- In get_surf_varn.f90 of SURFEX : adjust the tile necessary to be present (in the example PWATER is required)
- In ini_seriesn.f90 of Meso-NH : put the number of requested fields : ex: for 5 fields, NSTEMP_SERIE1 = NSTEMP_SERIE1 +5 and give the tittle of each field
- In seriesn.f90 of Meso-NH : give the tittle of each field

Note

NAM_SERIESn

NAM_SERIESn content
Fortran name	Fortran type	Default value
NIBOXL	INTEGER	1
NIBOXH	INTEGER	1
NJBOXL	INTEGER	1
NJBOXH	INTEGER	1
NKCLS	INTEGER	1
NKCLA	INTEGER	1
NKLOW	INTEGER	1
NKMID	INTEGER	1
NKUP	INTEGER	1
NBJSLICE	INTEGER	1
NJSLICEL	ARRAY (20*INTEGER)	20*1
NJSLICEH	ARRAY (20*INTEGER)	20*1
NFREQSERIES	INTEGER	43200/(100*60)=7

NIBOXL, NIBOXH, NJBOXL, NJBOXH : lower and upper indexes along x and y axes, respectively, of the horizontal box used to average the series (t) and (z,t) in physical domain
NKCLS, NKCLA : K level in physical domain respectively in the CLS and CLA ((x,t) series of U, Rv, Rr at KCLS and W at KCLA are stored).
NKLOW, NKUP : two K levels in physical domain ((x,t) series of mean W between KLOW and KUP and mean Rc between the ground and KUP are stored).
NKMID : a K level in physical domain ((x,t) serie of Rv at KMID is stored).
NBJSLICE : number of y-slices for (x,t) serie.
NJSLICEL, NJSLICEH : lower and higher index along y axe for the y-slices in physical domain.
NFREQSERIES : Temporal frequency of diagnostic writing (in time step unit).

NAM_STATIONn

This namelist is used to configure a virtual observed point at a station by using the following described parameters or a .csv file. Calculations are done for all the nested models for which the namelist is provided and recorded in the corresponding diachronic files.

NAM_STATIONn content
Fortran name	Fortran type	Default value
NNUMB_STAT	INTEGER	0
XSTEP_STAT	REAL	60.0
XX_STAT	REAL(:)	NNUMB_STAT * XUNDEF
XY_STAT	REAL(:)	NNUMB_STAT * XUNDEF
XLAT_STAT	REAL(:)	NNUMB_STAT * XUNDEF
XLON_STAT	REAL(:)	NNUMB_STAT * XUNDEF
XZ_STAT	REAL(:)	NNUMB_STAT * XUNDEF
CNAME_STAT	ARRAY(CHARACTER(LEN=10))	NNUMB_STAT * ‘ ‘
CFILE_STAT	CHARACTER(LEN=128)	‘NO_INPUT_CSV’
LDIAG_SURFRAD	LOGICAL	.TRUE.

NNUMB_STAT : number of stations. Limited to 100 if not using a .csv file.
XSTEP_STAT : time (in seconds) between two sampling written in the diachronic file
XX_STAT : X-position (in meters) of the station in the cartesian coordinates (with LCARTESIAN=T only)
XY_STAT : Y-position (in meters) of the station in the cartesian coordinates (with LCARTESIAN=T only)
XLAT_STAT : latitude (in degrees) of the station (with LCARTESIAN=F only)
XLON_STAT : longitude (in degrees) of the station (with LCARTESIAN=F only)
XZ_STAT : height above the model orography (in meters) of the station
CNAME_STAT : name of the station
CFILE_STAT : name of the .csv file containing the definition of the stations (see below). If CFILE_STAT=’NO_INPUT_CSV’, the .csv file is not read.
LDIAG_SURFRAD : if True, the surface and radiation variables are written. You must also set N2M=2 in NAM_DIAG_SURFn for a correct saving of SURFEX variables.

Note

If a .csv file is provided, coordinates given in the namelist will be ignored. The .csv file should follow the format example hereafter:

Name, X[m]/Lat[deg], Y[m]/Lon[deg], Z[m]
probe1, 50.0,  50.0, 10.0
probe2, 50.0,   1.0, 11.25
probe3, 350.0, 50.0, 10.0

The values of X,Y or Lat/Lon are read depending on LCARTESIAN.

NAM_TURBn

It contains the characteristics of the turbulence scheme used by the model n. They are included in the declarative module MODD_TURBn.

NAM_TURBn content
Fortran name	Fortran type	Default value
XIMPL	REAL	1.0
CTURBLEN	CHARACTER(LEN=4)	‘BL89’
CTURBDIM	CHARACTER(LEN=4)	‘1DIM’
XCADAP	REAL	0.5
LTURB_FLX	LOGICAL	.FALSE.
LTURB_DIAG	LOGICAL	.FALSE.
LSIG_CONV	LOGICAL	.FALSE.
LRMC01	LOGICAL	.FALSE.
CTOM	CHARACTER(LEN=4)	‘NONE’
XTKEMIN	REAL	$10^{-6}$
XCED	REAL	0.84
LLEONARD	LOGICAL	.FALSE.
XCOEFHGRADTHL	REAL	1.0
XCOEFHGRADRM	REAL	1.0
XALTHGRAD	REAL	2000.0
XCLDTHOLD	REAL	-1.0
LCLOUDMODIFLM	LOGICAL	.FALSE.
CTURBLEN_CLOUD	CHARACTER(LEN=4)	‘DELT’
XCOEF_AMPL_SAT	REAL	5.0
XCEI_MIN	REAL	0.001E-6
XCEI_MAX	REAL	0.01E-6
XLINI	REAL	0.1
XCTP	REAL	4.0 if LSTATNW
		else 4.65
XMINSIGS	REAL	1.E-12
LHARAT	LOGICAL	.FALSE.
LPROJQITURB	LOGICAL	.TRUE.
LSMOOTH_PRANDTL	LOGICAL	.TRUE.
NTURBSPLIT	INTEGER	1
LTURB_PRECIP	LOGICAL	.FALSE.
LGOGER	LOGICAL	.FALSE.
XSMAG	REAL	0.2
LDYNMF	LOGICAL	.FALSE.
LTHERMMF	LOGICAL	.TRUE.
LBL89TOP	LOGICAL	.FALSE.
LBL89EXP	LOGICAL	.TRUE.
LLEMARIE21	LOGICAL	.TRUE.

XIMPL : degree of implicitness of the vertical part of the turbulence scheme. (XIMPL = 0.5 corresponds to the Cranck-Nicholson scheme for the vertical turbulent diffusion and 0. to a purely explicit scheme)
CTURBDIM : turbulence dimensionality.
- ‘1DIM’ Only the vertical turbulent fluxes are taken into account. This has to be done for relatively large horizontal gridsizes.
- ‘3DIM’ All the turbulent fluxes are computed, this is necessary for small horizontal gridsizes ( meso-$\gamma$ scales or LES)
CTURBLEN : type of turbulent mixing length.
- ‘DELT’ If CTURBDIM=’3DIM’, the cubic root of the grid volum is used in 3D simulations and the squared root of the volum in 2D simulations.
- ‘1DIM’, we take $\Delta z$ in simulation of any dimensionality. This length is always limited to $\kappa * z$ near the ground.
- ‘BL89’ The mixing length is computed according to the Bougeault and Lacarrere [1989]
- ‘DEAR’ the mixing length is given by the mesh size depending on the model dimensionality, this length is limited to the ground distance and also by the Deardorff mixing length pertinent in the stable cases.
- ‘RM17’ The mixing length is computed according to Rodier et al. [2017]. It is a non-local mixing length combining BL89 with a wind shear term.
- ‘HM21’ resolution-adaptative mixing length is computed according to Honnert et al. [2020] and given by the minimum between RM17 and the horizontal resolution XCADAP $\sqrt{\Delta x \Delta y}$, where XCADAP is a namelist parameter set to 0.5.
XCADAP : coefficient applied to the HM21 adaptative mixing length
LTURB_FLX : flag to compute and store all the turbulent fluxes on every output synchronous file.
LTURB_DIAG : flag to store diagnostic quantities related to the turbulent scheme on every output synchronous file. (mesh length, Prandtl number, Schmidt number, sources of TKEldots)
LSIG_CONV : Flag for computing Sigma_s due to convection in ice subgrid condensation scheme
LRMC01 : Flag for computing separate mixing and dissipative length in the SBL according to Redelsperger et al. [2001]
CTOM : Consideration of Third Order Moments.
- ‘NONE’: No Third Order moments
- ‘TM06’: Parameterization of Third Order moments of heat fluxes for dry CBL according to Tomas and Masson [2006].
XTKEMIN : minimum value for the TKE ($m^{2}.s^{-2}$).
XCED : Constant for TKE dissipation (with CTURBLEN=’RM17’ it is better to use XCED=0.34 according to Rodier et al. [2017]).
LLEONARD : Flag to compute the Leonard terms (instead of K-gradient terms) applied to the vertical fluxes of $\theta_l$ and $r_{np}$ ($r_c$ + $r_i$ + $r_v$). The main effects are an increase of TKE and a decrease of vertical velocity.
XCOEFHGRADTHL : coefficient applied to the vertical turbulent flux of $\theta_l$.
XCOEFHGRADRM : coefficient applied to the vertical turbulent flux of non precipitating total water mixing ratio $r_{np}$.
XALTHGRAD : height above ground from which the Leonard terms are applied.
XCLDTHOLD : mixing ratios threshold ($r_c + r_i$) from which the Leonard terms are applied. For instance, XCLDTHOLD $10^{-6}$ kg/kg to apply only on clouds. XCLDTHOLD=-1 to apply everywhere.
LCLOUDMODIFLM : model number where the modification of the mixing length in the clouds is computed.
CTURBLEN_CLOUD : type of turbulent mixing length in the clouds (‘BL89’,’DELT’,’DEAR’: see CTURBLEN for meanings),
XCOEF_AMPL_SAT : saturation of the amplification coefficient,
XCEI_MIN : minimum threshold for the instability index (in kg/kg/m/s, beginning of the amplication),
XCEI_MAX : maximum threshold for the instability index (in kg/kg/m/s, beginning of the saturation of the amplification).
XCTP : Constant for temperature and vapor pressure-correlations (if not defined, the value depends on LSTATNW)
XMINSIGS : minimum value of the variance of the deficit to the saturation out of the turbulence scheme $kg^2.kg^{-2}$)
LHARAT : flag to activate the RACMO turbulence scheme
LPROJQITURB : flag to project the $r_t$ tendency on $r_c$ and $r_i$
LSMOOTH_PRANDTL : flag to smooth the Prandtl functions
NTURBSPLIT : number of time-splitting for the computation of horizontal turbulent fluxes
LTURB_PRECIP : flag to activate the turbulent mixing of mixing ratios of snow, graupel, hail and liquid droplets $r_s$, $r_g$, $r_h$, and $r_r$
LGOGER: true to compute the Goger terms
XSMAG: dimensionless Smagorinsky constant
LDYNMF: true to take into account a dynamical TKE production from EDMF
LTHERMMF: true to take into account a buoyancy TKE production from EDMF
LBL89TOP: true to limit BL89/RM17 at PBL top (as in ARPEGE)
LBL89EXP: true to use the exposant from the BL89 paper ( which is LOG(16.)/(4.*LOG(XKARMAN)+LOG(XCED)-3.*LOG(XCMFS))). Otherwise 2./3. (False in AROME cycl 50t1)
LLEMARIE21: true to use Lemarie et al. 2021 constant in DELT/DEAR mixing length ($0.5^{-6/7}$ instead of $0.5^{-1.5}$)

Note

Diagnostic quantities are written on every synchronuous files (mixing length in clear sky, mixing length modified, amplification coefficient, …) if LTURB_DIAG=.TRUE. in NAM_TURBn.

NAM_VISC

NAM_VISC content
Fortran name	Fortran type	Default value
LVISC	LOGICAL	.FALSE.
LVISC_UVW	LOGICAL	.FALSE.
LVISC_TH	LOGICAL	.FALSE.
LVISC_SV	LOGICAL	.FALSE.
LVISC_R	LOGICAL	.FALSE.
XMU_V	REAL	0.0
XPRANDTL	REAL	0.0

LVISC : Viscosity activation
LVISC_UVW : viscosity for the momentum
LVISC_TH : viscosity for the potential temperature
LVISC_SV : viscosity for the scalar tracer
LVISC_R : viscosity for the moisture
XMU_V : Molecular (cinematic) viscosity
XPRANDTL : Prandtl number

NAM_FLAKEn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_FLAKEn content
Fortran name	Fortran type	Default value
LSEDIMENTS	LOGICAL	.TRUE.
CSNOW_FLK	CHARACTER(LEN=3)	‘DEF’
CFLK_FLUX	CHARACTER(LEN=3)	‘DEF’
CFLK_ALB	CHARACTER(LEN=4)	‘DEF’
LSKINTEMP	LOGICAL	.FALSE.

LSEDIMENTS : to use the bottom sediments scheme of Flake (default)
CSNOW_FLK : snow scheme to be used. For the time being only option ‘DEF’ is active
CFLK_FLUX : scheme to be used to compute surface fluxes of moment, energy and water vapor:
- ‘DEF’ : to activate the classic watflux
- ‘FLAKE’ : to use flake parameterization
CFLK_ALB : type of albedo for FLake.
- ‘UNIF’ : a uniform value of 0.135 is used for water albedo
- ‘TA96’ : Taylor et al. [1996] formula for water direct albedo, depending on solar zenith angle
- ‘MK10’ : albedo from Marat Khairoutdinov
LSKINTEMP : flag to use or not the skin temperature computation.

NAM_ISBAn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_ISBAn content
Fortran name	Fortran type	Default value
CC1DRY	CHARACTER(LEN=4)	‘DEF’
CSCOND	CHARACTER(LEN=4)	‘PL98’
CSOILFRZ	CHARACTER(LEN=3)	‘DEF’
CDIFSFCOND	CHARACTER(LEN=4)	‘DEF’
CSNOWRES	CHARACTER(LEN=3)	‘DEF’
CCPSURF	CHARACTER(LEN=3)	‘DRY’
CZ0HEAT	CHARACTER(LEN=3)	‘DEF’
XTSTEP	REAL	none
XCVHEATF	REAL	0.20
XCGMAX	REAL	2.E-5
XCDRAG	REAL	0.15
XZ0HEAT	REAL	0.0
LGLACIER	LOGICAL	.FALSE.
LCANOPY_DRAG	LOGICAL	.FALSE.
LVEGUPD	LOGICAL	.TRUE.
LPERTSURF	LOGICAL	.TRUE.

CC1DRY : type of C1 formulation for dry soils. The following options are currently available:
- ‘DEF’ : Giard-Bazile formulation
- ‘GB93’ : Giordani 1993, Braud 1993
CSCOND : type of thermal conductivity. The following options are currently available:
- ‘NP89’ : Noilhan and Planton (1989) formula
- ‘PL98’ : Peters-Lidard et al. (1998) formula
CSOILFRZ : type of soil freezing-physics option. The following options are currently available:
- ‘DEF’ : Boone et al. 2000; Giard and Bazile 2000
- ‘LWT’ : Phase changes as above, but relation between unfrozen water and temperature considered
CDIFSFCOND : type of Mulch effects. The following options are currently available:
- ‘DEF’ : no mulch effect
- ‘MLCH’ : include the insulating effect of leaf litter/mulch on the surf. thermal cond.
CSNOWRES : type of turbulent exchanges over snow. The following options are currently available:
- ‘DEF’ : Louis
- ‘RIL’ : Maximum Richardson number limit for stable conditions ISBA-SNOW3L turbulent exchange option
- ‘M98’ : Martin et Lejeune 1998: older computation for turbulent fluxes coefficents in Crocus
CZ0HEAT : roughness length for heat
CCPSURF : type of specific heat at surface. The following options are currently available:
- ‘DRY’ : specific heat does not depend on humidity at surface
- ‘HUM’ : specific heat depends on humidity at surface.
XTSTEP : time step for ISBA. Default is to use the time-step given by the atmospheric coupling (seconds).
XCVHEATF : Modify Cv to compensate biases in ground temperature
XCGMAX : maximum value for soil heat capacity.
XCDRAG : drag coefficient in canopy.
XZ0HEAT : factor to calculate Z0H when CZ0HEAT=”Z95”
LGLACIER : If activated, specific treatment (as in Arpege) over permanent snow/ice regions. Snow depth initialised to 10m and soil ice to porosity. During the run, snow albedo ranges from 0.8 to 0.85
LCANOPY_DRAG : drag activated in SBL scheme within the canopy
LVEGUPD : True = update vegetation parameters every decade
LPERTSURF : if T modification of surface fluxes for ensemble forecasting

NAM_SURF_DUST

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_SURF_DUST content
Fortran name	Fortran type	Default value
CEMISPARAM_DST	CHARACTER(LEN=5)	‘AMMA’
CVERMOD	CHARACTER(LEN=6)	‘NONE’
XFLX_MSS_FDG_FCT	REAL	12.0e-4

CEMISPARAM_DST : One-line dust emission parameterization type. This namelist gives the distribution of emitted dust of SURFEX. For Each paramterization type, a geometric standard deviation and a median radius is given. Moreover , the repatition of mass flux could be derive from the friction velocity (case of “AMMA” or “EXPLI”) or imposed (case of “Dal87”, “alf98”, “She84” or “PaG77”. See the code init_dstn.f90 (Meso-NH) or init_dstn.mnh (AROME, ALADIN) for values associated to these parameterizations. Note that if the defaut value is change, it is necessary to uses the same modes in the dust initialisation in the atmospheric model. It concerns the value of XINIRADIUS (initial radius), XINISIG (standard deviation) and CRGUNITD (mean radius definition) to have the same aerosol size distribution emitted and in the atmosphere. It is possible to do it directly in the fortran code (modd_dust.mnh in case of aladin/arome, modd_dust.f90 for Meso-NH) or for Meso-NH only, change the values of these variables in NAM_AERO_CONF (PREP_REAL_CASE or PREP_IDEAL_CASE).
CVERMOD : New parameterization of the dust emission formulation. In development, not recommended to uses it in this version.
XFLX_MSS_FDG_FCT : Value of the $\alpha$ factor representing the ratio of the vertical mass flux over the horizontal mass flux in the saltation layer (use only If CVERMOD=’NONE’). This $\alpha$ factor depend on the size distribution of the aerosol consider in the model.

NAM_IDEAL_FLUX

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_IDEAL_FLUX content
Fortran name	Fortran type	Default value
NFORCF	INTEGER	2 ($\leq$ 48)
NFORCT	INTEGER	2 ($\leq$ 48)
XTIMEF	REAL(NFORCF)	0
XTIMET	REAL(NFORCT)	0
XSFTH	REAL(NFORCF)	0.0
CSFTQ	CHARACTER(LEN=7)	‘kg/m2/s’
XSFTQ	REAL(NFORCF)	0.0
XSFCO2	REAL(NFORCF)
CUSTARTYPE	CHARACTER(LEN=5)	‘Z0’
XUSTAR	REAL(NFORCF)	0.0
XZ0	REAL	0.01
XALB	REAL
XEMIS	REAL	1.0
XTSRAD	REAL(NFORCT)	XTT=273.15K

NFORCF : number of surface forcing instants for fluxes since the beginning of the run. The default value is NFORC=2.
NFORCT : number of surface forcing instants for radiative temperature since the beginning of the run. The default value is NFORC=2.
XTIMEF : times of forcing for fluxes (from beginning of run)
XTIMET : times of forcing for temperature (from beginning of run)
XSFTH : hourly data of heat surface flux (W/m2)
CSFTQ : Unit for the evaporation flux (kg/m2/s) or (W/m2)
XSFTQ : hourly data of water vapor surface flux
XSFCO2 : hourly data of CO2 surface flux (kgC02/kg air * m/s)
CUSTARTYPE : type of computation for friction
XUSTAR : hourly data of friction (m2/s2)
XZ0 : roughness length (m)
XALB : albedo (-)
XEMIS : emissivity (-)
XTSRAD : radiative temperature (K)

NAM_TEBn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_TEBn content
Fortran name	Fortran type	Default value
CZ0H	CHARACTER(LEN=6)	‘KAND07’
CCH_BEM	CHARACTER(LEN=5)	‘DOE-2’
CURB_LM	CHARACTER(LEN=4)	‘LMEZ’
CZ0EFF_GD	CHARACTER(LEN=4)	‘NONE’

CZ0H : TEB option for z0h roof and road:
- ‘MASC95’ : Mascart et al 1995
- ‘BRUT82’ : Brustaert 1982
- ‘KAND07’ : Kanda 2007
CCH_BEM : BEM option for roof / wall outside convective coefficient :
- ‘DOE-2’ : DOE-2 model from EnergyPlus Engineering reference, p65
CURB_LM : option to compute urban mixing length
- ‘SM10’ : Urban mixing lenght is calculated following Santiago and Martili (2010).
- ‘LMEZ’ : Urban mixing lenght is equaal to height above ground. Default is LMEZ.
CZ0EFF_GD : TEB option for effective roughness length for low urban vegetation
- ‘LR21’ : Lemonsu, Redon et al 2021
- ‘NONE’ : only vegetation roughness length is used, not taking into account the environment

NAM_CH_CONTROLn

Chemical settings control.

NAM_CH_CONTROLn content
Fortran name	Fortran type	Default value
CCHEM_SURF_FILE	CHARACTER(LEN=28)

CCHEM_SURF_FILE: name of general chemical ASCII input file. Whatever the choice for the type of calculation of the emissions (either by mapping of emissions at different times CCH_EMIS=’AGGR’ or computation by SNAPs, CCH_EMIS=’SNAP’), the user needs to define :
- how to do the translation: from the emitted chemical species that are in the inventory to the chemical species that are emitted to the atmospheric chemical scheme (that of course are usually not the same)
- the information for the deposition scheme basic information on the chemical species (example: molar mass)

This translation is done in an ASCII file that contains a lot of information on the chemical schemes. This file should be done by an expert in air chemistry, that also has knowledge on the inventories. Here is an example of this file, for only two chemical species (CO2 and CO) :

================================================================
*** the following section will be used by ch_init_emissionn.f90 ***
================================================================
EMISDATA
emission fluxes (in nMole/m2/day) from SHIP data DMS(flux) = 1.7 nmol/m2/d
MOL
1 species
1 records
DMS
(F10.0,/,99(5E10.2))
0.
1.7
================================================================
*** the following section will be used by ch_init_emissionn.F90 and ch_init_snapn.F90 ***
================================================================
EMISUNIT
Emission Stut. Univ. EUROPE 10KM
MIX
AGREGATION
Schema reduit ReLACS
CO2 1.0 CO2
END_AGREGATION
=====================================================================
*** the following section will be read by ch_init_dep_isban.F90 ***
=====================================================================
SURF_RES
surface resistances (s/m), refer to Seinfeld and Pandis, 1998, p. 975, Tab.19.2
1
(1X,A12,1X,F7.1)
'NONE' 2500.1
=====================================================================
*** the following section will be read by ch_init_depconst.F90 ***
=====================================================================
MASS_MOL
molecular mass (in g/mol) for molecular diffusion, from Stockwell et al., 1997
2
(1X,A12,1X,F11.3)
'CO2' 44.000
'CO' 28.000
REA_FACT
reactivity factor with biology, Seinfeld and Pandis, 1998, p. 975, Tab. 19.3
2
(1X,A12,1X,F4.1)
'CO2' 0.0
'CO' 0.0
HENRY_SP
Henry specific constant, CO2 according to Seinfeld p347
2
(1X,A12,1X,E18.2,1X,F8.0)
'CO2' 3.40E-2 0.
'CO' 9.50E-4 -1300.

NAM_CH_SURFn

Chemical anthropogenic emissions.

NAM_CH_SURFn content
Fortran name	Fortran type	Default value
LCH_SURF_EMIS	LOGICAL	.FALSE.

LCH_SURF_EMIS : flag to use anthropogenic emissions or not.

NAM_CH_SEAFLUXn

Chemical deposition over sea/ocean.

NAM_CH_SEAFLUXn content
Fortran name	Fortran type	Default value
CCH_DRY_DEP	CHARACTER(LEN=6)	‘WES89’

CCH_DRY_DEP : type of deposition scheme.
- ‘NONE’ : no chemical deposition scheme.
- ‘WES89’ : Wesely [1989] deposition scheme.

NAM_CH_WATFLUXn

NAM_CH_WATFLUXn content
Fortran name	Fortran type	Default value
CCH_DRY_DEP	CHARACTER(LEN=6)	‘WES89’

CCH_DRY_DEP : type of deposition scheme.
- ‘NONE’ : no chemical deposition scheme.
- ‘WES89’ : Wesely [1989] deposition scheme.

NAM_CH_FLAKEn

NAM_CH_FLAKEn content
Fortran name	Fortran type	Default value
CCH_DRY_DEP	CHARACTER(LEN=6)	‘WES89’

CCH_DRY_DEP : deposition scheme (‘WES89’: Wesley method)

NAM_CH_TEBn

Chemical deposition over towns.

NAM_CH_TEBn content
Fortran name	Fortran type	Default value
CCH_DRY_DEP	CHARACTER(LEN=6)	‘WES89’

CCH_DRY_DEP : type of deposition scheme.
- ‘NONE’ : no chemical deposition scheme.
- ‘WES89’ : Wesely [1989] deposition scheme.

NAM_CH_ISBAn

Chemical deposition and biogenic emissions over vegetation.

NAM_CH_ISBAn content
Fortran name	Fortran type	Default value
CCH_DRY_DEP	CHARACTER(LEN=6)	‘WES89’
LCH_BIO_FLUX	LOGICAL	.FALSE.
LCH_NO_FLUX	LOGICAL	.FALSE.

CCH_DRY_DEP : type of deposition scheme.
- ‘NONE’ : no chemical deposition scheme.
- ‘WES89’ : Wesely [1989] deposition scheme.
LCH_BIO_FLUX : flag to activate the biogenic emissions.
LCH_NO_FLUX : flag to activate the NO emissions.

NAM_CHS_ORILAM

Chemical aerosol scheme ORILAM.

NAM_CHS_ORILAM content
Fortran name	Fortran type	Default value
LCH_AERO_FLUX	LOGICAL	.FALSE.
LCO2PM	LOGICAL	.FALSE.
XEMISRADIUSI	REAL	0.036
XEMISRADIUSJ	REAL	0.385
XEMISSIGI	REAL	1.86
XEMISSIGJ	REAL	1.29
CRGUNIT	CHARACTER(LEN=4)	‘NUMB’

LCH_AERO_FLUX : switch to active aerosol surface flux for ORILAM
LCO2PM : switch to activate emission of primary aerosol (Black and Organic carbon) compute from CO emssion. Uses only if CO emission is defined in the surface field (see PREP_PGD) and if there is no data for primary aerosol emissison.
XEMISRADIUSI : Aerosol flux, mean radius of aitken mode in $mu$ m (only if LCH_AERO_FLUX=T).
XEMISRADIUSJ : Aerosol flux, mean radius of accumulation mode in $mu$ m (only if LCH_AERO_FLUX=T).
XEMISSIGI : Aerosol flux, standard deviation of aitken mode in $mu$ m (only if LCH_AERO_FLUX=T).
XEMISSIGJ : Aerosol flux, standard deviation of accumulation mode in $mu$ m (only if LCH_AERO_FLUX=T).
CRGUNIT : Aerosol flux, Definition of XEMISRADIUSI or XEMISRADIUSJ: mean radius can be define in mass (“MASS”) or in number (NUMB).

NAM_DEEPSOIL

NAM_DEEPSOIL content
Fortran name	Fortran type	Default value
LDEEPSOIL	LOGICAL	F
LPHYSDOMC	LOGICAL	F

LDEEPSOIL : General switch for deep soil fields (temperature and relaxation time).
LPHYSDOMC : General switch to impose CT and soil water/ice contents

NAM_DIAG_SURF_ATMn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

Diagnostics relative to each grid cell.

NAM_DIAG_SURF_ATMn content
Fortran name	Fortran type	Default value
LFRAC	LOGICAL	.FALSE.
LDIAG_GRID	LOGICAL	.FALSE.
LT2MMW	LOGICAL	.FALSE.
LDIAG_MIP	LOGICAL	.FALSE.

LFRAC : flag to save in the output file the sea, inland water, natural covers and town fractions.
LDIAG_GRID : flag for mean grid diagnostics
LT2MMW : alternative weighting of grid average T2M giving more weight to the land tile.
LDIAG_MIP : flag to perform intercomparison of land surface model diagnostics as required by several MIP (such as CMIP, SnowMIP, GCP, GSWP, etc.). These diag are only implemented for general surf atm diags, seaflux, Flake and ISBA.

NAM_DIAG_SURFn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

Diagnostics for each grid cell and each tile.

NAM_DIAG_SURFN content
Fortran name	Fortran type	Default value
N2M	INTEGER	2
LSURF_BUDGET	LOGICAL	.FALSE.
LSURF_BUDGETC	LOGICAL	.FALSE.
LRESET_BUDGETC	LOGICAL	.FALSE.
LRAD_BUDGET	LOGICAL	.FALSE.
LCOEF	LOGICAL	.FALSE.
LSURF_VARS	LOGICAL	.FALSE.
L2M_MIN_ZS	LOGICAL	.FALSE.

N2M : flag to compute surface boundary layer characteristics:
- N2M=2 : computes temperature at 2 m, specific humidity at 2 m, relative humidity, zonal and meridian wind at 10 m, and Richardson number. 2m and 10m quantities are calculated interpolating between atmospheric forcing variables and surface temperature and humidity.
LSURF_BUDGET : flag to save in the output file the terms of the surface energy balance (net radiation, sensible heat flux, latent heat flux, ground flux), for each scheme (on the four separate tiles), on each patch of the vegetation scheme if existing, and aggregated for the whole surface. The diagnosed fields are (* stands for the scheme considered (* = nothing: gfield aggregated on the whole surface; * = name of a scheme : field for this scheme):
- RN_*: net radiation
- H_*: turbulent sensible heat flux
- LE_*: turbulent latent heat flux
- GFLUX_*: round or storage heat flux
- FMU_*: zonal wind stress
- FMV_*: meridian wind stress

Note

If both LSURF_BUDGET and LRAD_BUDGET are T then downward and upward short-wave radiation per spectral band will be written into output file (they are computed even if LRAD_BUDGET is False). The following output fields are then available:

SWD_*: downward short wave radiation

SWU_*: upward short wave radiation

SWBD_*: downward short wave radiation for each spectral band

SWBU_*: upward short wave radiation for each spectral band

LWD_*: downward long wave radiation

LWU_*: upward long wave radiation

LSURF_BUDGETC : flag to save in the output file the time integrated values of all budget terms that have been activated
LRESET_BUDGETC : flag to reset cumulatives variables at the beginning of a run
LCOEF : flag to save in the output file the transfer coefficients used in the computation of the surface energy fluxes, for each scheme (on the four separate tiles) and aggregated for the whole surface. The diagnosed fields are (* stands for the scheme considered * = nothing: field aggregated on the whole surface; * = name of a scheme : field for this scheme):
- CD_*: gdrag coefficient for momentum
- CH_*: gdrag coefficient for heat
- CE_*: gdrag coefficient for evaporation (differs from CH only over sea)
- Z0_*: groughness length
- Z0H_*: gthermal roughness length
LSURF_VARS : flag to save in the output file the surface specific humidity for each scheme (on the four separate tiles), on each patch of the vegetation scheme if existing. The diagnosed fields are (* stands for the scheme considered (* = nothing: gfield aggregated on the whole surface; * = name of a scheme :< field for this scheme):
- QS_*: specific humidity
L2M_MIN_ZS : flag for 2 meters quantities evaluated on the minimum orography of the grid

NAM_DIAG_ISBAn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

ISBA diagnostics.

NAM_DIAG_ISBAn content
Fortran name	Fortran type	Default value
LPGD	LOGICAL	.FALSE.
LSURF_EVAP_BUDGET	LOGICAL	.FALSE.
LSURF_MISC_BUDGET	LOGICAL	.FALSE.
LSURF_DIAG_ALBEDO	LOGICAL	.FALSE.
LPATCH_BUDGET	LOGICAL	.TRUE.
LSURF_MISC_DIF	LOGICAL	.FALSE.
LWATER_BUDGET	LOGICAL	.FALSE.
LLUTILES_BUDGET	LOGICAL	.FALSE.
LPROSNOW	LOGICAL	.FALSE.
LPROBANDS	LOGICAL	.FALSE.
LVOLUMETRIC_SNOWLIQ	LOGICAL	.FALSE.
LUTCI	LOGICAL	.FALSE.

LPGD : flag to save in the output file the physiographic fields of ISBA scheme that are computed from ecoclimap data from the ecosystem fractions.
LSURF_EVAP_BUDGET : flag to save in the output file the detailed terms of the water vapor fluxes, on each patch of the vegetation scheme if existing, and aggregated for the natural surface. The diagnosed fields are:
- GPP: Gross primary production
LSURF_MISC_BUDGET : flag to save in the output file miscelleaneous fields. The diagnosed fields are:
- HV: Halstead coefficient
- SNG: snow fraction over bare ground
- SNV: snow fraction over vegetation
- SN: total snow fraction
- SWI: soil wetness index for each ground layer (wg - wwilt)/(wfc - wwilt) where wg is the volumic water content, wfc is the porosity and wwilt corresponds to the plant wilting point.
LSURF_DIAG_ALBEDO : to write ALB…_ISBA et ALB…_S.
LPATCH_BUDGET : flag to save in the output file the diagnostics for each patch (default is .T.)
LSURF_MISC_DIF : to calculate and write specific DIF diagnostics
LWATER_BUDGET : to calculate and write the water budget
LLUTILES_BUDGET : flag to bring together diag from the ISBA patches into 4 surface covers type required for land-use-land-cover purpose (not implemented for ECOCLIMAP-SG) :
- 1. Primary and secondary natural land (Forest, grassland, bare ground, etc.)
- 1. Cropland (Agriculture)
- 1. Pastureland (not yet implemented in ISBA)
- 1. Urban settlement (not yet implemented; should be implemented if TEB is used).
LPROSNOW : add new diagnostic fields for the CROCUS snow scheme, reproject the snow mantel and other diagnostic fields on the vertical, according to the subgrid slope, and merges ISBA_PROGNOSTIC.OUT.nc and ISBA_DIAGNOSTICS.OUT.nc in ISBA_PROGNOSTIC.OUT.nc, in case of CTIMESERIES_FILETYPE = ‘OFFLIN’.
LPROBANDS : enable the spectral resolution of Crocus diagnostics, necessary if you want to get spectral albedo and spectral direct/diffuse ratio diagnostics
LVOLUMETRIC_SNOWLIQ: convert the SNOWLIQ diagnostic field in kg / m3 (instead of m).
LUTCI : flag to compute UTCI (human thermal comfort indicator) quantities in rural areas

NAM_DIAG_TEBn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

TEB diagnostics.

NAM_DIAG_TEBn content
Fortran name	Fortran type	Default value
LPGD	LOGICAL	.FALSE.
LSURF_MISC_BUDGET	LOGICAL	.FALSE.
LSURF_DIAG_ALBEDO	LOGICAL	.FALSE.
LUTCI	LOGICAL	.FALSE.

LPGD : flag to save PGD fields if TEB garden is activated
LSURF_MISC_BUDGET : flag to save in the output file miscelleaneous fields. The diagnosed fields are:
- Z0_TOWN: roughness length for town
- QF_BLD: domestic heating
- QF_BLDWFR: domestic heating
- FLX_BLD: heat flux from bld
- TI_BLD_EQ: internal temperature without heating
- TI_BLDWFR: internal temperature without heating
- QF_TOWN: total anthropogenic heat
- DQS_TOWN: storage inside building
- H_WALL: wall sensible heat flux
- H_ROOF: roof sensible heat flux
- H_ROAD: road sensible heat flux
- RN_WALL: net radiation at wall
- RN_ROOF: net radiation at roof
- RN_ROAD: net radiation at road
- GFLUX_WALL: net wall conduction flux
- GFLUX_ROOF: net roof conduction flux
- GFLUX_ROAD: net road conduction flux
- LE_ROOF: roof latent heat flux
- LE_ROAD: road latent heat flux
LSURF_DIAG_ALBEDO : flag to save in the output file albedo diagnostics
LUTCI : to calculate and write UTCI diagnostics

NAM_DIAG_FLAKEn

NAM_DIAG_FLAKEn content
Fortran name	Fortran type	Default value
LWATER_PROFILE	LOGICAL	F
XZWAT_PROFILE	REAL
LSEDIM_PROFILE	LOGICAL	F
XZSED_PROFILE	REAL
LFLKFLUX	LOGICAL	F
LFLKWATER	LOGICAL	F

LWATER_PROFILE : flag to save in the output file miscelleaneous fields. The diagnostic is temperature at the depths defined by:
XZWAT _PROFILE : depth of output levels (m) in namelist
LSEDIM_PROFILE : flag for sediment diagnostics
XZSED_PROFILE : depth of output levels (m) in namelist
LFLKFLUX : flag for heat and radiative diagnostics
LFLKWATER : flag for water budget P-E diagnostics

NAM_DIAG_OCEANn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_DIAG_OCEANn content
Fortran name	Fortran type	Default value
LDIAG_OCEAN	LOGICAL	.FALSE.

LDIAG_OCEAN : flag for ocean variables

NAM_AGRI

NAM_AGRI content
Fortran name	Fortran type	Default value
LAGRIP	LOGICAL	F
LIRRIGMODE	LOGICAL	F
XTHRESHOLD	REAL(4)	(/0.70,0.55,0.40,0.25/)
NVEG_IRR	INTEGER	6
NPATCH_TREE	INTEGER	none
NIRR_STOP_BTR	INTEGER	14 (days)

LAGRIP : General switch for agricultural practices (seeding and irrigation)
LIRRIGMODE : flag to activate irrigation. With LAGRIP and/or LIRRIGMODE, if ECOCLIMAP-SG is activated (LECOSG = T in namelist NAM_FRAC) the vegetation types associated (define with NUNIF_VEG_IRR_USE, see NAM_DATA_ISBA ) are duplicated. In this case, NPATCH (from namelist NAM_ISBA) have to be adapted to indicate how many patch are finally considered (with default irrigated vegetation type, is currently 2, 4, 5, 10, 12, 14, 15, 19 or 26). Then, by default you need nothing more without ECOCLIMAP-SG. With ECOCLIMAP-SG it is extremely recommended to use the map provided with ECOCLIMAP-SG forcing (cf CFNAM_IRRIGFRAC and CFTYP_IRRIGFRAC in namelist NAM_DATA_ISBA).
XTHRESHOLD : if LIRRIGMODE is activated, XTHRESHOLD is the 4 successive stage threshold to trigger the irrigation. It can be overwrite by more specific values in the namelist NAM_DATA_ISBA.
NVEG_IRR : if LAGRIP or/and LIRRIGMODE are activated, correspond to the number of patch irrigated or/and with agricultural practices. The default value is 6 with ECOCLIMAP-SG and LIRRIGMODE, 0 without ECOCLIMAP-SG. NB if you indicate 0, the default value is used.
NPATCH_TREE : with ECOCLIMAP-SG and if LAGRIP or/and LIRRIGMODE are activated, correspond to the tree patch distribution without irrigation. By default (if default values of NVEG_IRR and NVEG_IRR_USE are used) it takes automatically a value corresponding to NPATCH, else the value of patch tree without irrigation use has to be indicated (1, 2, 3, 7, 9, 10, 12, 13 or 20).
NIRR_STOP_BTR : Number of days corresponding to the time when the irrigation stop before reaping.

NAM_ISBA_AGSn

NAM_ISBA_AGSn content
Fortran name	Fortran type	Default value
CNITRO_DILU	LOGICAL	‘NONE’
LDOWNREGU	LOGICAL	F
XCNLIM	REAL	-0.048

CNITRO_DILU : this key activates a parameterization based on eq. 6 of Yin (2002) that modifies the leaf nitrogen content (CNA_NITRO), and hence the specific leaf area, according to the atmospheric CO$_{2}$ concentration.
- ‘NONE’ : No nitrogen dilution (CNA_NITRO stays constant)
- ‘CA08’ : Eq. 6 of Yin (2002) but simplified as described in Calvet et al, 2008
- ‘ESM2’ : Eq. 6 of Yin (2002) and simplified as Calvet et al 2008 but taking into account the temperature term of eq 6. of Yin. When using CNITRO_DILU = ‘ESM2’, LDOWNREGU has to be set to TRUE.
LDOWNREGU : downregulation parameterization of CO$_{2}$ assimilation for CPHOTO=NCB option. Change in light-use efficiency for carbon assimilation with elevated CO$_{2}$ concentration.
XCNLIM : carbon nitrogen limitation parameter used in both the LNITRO_DILU and the LDOWNREGU options

NAM_ISBA_CCn

NAM_ISBA_CCn content
Fortran name	Fortran type	Default value
LSPINUPCARBS	LOGICAL	F
XSPINMAXS	REAL
NNBYEARSPINS	INTEGER	0
XMISSFCO2	REAL	0.0
LFIRE	LOGICAL	F
LCLEACH	LOGICAL	F
LADVECT_SOC	LOGICAL	F
LCRYOTURB	LOGICAL	F
LBIOTURB	LOGICAL	F

LSPINUPCARBS : if T, to do the soil carbon spinup
XSPINMAXS : This key defines the spinup time step as the increase of the physical time step by a factor equal to XSPINMAXS. So, if the physical (isba time step) = 300s and XSPINMAXS = 50, then the carbon spinup time step = 15000s.
NNBYEARSPINS : number of years needed to reach soil equilibrium (spinup time step is at its maximum during 80% of the defined NNBYEARSPINS, then decrease linearly to reach the physical time step). So, if XSPINMAXS = 50 and NNBYEARSPINS =250, the spinup procedure is at maximum during 200 physical years representing 200x50 = 10 000 carbon years.
XMISSFCO2 : Missing carbon flux (cf. anthropic) required for ESM coupling in emission mode (default = 0.)
LFIRE : flag to activate simple biomass fire module
LCLEACH : flag to activate soil carbon leaching that produce dissolved organic carbon that can be routed by CTRIP
LADVECT_SOC : flag to activate vertical advection scheme for soil dynamics carbon module, only if CRESPSL = DIF (in NAM_PREP_ISBA_CARBON)
LCRYOTURB : flag to activate vertical cryoturbation scheme if CRESPSL = DIF (in \
LBIOTURB : flag to activate vertical bioturbation scheme if CRESPSL = DIF (in \

NAM_ISBA_NUDGINGn

NAM_ISBA_NUDGINGn content
Fortran name	Fortran type	Default value
LNUDG_SWE	LOGICAL	F
LNUDG_SWE_MASK	LOGICAL	F
XTRELAX_SWE	REAL
CNUDG_WG	CHARACTER(LEN=3)	‘DEF’
LNUDG_WG_MASK	LOGICAL	F
XTRELAX_WG	REAL
XNUDG_Z_WG	REAL	1.0

LNUDG_SWE : flag to activate the snow’s nudging
LNUDG_SWE_MASK : flag to restric the snow nudging to a given region, that is the nudging can be only regional
XTRELAX_SWE : relaxation time for the snow’s nudging (in s)
CNUDG_WG : key to activate the soil water’s nudging
- ‘DEF’ : no nudging (Default)
- ‘DAY’: daily nudging
- ‘MTH’: monthly nudging
LNUDG_WG_MASK : flag to restric the soil water’s nudging to a given region, that is the nudging can be only regional
XTRELAX_WG : relaxation time for the soil water’s nudging (in s)
XNUDG_Z_WG : vertical profile for the soil water’s nudging (Default = 1.0 for each soil layers).

NAM_ISBA_SNOWn

NAM_ISBA_SNOWn content
Fortran name	Fortran type	Default value
CSNOWDRIFT	CHARACTER(LEN=4)	‘DFLT’
LSNOWDRIFT_SUBLIM	LOGICAL	F
LSNOW_ABS_ZENITH	LOGICAL	F
CSNOWMETAMO	CHARACTER(LEN=3)	‘B92’
CSNOWMOB	CHARACTER(LEN=4)	‘GM98’
CSNOWRAD	CHARACTER(LEN=3)	‘B92’
LATMORAD	LOGICAL	F
LSNOWSYTRON	LOGICAL	F
CSNOWFALL	CHARACTER(LEN=3)	‘V12’
CSNOWCOND	CHARACTER(LEN=3)	‘Y81’
CSNOWHOLD	CHARACTER(LEN=3)	‘B92’
CSNOWCOMP	CHARACTER(LEN=3)	‘B92’
CSNOWZREF	CHARACTER(LEN=3)	‘CST’
LSNOWCOMPACT_BOOL	LOGICAL	F
LSNOWMAK_BOOL	LOGICAL	F
LSNOWMAK_PROP	LOGICAL	F
LSNOWTILLER	LOGICAL	F
LSELF_PROD	LOGICAL	F
LSNOWPAPPUS	LOGICAL	F
CSNOWPAPPUSERODEPO	CHARACTER(LEN=3)	‘DIV’
CSNOWFPAPPUS	CHARACTER(LEN=4)	‘NONE’
CPAPPUSSUBLI	CHARACTER(LEN=4)	‘NONE’
CSALTPAPPUS	CHARACTER(LEN=3)	‘P90’
CLIMVFALL	CHARACTER(LEN=4)	‘MIXT’
OPAPPULIMTFLUX	LOGICAL	F
OPAPPUDEBUG	LOGICAL	F

CSNOWDRIFT : key to activate the snowdrift scheme, with 4 possible values
- NONE: snowdrift scheme disactivated (equivalent to LSNOWDRIFT=F in SURFEX V8.1)
- DFLT: Default snowdrift scheme activated, properties of falling snow are purely dendritic (equivalent to LSNOWDRIFT = T in SURFEX V8.1)
- VI13: Properties of falling snow are taken from Vionnet et al. (2013)
- GA01: Properties of falling snow are taken from Gallée et al. (2001)
LSNOWDRIFT_SUBLIM : logical for snowdrift subliation
LSNOW_ABS_ZENITH : if T modify solar absorption as a function of solar zenithal angle (physically wrong but better results in polar regions when CSNOWRAD=B92)
CSNOWMETAMO : Scheme of snow metamorphism (Crocus)
- B92: obsolete option which will be removed in a next version. Historical version, Brun et al. 1992
- C13: Translation of B92 option in terms of Optical Diameter and spericity (Carmagnola et al 2014)
- T07: Experimental evolution law of optical diameter from Taillandier et al 2007
- F06: Evolution law of the optical diameter from Flanner et al 2006, which fitst the model outputs of a snow microstructure model representing the diffusive vapour fluxes among the grains.
- S-C: Experimental evolution law of Optical Diameter from Schleef et al, 2014 for the first 48 hours after snowfall, then C13 option.
- S-F: Experimental evolution law of Optical Diameter from Schleef et al, 2014 for the first 48 hours after snowfall, then F06 option.
CSNOWMOB : To choose the way threshold wind speed is computed in SnowPappus when surface snow age is superior to the threshold value XAGELIMPAPPUS
- GM98: (default) historical version, Guyomarc’h et Mérindol (1998), see SnowPappus description article
- CONS: threshold wind speed constant and equal to 9 m/s (at 5m height)
- VI12: parameterization described in Vionnet et al 2012
- LI07: parameterization as a function of density as described in Liston et al. 2007
- COGM: constant at 9 m/s if snow is non-dendritic, given by GM98 parameterization for dendritic snow
CSNOWRAD : radiative transfer scheme in snow (Crocus)
- B92: historical version, Brun et al. 1992 with empirical parameterization of ageing in the visible band (default)
- T17: 2 flow spectral scheme TARTES (Libois et al, 2013) with explicit impact of SSA, impurities, and zenithal angle on spectral reflectances. Increase computing time by a factor of 10. Require a careful setting of impurities deposition.
LATMORAD : key to activate atmotartes scheme
LSNOWSYTRON : to activate the blowing snow module SYTRON (Vionnet et al. 2018) which simulates erosion and accumulation between opposite slope aspects in the topographic-based geometry used by MF operational simulations for avalanche hazard forecasting. This option must be maintained to FALSE in all other simulation geometries. It is recommended to combine LSNOWSYTRON=T with CSNOWDRIFT=VI13 (better skill scores in terms of blowing snow occurrence)
CSNOWFALL : parametrization of falling snow compaction
- V12: function of air temperature and wind speed following Vionnet et al 2012 from experiments of Pahaut at Col de Porte (default)
- S14: function of air temperature and wind speed following Schmucki et al 2014, law used in the swiss SNOWPACK model
- A76: function of air temperature from Anderson, 1976 (law used in ISBA-ES)
- NZE: constant at 200 kg/m$^{3}$ for maritime climates (New Zealand)
CSNOWCOND : parameterization of snow thermal conductivity from snow density
- Y81: Yen et al 1981 (Default) from experimental values
- I02: rom ISBA-ES (Boone, 2002; Sun et al., 1999) The law depends not only on density but also on snow temperature and it has a higher conductivity than experimental values to indirectly compensate for the fact that latent heat fluxes due to vapour fluxes are not represented in the model. This is expected to increase vertical heat transfer as temperature increases.
CSNOWHOLD : parameterization of maximum liquid water holding capacity in the bucket parameterization
- B92: fixed maximal percentage of the pores’ volumes from Pahaut 1975
- SPK: parameterization of the swiss SNOWPACK model (Wever et al 2014) fitting the experiments of Coléou and Lesaffre (1998)
- B02: maximal liquid water mass fraction. This parameterization has an opposite behaviour: the higher the density, the higher the maximal volumetric liquid water content.
CSNOWCOMP : parameterization of snow compaction
- B92: visco-elastic model using a viscosity function of density and air temperature from Brun et al, 1992 (default)
- T11: visco-elastic model using a viscosity function of density and air temperature from Teufelsbauer (2011) fitting the data of separate experimental works
- S14: non-linear relationship between settlement, stress and SSA decrease due to metamorphism from Schleef et al. (2014) for the first 48 h after snowfall. Then, B92 option.
CSNOWZREF : Reference heights for temperature and wind can be modified depending on snow depth when CSNOWZREF==’VAR’
- CST: constant reference
- VAR: variable reference height from the snow surface (i.e. constant from the ground, snow depth has to be removed from reference height)
LSNOWCOMPACT_BOOL : Activate grooming if T. By default, grooming only applies if SWE > 20 kg/m$^{2}$ and between 20h and 21h (and also 6h-9h if there is some snowfall during the night)
LSNOWMAK_BOOL : Activate snowmaking By default, snowmaking only applies if the wind speed is < 10 km/h, during all the day during the period 01/11-15/12 and between 18h-8h during the period 15/12-31/03. During the first period (base-layer generation), the production is allowed until reaching a water consumption of 150 kg/m$^{2}$, according to an average water availability of = 1500 m$^{3}$/ha. During the second period (snowpack reinforcement), the production is allowed if the total (natural+machine-made) snow height is < 60 cm. Finally, a loss of 30% in the snow production process is applied in every condition.
LSNOWMAK_PROP : Activate machine made snow physical properties. The machine-made snow properties are set as follows: SSA = 23 m$^{2}$/kg, Sphericity = 0.9.
LSNOWTILLER : Switch for the activation of the tiller effect, which applies down to 35 kg/m$^{2}$ below the surface (F = no tiller effect, only compaction).
LSELF_PROD : Activate the control of snow production. If T, the production follows the pre-defined rules defined above (threshold of 150 kg/m$^{2}$ during the base-layer generation period, threshold of 60 cm during the snowpack reinforcement period).If F, the production is forced to match the pre-set production scheme defined by XPROD_SCHEME.
LSNOWPAPPUS : key to activate SnowPappus option.
CSNOWPAPPUSERODEPO : determines how the deposition flux is computed.
- ERO: pure erosion (can be used in point-scale simulation)
- DIV: erosion/deposition calculated (default option, needs 2D grid)
- DEP: pure deposition (can be used in point-scale simulation)
- NON: snowPappus diagnostics are computed but it does not adds or removes any snow (can be used in point-scale simulation)
CSNOWFPAPPUS : overcomes ‘CSNOWDRIFT’ to select falling snow microstructure.
- GM98: Guyomarc’h and Merindol 1998
- VI13: Vionnet 2013
- NONE: no effect, CSNOWDRIFT prevails (default)
CPAPPUSSUBLI : to choose different parameterizations of blowing snow sublimation rate in SnowPappus
- NONE: no sublimation in pappus transport scheme
- SBSM: SBSM (Simplified Blowing Snow Model) sublimation parametrisation from R. Essery,L. Li, and J. Pomeroy (1999)
- BJ10: Bintanja 1998 with 10m wind
- BJ03: Bintanja 1998 with 3m wind
- GR06: Gordon 2006 sublimation parameterization
CSALTPAPPUS : option for saltation transport in SnowPappus
- P90: saltation transport given by Pomeroy 1990 formulation
- S04: Sorensen 2004 / Vionnet 2012 formulation
CLIMVFALL : option to decide what is old or new snow for fall speed calculation
- DEND: fall speed of blowing snow particles is computed as old snow if snow is non-dendritic
- PREC: old snow = non-dendritic OR age < XAGELIMPAPPUS2
- MIXT: old snow for non-dendritic, new snow for dendritic age < XAGELIMPAPPUS2 , weighted average if dendritic more aged snow
OPAPPULIMTFLUX : if True, snow transport flux limitation activated. It limits the flux on a pixel if there is not enough snow on it to avoid removing more snow than there is on it.
OPAPPUDEBUG : if True, triggers snowpappus debug mode. This option displays additional information on the computation. It displays warnings, SWE conservation verification results, time and date during computation for easier debugging. And proof of SnowPappus mass conservation.

NAM_SEAICEn

NAM_SEAICEn content
Fortran name	Fortran type	Default value
CINTERPOL_SIC	CHARACTER(LEN=6)	‘NONE’

XCD_ICE_CST	FLOAT	0 (bulk)
LDIAG_MISC_SEAICE	LOGICAL	T
XSEAICE_TSTEP	FLOAT	SEA_TSTEP
XSI_FLX_DRV	FLOAT	-20.
XSIC_EFOLDING_TIME	FLOAT
CINTERPOL_SIT	CHARACTER(LEN=6)	’NONE ’

XSIT_EFOLDING_TIME	FLOAT
XFREEZING_SST	FLOAT	-1.8

"G" : apply if an explicit sea-ice scheme is set in PREP (e.g. GELATO)
CINTERPOL_SIC : Type of interpolation of Sea Ice cover external fields. This applies whatever the role of these external fields: constraint fields (when CSEAICE_SCHEME=GELATO) or forcing fields (when value is CSEAICE_SCHEME=NONE and some interpolation is set)
- LINEAR: linear interpolation between 3 months
- READAY: impose directly daily SIC (sea ice cover)
XCD_ICE_CST : Turbulent exchange coefficient value for drag, heat and vapor on sea-ice. Default is 0 and means: apply a bulk formula.
LDIAG_MISC_SEAICE : should we output sea-ice diagnostics ? default to T is sea-ice cover is handled
XSEAICE_TSTEP : Time step (in s) for the Gelato sea-ice scheme. If not set, use the same time step as the SEA scheme
XSI_FLX_DRV : Derivative of the non-solar fluxes w.r.t. sea-ice temperature (in W.m$^{-2}$.K$^{-1}$). Allows Gelato to compute this flux on various ice categories, as long as Surfex handles only one sea-ice category.
XSIC_EFOLDING_TIME : If $ge$ 0, a damping of sea-ice cover will occur in Gelato, with this e-folding time (in days). The sea-ice cover constraint is the data provided in the PREP file, interpolated in time according to CINTERPOL_SIC setting, or, as a default, the interpretation of SST data using XFREEZING_SST. [ note for Gelato wizzards: the Surfex default Gelato option for damping is “MONO” ]
CINTERPOL_SIT : Type of interpolation of Sea Ice thickness constraint, in Gelato.
- READAY: impose directly daily SIT (sea ice thickness)
XSIT_EFOLDING_TIME : If $ge$ 0, a damping of sea-ice thickness will occur in Gelato, with this e-folding time (in days). The sea-ice thickness constraint is the data provided in the PREP file [ note for Gelato wizzards: the Surfex default Gelato option for damping is “MONO_ADD” ]
XFREEZING_SST : Arbitrary SST freezing point (in Celsius). Indicates where the SST data you provide can be interpreted by Gelato as locations covered with sea-ice, if no SIC constraint field is provided. SST passed to Gelato will also anyway then be set there to the actual, salinity-dependant, freezing point.

NAM_SGH_ISBAn

NAM_SGH_ISBAn content
Fortran name	Fortran type	Default value
CRUNOFF	CHARACTER(LEN=4)	‘WSAT’
CKSAT	CHARACTER(LEN=4)	‘DEF’
LSOC	LOGICAL	F
CRAIN	CHARACTER(LEN=3)	‘DEF’
CHORT	CHARACTER(LEN=4)	‘DEF ‘

CRUNOFF : type of subgrid runoff. The following options are currently available:
- ‘WSAT’: runoff occurs only when saturation is reached
- ‘DT92’: Dumenill and Todini (1992) subgrid runoff formula
- ‘SGH ‘: Decharme et al. (2006) Topmodel like subgrid runoff
- ‘TOPD’: if LCOUPL_TOPD=T, allows that DUNNE runoff contains only saturated pixels on meshes so only catchments
CKSAT : Activates the exponential profile for Ksat. The following options are currently available:
- ‘DEF’: homogeneous profile
- ‘SGH’: exponential decreasing profile with depth (due to compaction of soil)
- ‘EXP’: with CISBA=’3-L’ and LCOUPL_TOPD=T, allows to read a file containing values for the F parameter, computed by topmodel during PGD.
LSOC : to activate soil organic carbon effect.
CRAIN : Activates the spatial distribution of rainfall intensity. The following options are currently available:
- ‘DEF’: homogeneous distribution
- ‘SGH’: exponential distribution which depends on the fraction of the mesh where it rains. This fraction depends on the mesh resolution and the intensity of hourly precipitation. (If the horizontal mesh is lower than 10km then the fraction equals 1).
CHORT : Activates the Horton runoff due to water infiltration excess. The following options are currently available:
- ‘DEF’: no Horton runoff
- ‘SGH’: Horton runoff computed

NAM_SSOn

NAM_SSOn content
Fortran name	Fortran type	Default value
CROUGH	CHARACTER(LEN=4)	‘BE04’
XFRACZ0	REAL	2.0
LDSV	LOGICAL	.FALSE.
LDSH	LOGICAL	.FALSE.
LDSL	LOGICAL	.FALSE.

CROUGH : type of orographic roughness length. The following options are currently available:
- “Z01D”: orographic roughness length does not depend on wind direction
- “Z04D”: orographic roughness length depends on wind direction
- “BE04”: Beljaars et al. [2004] orographic drag
- “NONE”: no orographic treatment
XFRACZ0 : Z0=min(Z0, Href/XFRACZ0)
XCOEFBE : coefficient for Beljaars calculation of SSO drag.
LDSV : orographic shadowing, sky view factor (only if LORORAD = T in PGD field)
LDSH : orographic shadowing, shadow factor (only if LORORAD = T in PGD field)
LDSL : orographic shadowing, slope factor (only if LORORAD = T in PGD field)

NAM_SPARTACUS

NAM_SPARTACUS content
Fortran name	Fortran type	Default value
LDO_SW	LOGICAL	T
LDO_LW	LOGICAL	T
LUSE_SW_DIRECT_ALBEDO	LOGICAL	F
LDO_VEGETATION	LOGICAL	T
LDO_URBAN	LOGICAL	T
N_VEGETATION_REGION_URBAN	REAL	1
N_VEGETATION_REGION_FOREST	REAL	1
NSW	REAL	1
NLW	REAL	1
N_STREAM_SW_URBAN	REAL	4
N_STREAM_SW_FOREST	REAL	4
N_STREAM_LW_URBAN	REAL	4
N_STREAM_LW_FOREST	REAL	4
LUSE_SYMMETRIC_VEGETATION_SCALE_URBAN	LOGICAL	F
LUSE_SYMMETRIC_VEGETATION_SCALE_FOREST	LOGICAL	F
XVEGETATION_ISOLATION_FACTOR_URBAN	REAL	0.0
XVEGETATION_ISOLATION_FACTOR_FOREST	REAL	0.0
XMIN_VEGETATION_FRACTION	REAL	1.0E-6
XMIN_BUILDING_FRACTION	REAL	1.0E-6

LDO_LW : if T, compute longwave fluxes
LUSE_SW_DIRECT_ALBEDO : if T, specify groud and roof albedos separately for direct solar radiation
LDO_VEGETATION : if T, vegetation will be represented
LDO_URBAN : if T, urban areas will be represented
N_VEGETATION_REGION_URBAN : Number of regions used to describe urban vegetation (2 needed for heterogeneity)
N_VEGETATION_REGION_FOREST : Number of regions used to describe forests (2 needed for heterogeneity)
NSW : Number of spectral bands for solar radiation
NLW : Number of spectral bands for infrared radiation
N_STREAM_SW_URBAN : Number of streams per hemisphere to describe shortwave radiation, urban areas
N_STREAM_LW_URBAN : Number of streams per hemisphere to describe longwave radiation, urban areas
N_STREAM_SW_FOREST : Number of streams per hemisphere to describe diffuse shortwave radiation, forests
N_STREAM_LW_FOREST : Number of streams per hemisphere to describe longwave radiation, forests
LUSE_SYMMETRIC_VEGETATION_SCALE_URBAN : If T tree crowns touch each other ; Eq. 2018 Hogan et al. (2018). If F tree crowns separate (shyness) ; Eq. 19 of Hogan et al. (2018).
LUSE_SYMMETRIC_VEGETATION_SCALE_FOREST : If T tree crowns touch each other ; Eq. 2018 Hogan et al. (2018).If F tree crowns separate (shyness) ; Eq. 19 of Hogan et al. (2018).
XVEGETATION_ISOLATION_FACTOR_URBAN : 0.0 = Dense vegetation region is embedded with in sparse region. 1.0 = Dense vegetation is in physically isolated regions
XVEGETATION_ISOLATION_FACTOR_FOREST : 0.0 = Dense vegetation region is embedded with in sparse region. 1.0 = Dense vegetation is in physically isolated regions
XMIN_VEGETATION_FRACTION : Minimum area fraction below which a vegetation region is removed completely.
XMIN_BUILDING_FRACTION : Minimum area fraction below which a building region is removed completely.

NAM_SURF_CSTS

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_SURF_CSTS content
Fortran name	Fortran type	Default value
XEMISSN	REAL	1.0 /0.99
XANSMIN	REAL	0.5
XANSMAX	REAL	0.85
XAGLAMIN	REAL	0.8
XAGLAMAX	REAL	0.85
XALBWAT	REAL	0.135/0.065
XALBCOEF_TA96	REAL	0.037
XALBSCA_WAT	REAL	0.06
XEMISWAT	REAL	0.98/0.96
XALBWATICE	REAL	0.85/0.40
XEMISWATICE	REAL	1.0/0.97
XHGLA	REAL	33.3
XWSNV	REAL	5.0
XCFFV	REAL	4.0
XZ0SN	REAL	0.001
XZ0HSN	REAL	0.0001
XTAU_SMELT	REAL	300.0
XALBSEAICE	REAL	0.85/0.71
XZ0FLOOD	REAL	0.0002
XALBWATSNOW	REAL	0.85/0.60
XTAU_LW	REAL	0.5

XEMISSN : snow emissivity (default depends of LREPROD_OPER flag)
XANSMIN : minimum value for snow albedo
XANSMAX : maximum value for snow albedo
XAGLAMIN : minimum value for permanent snow/ice albedo
XAGLAMAX : maximum value for permanent snow/ice albedo
XALBWAT : water direct albedo (default depends of LREPROD_OPER flag)
XALBCOEF_TA96 : coefficient used in th computation of albedo if ’TA96’ option selected
XALBSCA_WAT : water diffuse albedo
XEMISWAT : water emissivity (default depends of LREPROD_OPER flag)
XALBWATICE : water ice albedo (default depends of LREPROD_OPER flag)
XEMISWATICE : sea ice emissivity (default depends of LREPROD_OPER flag)
XHGLA : Height of aged snow in glacier case (allows Pn=1)
XWSNV : Coefficient for calculation of snow fraction over vegetation
XZ0SN : roughness length of pure snow surface (m)
XZ0HSN : roughness length for heat of pure snow surface (m)
XTAU_SMELT : snow melt timescale with D95 (s): needed to prevent time step dependence of melt when snow fraction < unity.
XCFFV : Coefficient for calculation of floodplain fraction over vegetation
XALBSEAICE : sea ice albedo (default depends of LREPROD_OPER flag)
XZ0FLOOD : flood z0
XALBWATSNOW : snow albedo over water bodies or lakes (default depends of LREPROD_OPER flag)
XTAU_LW : Extinction coefficient for view factor for long-wave radiation

NAM_SURF_ATM

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_SURF_ATM content
Fortran name	Fortran type	Default value
XCISMIN	REAL	6.7E-5
XVMODMIN	REAL	0.0
LALDTHRES	LOGICAL	.FALSE.
LDRAG_COEF_ARP	LOGICAL	.FALSE.
LALDZ0H	LOGICAL	.FALSE.
LNOSOF	LOGICAL	.TRUE.
LSLOPE	LOGICAL	.FALSE.
LCPL_GCM	LOGICAL	.FALSE.
XEDB	REAL	5.0
XEDC	REAL	5.0
XEDD	REAL	5.0
XEDK	REAL	1.0
XUSURIC	REAL	1.0
XUSURID	REAL	0.035
XUSURICL	REAL	4.0
XVCHRNK	REAL	0.015
XVZ0CM	REAL	0.0
XDELTA_MAX	REAL	1.0
XRIMAX	REAL	0.2
LVERTSHIFT	LOGICAL	.FALSE.
LVZIUSTAR0_ARP	LOGICAL	.FALSE.
LRRGUST_ARP	LOGICAL	.FALSE.
XVZIUSTAR0	REAL	0.0
XRZHZ0M	REAL	1.0
XRRSCALE	REAL	1.15E-4
XRRGAMMA	REAL	0.8
XUTILGUST	REAL	0.125
LCPL_ARP	LOGICAL	.FALSE.
LQVNPLUS	LOGICAL	.FALSE.
LVSHIFT_LW	LOGICAL	.FALSE.
LVSHIFT_PRCP	LOGICAL	.FALSE.
XCO2UNCPL	REAL	‘none’
LARP_PN	LOGICAL	.FALSE.
LCO2FOS	LOGICAL	.FALSE.

LALDTHRES : flag to set a minimum wind and shear like done in Arpege model.
XCISMIN : minimum wind shear to compute turbulent exchange coefficient (used only if LALDTHRES)
XVMODMIN : minimum wind speed to compute turbulent exchange coefficient (used only if LALDTHRES)
LDRAG_COEF_ARP : to use drag coefficient computed like in Arpege models
LALDZ0H : to take into account orography in heat roughness length
LNOSOF : no parameterization of subgrid orography effects on atmospheric forcing
LSLOPE : If True, correct parameterization of incoming radiations for homogeneous explicit slopes. If True, LNOSOF=F.
LCPL_GCM : flag used to red/write precipitation forcing from/into the erstart file for ARPEGE run
XEDB, XEDC, XEDD, XEDK : coefficients used in Richardson critical numbers computation
XUSURIC, XUSURID, XUSURICL : Richardson critical numbers
XVCHRNK, XVZ0CM : Charnock’s constant and minimal neutral roughness length over sea (formulation of roughness length over sea)
XDELTA_MAX : maximum fraction of the foliage covered by intercepted water for high vegetation
XRIMAX : limitation of Richardson number in drag computation
LVERTSHIFT : vertical shifth from atmospheric orography to surface orography
LVZIUSTAR0_ARP : flag to activate arpege formulation for zoh over sea
LRRGUST_ARP : flag to activate the correction of CD, CH, CDN due to moist gustiness
XVZIUSTAR0 : arpege formulation for zoh over sea
XRZHZ0M : arpege formulation for zoh over sea
XRRSCALE : arpege formulation for zoh over sea
XRRGAMMA : arpege formulation for zoh over sea
XUTILGUST : correction of CD, CH, CDN due to moist gustiness
LCPL_ARP : activate arpege formulation for Cp and L
LQVNPLUS : An option for the resolution of the surface temperature equation (Arpege)
LVSHIFT_LW : flag to activate/deactivate vertical shift for LongWave radiations
LVSHIT_PRCP : flag to activate/deactivate vertical shift for Precip
XCO2UNCPL : key for decoupling between CO2 employed for photosynthesis and radiative CO2 (in ppmv).
LARP_PN : Activate ARPEGE PN values for Cv and TAU_ICE
LCO2FOS : if activated, add fossil fuel emissions to natural CO2 emissions from ISBA

NAM_SEAFLUXn

NAM_SEAFLUXn content
Fortran name	Fortran type	Default value
CSEA_FLUX	CHARACTER(LEN=6)	‘ECUME6’
CSEA_ALB	CHARACTER(LEN=4)	‘TA96’
LPWG	LOGICAL	.FALSE.
LPRECIP	LOGICAL	.FALSE.
LPWEBB	LOGICAL	.FALSE.
LPROGSST	LOGICAL	.FALSE.
XOCEAN_TSTEP	REAL
CINTERPOL_SST	CHARACTER(LEN=6)	‘NONE’
CINTERPOL_SSS	CHARACTER(LEN=6)	‘NONE’
XICHCE	REAL	0.0
CSEA_SFCO2	CHARACTER(LEN=4)	‘NONE’
NGRVWAVES	INTEGER	0
NZ0	INTEGER	0
LPERTFLUX	LOGICAL	.FALSE.
LWAVEWIND	LOGICAL	.TRUE.

CSEA_FLUX : type of flux computation physics. The following options are currently available:
- “DIRECT”: direct Charnock computation from Louis [1979]. No effect of convection in the the boundary layer on the fluxes formulae.
- “ITERAT”: iterative method proposed by Fairall et al. [1996] from TOGA-COARE experiment, amended by Mondon and Redelsperger [1998] to take into account effect of atmospheric convection on fluxes.
- “COARE3”: the COARE 3.0 iterative method proposed by Fairall et al. [2003].
- “ECUME “: iterative method proposed by Fairall et al. [1996] from TOGA-COARE experiment, amended by cnrm/memo to take into account effect of atmospheric convection, precipitation and gustiness on fluxes: improvement of surface exchange coefficients representation.
- “ECUME6 “: to activate new ecumev6
- “WASPV1”: iterative bulk algorithm based on Fairall et al. [2003] modified to take the wind-sea peak period into account.
LPWG : correction of fluxes due to gustiness
LPRECIP : correction of fluxes due to precipitation
LPWEBB :correction of fluxes due to convection (Webb effect)
CSEA_ALB : type of albedo formula. The following options are currently available:
- “UNIF”: a uniform value of 0.135 is used for water albedo
- “TA96”: Taylor et al. [1996] formula for water direct albedo, depending on solar zenith angle
- “MK10”: albedo from Marat Khairoutdinov
- “RS14”: albedo based on Morel and Gentilli 1991 and Salisbury 2014 eq(2)
LPROGSST : set it to T to make SST evolve with tendency when using the 1d oceanic model
XOCEAN_TSTEP : timestep for ocean model
CINTERPOL_SST : interpolate monthly SST to daily SST
- LINEAR: Linear interpolation between 3 months. Current value is reached every 16 of each month, except in February every 15.
- UNIF: uniform SST
- QUADRA: Quadractic interpolation between 3 months, especially relevant to conserve the SST (or other) monthly mean value.
- READAY: impose directly daily SST
CINTERPOL_SSS : interpolate monthly Sea Surface Salinity to daily SSS, used by ECUME6 and/or Gelato
- LINEAR: Linear interpolation between 3 months. Current value is reached every 16 of each month, except in February every 15.
- UNIF: uniform SSS
- QUADRA: Quadractic interpolation between 3 months, especially relevant to conserve the SSS monthly mean value.
- READAY: impose directly daily SSS
XICHCE : coefficient used in the Ecume formulation (computation of exchange coefficients over sea)
CSEA_SFCO2 : Empirical CO2 emission from sea surface
- NONE : no emission
- WIND : Wanninkhof medium hypothesis using only wind speed as CO2 emission proxy (very empirical)
NRGVWAVES : Wave gravity in roughness length in coare30_flux
- 0: no gravity waves action (Charnock)
- 1: wave age parameterization of Oost et al. [2002]
- 2: model of Taylor and Yelland [2001]
NZ0 : to choose PZ0SEA formulation in ECUME6
- 0: ARPEGE formulation
- 1: Smith [1988] formulation
- 2: Direct computation using the stability functions
LPERTFLUX : True = stochastic flux perturbation of Ecume
LWAVEWIND : True for wave parameters computed from wind (default), put to False to take Hs or Tp values if initialized in PREP or if coupled.

NAM_SURF_SLT

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_SURF_SLT content
Fortran name	Fortran type	Default value
CEMISPARAM_SLT	CHARACTER(LEN=5)	‘Vig01’

“CEMISPARAM_SLT”: One-line sea salt emission parameterization type. This namelist gives the distribution of emitted sea salt of SURFEX. For Each paramterization type, a geometric standard deviation and a median radius is given. See the code init_sltn.f90 (MesoNH) or init_sltn.mnh (AROME, ALADIN) for values associated to these parameterizations. Note that if the defaut value is change, it is necessary to uses the same modes in the sea initialisation in the atmospheric model. It concerns the value of XINIRADIUS_SLT (initial radius), XINISIG_SLT (standard deviation) and CRGUNITS (mean radius definition) to have the same aerosol size distribution emitted and in the atmosphere. It is possible to do it directly in the fortran code (modd_salt.mnh in case of aladin/arome, modd_salt.f90 for Meso-NH) or for Meso-NH only, change the values of these variables in NAM_AERO_CONF (PREP_REAL_CASE or PREP_IDEAL_CASE).

NAM_WATFLUXn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_WATFLUXn content
Fortran name	Fortran type	Default value
CINTERPOL_TS	CHARACTER(LEN=6)	‘NONE’
CWAT_ALB	CHARACTER(LEN=4)	‘UNIF’

CWAT_ALB : type of formulation used to set albedo over water
CINTERPOL_TS : interpolate monthly TS to daily TS
- ‘LINEAR’ : Linear interpolation between 3 months.Current value is reached evry 16 of each month, except in February every 15.
- ‘UNIF’ : uniform TS
- ‘QUADRA’ : quadractic interpolation between 3 months, especially relevant to conserv the TS monthly mean value.

NAM_SURF_SNOW_CSTS

NAM_SURF_SNOW_CSTS content
Fortran name	Fortran type	Default value
XZ0ICEZ0SNOW	REAL
XRHOTHRESHOLD_ICE	REAL
XALBICE1	REAL	0.38
XALBICE2	REAL	0.23
XALBICE3	REAL	0.08
XVAGING_NOGLACIER	REAL
XVAGING_GLACIER	REAL
XPERCENTAGEPORE	REAL	0.05
XPERCENTAGEPORE_FRZ	REAL	1.0
XVVISC3	REAL	0.023
X_RI_MAX	REAL	0.20
XIMPUR_WET	REAL, DIMENSION(5)	0.,0.,0.,0.,0.
XIMPUR_DRY	REAL, DIMENSION(5)	0.,0.,0.,0.,0.
XPSR_SNOWMAK	REAL	0.0012
XRHO_SNOWMAK	REAL	600
XPTA_SEUIL	REAL	268
XPR_A	REAL
XPR_B	REAL
XPT	REAL
XPP_D1	REAL
XPP_D2	REAL
XPP_D3	REAL
XPP_H1	REAL
XPP_H2	REAL
XPP_H3	REAL
XPP_H4	REAL
XWT	REAL
XPTR	REAL
XPROD_SCHEME	REAL, DIMENSION(5)	2500, 5000, 4000, 2500, 1000
XSM_END	REAL, DIMENSION(4)	4, 15, 4, 15
XFREQ_GRO	INTEGER	1
XSCAVEN_COEF	REAL, DIMENSION(5)	0.,0.,0.,0.,0.
XAGELIMPAPPUS	REAL	0.05
XWINDTHRFRESH	REAL	6.0
XRHODEPPAPPUS	REAL	250
XDIAMDEPPAPPUS	REAL	0.0003
XSPHDEPPAPPUS	REAL	1.0
XLFETCHPAPPUS	REAL	250
XAGELIMPAPPUS2	REAL	0.05
XDEMAXVFALL	REAL	0.3
XCROCOEF_FF	REAL	1.0

XZ0ICEZ0SNOW : roughness length ratio between ice and snow
XRHOTHRESHOLD_ICE : density threshold for ice detection in CROCUS scheme (kg.m$^{-3}$)
XALBICE1, XALBICE2, XALBICE3 : prescribed ice albedo in 3 spectral bands for glacier simulation with CROCUS scheme
XVAGING_NOGLACIER, XVAGING_GLACIER : for ageing effects
XPERCENTAGEPORE : percentage of the total pore volume to compute the max liquid water holding capacity
XPERCENTAGEPORE_FRZ :
XVVISC3 : density adjustement in the exponential correction for viscosity (in m$^{3}$.kg$^{-1}$)
XIMPUR_WET : corresponds to the initial amount of Light-Absorbing Particles (LAP) present in the falling snow
XIMPUR_DRY : corresponds to the dry deposition coefficient (always activated) at top of snowpack (in g/m$^{2}$/s) for black carbon (XIMPUR_DRY(1)), dust (XIMPUR_DRY(2)), and other types of impurities (XIMPUR_DRY(3:5))
XPSR_SNOWMAK : Machine-made snow precipitation rate (in kg/m$^{2}$/s)
XRHO_SNOWMAK : Machine-made snow density (kg/m$^{3}$)
XPTA_SEUIL : Wet but temperature threshold for machine-made snow production (K)
XPR_A : Adjustable coefficients depending on snow-gun type (Hanzer et al., 2014). Recommended value= -3.94
XPR_B : Adjustable coefficients depending on snow-gun type (Hanzer et al., 2014). Recommended value= -4.23
XPT : Water consumption threshold during base-layer generation production period (kg/m$^{2}$). Recommended value = 150
XPP_D1 : Day of beginning (from 1$^{st}$ of December, with 31 days for all months) of base-layer generation production period (recommended value 1$^{st}$ of November=11*31+1=342). For CROCUS resort only.
XPP_D2 : Day of end (from 1$^{st}$ of December, with 31 days for all months) of base-layer generation production period (recommended value 15$^{th}$ of December=12*31+15=387). For CROCUS resort only.
XPP_D3 : Day of end (from 1$^{st}$ of December, with 31 days for all months) of reinforcement production period (recommended value 31$^{th}$ of March=3*31+31=124). For CROCUS resort only.
XPP_H1 : Hour of beginning of base-layer generation production period (in seconds, from midnight). Production during this period is allowed all day (0s to 86400s). For CROCUS resort only.
XPP_H2 : Hour of end of base-layer generation production period (in seconds, from midnight). Production during this period is allowed all day (0s to 86400s). For CROCUS resort only.
XPP_H3 : Hour of beginning of reinforcement production period (in seconds, from midnight). Production during this period is allowed from 6pm (64800s) to 8am (28800s). For CROCUS resort only.
XPP_H4 : Hour of end of reinforcement production period (in seconds, from midnight). Production during this period is allowed from 6pm (64800s) to 8am (28800s). For CROCUS resort only.
XWT : Wind speed threshold for snowmaking (m/s). Recommended value = 4.2
XPTR : Total (natural+machine-made) snow height threshold during reinforcement production period (m). Recommended value = 0.6
XPROD_SCHEME : Snow production by machines in Crocus-RESORT. When LSELF_PROD=F, the production is forced to match to production scheme defined by XPROD_SCHEME. For Nov, Dec, Jan, Feb and Mar, every day at 18:00, a production counter is compared to the target. If it’s lower, the production is allowed.
XSM_END : Month and day to stop grooming in Crocus-RESORT. (for LSNOWMAK_BOOL = F and for LSNOWMAK_BOOL = T, respectively)
XFREQ_GRO : Grooming frequency (usually 1/day)
XSCAVEN_COEF : percentage of impurity leaving with percolating water, for black carbon (XSCAVEN_COEF(1)), dust (XSCAVEN_COEF(2)), and other types of impurities (XSCAVEN_COEF(3:5))
XAGELIMPAPPUS : maximum age (days) of snow layer for which wind speed threshold is set to fresh threshold wind speed
XWINDTHRFRESH : 5m wind speed threshold for transport of freshly fallen (or deposited) snow
XRHODEPPAPPUS : density (kg.m$^{-3}$) of wind blown deposited snow
XDIAMDEPPAPPUS : optical diameter (m) of wind blown deposited snow
XSPHDEPPAPPUS : sphericity of wind blown deposited snow
XLFETCHPAPPUS : constant fetch distance applied to all points for snowpappus blowing snow flux calculation (m)
XAGELIMPAPPUS2 : maximum age (in days) of snow for using Naaim96 formulation of terminall fall speed in snowpappus
XDEMAXVFALL : maximum dendricity to have pure young snow fall speed, when option MIXT is chosen for terminal fall speed calculation (CLIMVFALL=’MIXT’ in NAM_ISBA_SNOW)
XCROCOEF_FF : to have the possibility to change the coefficient for gust diagnosis from average wind (ie to have XCOEF_FF value outside of Crocus and XCROCOEF_FF inside Crocus)

NAM_TEB_PANELn

NAM_TEB_PANELn content
Fortran name	Fortran type	Default value
CSOLAR_PANEL	CHARACTER(LEN=3)	‘PV’

CSOLAR_PANEL : solar panel option
- ‘PV’: Only photovoltaic solar panel, generate electricity
- ‘MIX’: Mix photovoltaic and thermal solar panel, produce hot water (only works with BEM)

NAM_TREEDRAG

NAM_TREEDRAG content
Fortran name	Fortran type	Default value
LTREEDRAG	LOGICAL	F

LTREEDRAG : flag used to take into account tree drag in the atmospheric model instead of SURFEX.

NAM_WRITE_COVER_TEX

NAM_WRITE_COVER_TEX content
Fortran name	Fortran type	Default value
CLANG	CHARACTER(LEN=2)	‘EN’

CLANG : language used in the file class_cover_tex.tex

NAM_WRITE_DIAG_SURFn

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

Diagnostics for to each grid cell and each tile.

NAM_WRITE_DIAG_SURFn content
Fortran name	Fortran type	Default value
LSELECT	LOGICAL	.FALSE.
CSELECT	ARRAY(CHARACTER)
LPROVAR_TO_DIAG	LOGICAL	.FALSE.
LSNOWDIMNC	LOGICAL	.FALSE.
LRESETCUMUL	LOGICAL	.FALSE.

LSELECT : if T it indicates that a selection will be used as output.
CSELECT : array containing the list of output fields.
LPROVAR_TO_DIAG : used to write out prognostic variables like diagnostic one, on average over all patches.
LSNOWDIMNC : in case of OFFLIN output files, to write the output snow fields in 2D (number of points / number of snow layers).
LRESETCUMUL : in OFFLINE mode, for the ISBA scheme, replaces the instantaneous fields by the averaged cumulated fields on the output writing time step. Then the cumulated fields are cumulated during the writing time steps and reset at the end of each of them.

NAM_WRITE_SURF_ATM

Warning

This namelist comes from SURFEX 9.0.0 user guide https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

NAM_WRITE_SURF_ATM content
Fortran name	Fortran type	Default value
LNOWRITE_CANOPY	LOGICAL	.FALSE.
LNOWRITE_TEXFILE	LOGICAL	.FALSE.
LSPLIT_PATCH	LOGICAL	.TRUE.

LNOWRITE_CANOPY : if T, do not write canopy prognostic variables in initial/restart or LBC files
LNOWRITE_TEXFILE : if T, do not fill class_cover_data.tex file during the model setup
LSPLIT_PATCH : T by default, setting FALSE it writes output fields 2D, with the dimension PATCH, like before.