PREP_PGD

PREP_PGD program is used to create the horizontal grid file for some realistic Meso-NH applications. This file is called the PGD (for PhysioGraphic Data) file in Meso-NH terminology and it contains :

  • the definition of the projection, the horizontal grid extension and resolution ;

  • the interpolated physiographic fields (soil cover, orography, …).

Tip

The number of horizontal points must satisfy certain rules because of the pressure solver. To find out the number of horizontal grid points allowed go to Get the list of authorized number of horizontal grid points.

PREP_PGD program and its corresponding namelist and function

Executable

Input namelist file

Function

Output

PREP_PGD

PRE_PGD1.nam

Create horizontal grid file

PGDFILE.{des,nc}

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

Note

For additional SURFEX namelists (NAM_CARTESIAN, …) , please go to SURFEX documentation https://www.umr-cnrm.fr/surfex/IMG/pdf/surfex_tecdoc.pdf.

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_CONF_PGD

Warning

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

NAM_CONF_PGD content

Fortran name

Fortran type

Default value

NHALO_MNH

INTEGER

1

JPHEXT

INTEGER

1

  • NHALO_MNH : Size of the halo for parallel distribution. This variable is related to computer performance but has no impact on simulation results.

  • JPHEXT : Horizontal External points number. JPHEXT must be equal to 3 for cyclic cases with WENO5.

NAM_PGDFILE

Warning

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

NAM_PGDFILE content

Fortran name

Fortran type

Default value

CPGDFILE

CHARACTER (LEN=88)

NHALO

INTEGER

15

  • CPGDFILE : name of the output Physiographic Data File

  • NHALO : Size of the halo for parallel distribution

NAM_PGD_GRID

Warning

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

This namelist defines the grid type, either specified or from an existing surface file.

NAM_PGD_GRID content

Fortran name

Fortran type

Default value

CGRID

CHARACTER(LEN=10)

‘CONF PROJ’

YINIFILE

CHARACTER(LEN=28)

‘NONE’

YINIFILETYPE

CHARACTER(LEN=6)

‘NONE’

NOVMX

INTEGER

1

  • CGRID : type of grid and projection. It is used only if a file is not prescribed (see below). The different grid possibilities are:

    • “CONF PROJ “: this grid is a regular grid (in meters in x and y perpendicular directions) on conformal projection plan (Mercator, Lambert or polar stereographic).

    • “CARTESIAN “: this grid is a regular grid (in meters in x and y perpendicular directions), with no reference to real geographical coordinates.

    Note

    For each option of CGRID you need to fill other namelist. By example, for CGRID=’CONF PROJ’, you need to fill NAM_CONF_PROJ and NAM_CONF_PROJ_GRID namelists.

  • YINIFILE : name of the file used to define the grid. It is possible to define the grid as a subgrid of a previously created file. This is currently possible only for files that have a “CONF PROJ “ or “CARTESIAN “ grid type. The exact definition of the subgrid grid chosen is prescribed in a namelist (described below), depending on the type of grid available in the file chosen. The use of a file has priority on the CGRID type.

  • YINIFILETYPE : type of the YINIFILE file, if the latter is provided. YFILETYPE must be given. The following values are currently usable:

    • “MESONH”: the file type is a MESONH file or (even if it is a LFI file from AROME).

  • NOVMX : number of points that can overlap each other in the user grid, for the calculation of physiographic fields.

NAM_CONF_PROJ

Warning

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

This namelist defines the projection in case of CGRID=”CONF PROJ” in NAM_PGD_GRID.

NAM_CONF_PROJ content

Fortran name

Fortran type

Default value

XLAT0

REAL

XLON0

REAL

XRPK

REAL

XBETA

REAL

  • XLAT0 : reference latitude for conformal projection (real, decimal degrees)

  • XLON0 : reference longitude for conformal projection (real, decimal degrees)

  • XRPK : cone factor for the projection (real):

    • XRPK=1: polar stereographic projection from north pole

    • 1>XRPK>0: Lambert projection from south pole

    • XRPK=0: Mercator projection from earth center

    • -1<XRPK<0: Lambert projection from north pole

    • XRPK=-1: polar stereographic projection from south pole

  • XBETA : rotation angle of the simulation domain around the reference longitude (real)

NAM_CONF_PROJ_GRID

Warning

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

This namelists defines the horizontal domain in case of CGRID=”CONF PROJ” in NAM_PGD_GRID.

NAM_CONF_PROJ_GRID content

Fortran name

Fortran type

Default value

XLATCEN

REAL

XLONCEN

REAL

NIMAX

INTEGER

NJMAX

INTEGER

XDX

REAL

XDY

REAL

  • XLATCEN : latitude of the point of the center of the domain (real, decimal degrees)

  • XLONCEN : longitude of the point of the center of the domain (real, decimal degrees)

  • NIMAX : number of surface points of the grid in direction x.

  • NJMAX : number of surface points of the grid in direction y.

  • XDX : grid mesh size on the conformal plane in x direction (real, meters).

  • XDY : grid mesh size on the conformal plane in y direction (real, meters).

NAM_INIFILE_CONF_PROJ

This namelists defines the horizontal domain from an existing surface file in which grid type is “CONF PROJ”. If nothing is set in the namelist, a grid identical as the one in the file is chosen.

NAM_INIFILE_CONF_PROJ content

Fortran name

Fortran type

Default value

IXOR

INTEGER

1

IYOR

INTEGER

1

IXSIZE

INTEGER

YINIFILE size

IYSIZE

INTEGER

YINIFILE size

IDXRATIO

INTEGER

1

IDYRATIO

INTEGER

1

  • IXOR : first point I index, according to the YINIFILE grid, left to and out of the new physical domain.

  • IYOR : first point J index, according to the YINIFILE grid, under and out of the new physical domain.

  • IXSIZE : number of grid points in I direction, according to YINIFILE grid, recovered by the new domain. If to be used in Meso-NH, it must only be factor of 2,3 or 5.

  • IYSIZE : number of grid points in J direction, according to YINIFILE grid, recovered by the new domain. If to be used in Meso-NH, it must only be factor of 2,3 or 5.

  • IDXRATIO : resolution factor in I direction between the YINIFILE grid and the new grid. If to be used in Meso-NH, it must only be factor of 2,3 or 5.

  • IDYRATIO : resolution factor in J direction between the YINIFILE grid and the new grid. If to be used in Meso-NH, it must only be factor of 2,3 or 5.

NAM_PGD_SCHEMES

Warning

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

This namelist defines the four schemes that will be used, one for each type of surface (sea, inland water, town, vegetation).

NAM_PGD_SCHEMES content

Fortran name

Fortran type

Default value

CNATURE

CHARACTER(LEN=6)

‘ISBA’

CSEA

CHARACTER(LEN=6)

‘SEAFLX’

CWATER

CHARACTER(LEN=6)

‘WATFLX’

CTOWN

CHARACTER(LEN=6)

‘TEB’

  • CNATURE : scheme used for vegegation and natural soil covers. The different possibilities are:

    • “NONE”: no scheme used. No fluxes will be cmputed at the surface.

    • “FLUX”: ideal fluxes are prescribed. The have to be set in the fortran routine init_ideal_flux.f90.

    • “TSZ0”: In this cheme, the fluxes are computed according to the ISBA physics, but the surface characteristics (temperature, humidity, etc…) remain constant with time.

    • “ISBA”: this is the full ISBA scheme [Noilhan and Planton, 1989], with all options developped since this initial paper.

  • CSEA : scheme used for sea and ocean. The different possibilities are:

    • “NONE” : no scheme used. No fluxes will be cmputed at the surface.

    • “FLUX” : ideal fluxes are prescribed. The have to be set in the fortran routine init_ideal_flux.f90.

    • “SEAFLX” : this is a relatively simple scheme, using the Charnock formula.

  • CWATER : scheme used for inland water. The different possibilities are:

    • “NONE” : no scheme used. No fluxes will be cmputed at the surface.

    • “FLUX” : ideal fluxes are prescribed. The have to be set in the fortran routine init_ideal_flux.f90.

    • “WATFLX” : this is a relatively simple scheme, using the Charnock formula.

    • “FLAKE” : this is lake scheme from Mironov, 2005.

  • CTOWN : scheme used for towns. The different possibilities are:

    • “NONE” : no scheme used. No fluxes will be cmputed at the surface.

    • “FLUX” : ideal fluxes are prescribed. The have to be set in the fortran routine init_ideal_flux.f90.

    • “TEB” : this is the Town Energy Balance scheme [Masson, 2000], with all the subsequent ameliorations of the scheme.

  • LGARDEN : general flag to activate TEB_GARDEN

NAM_ZS

This namelist defines the orography settings. It is used by the PREP_PGD executable and can be included in its corresponding PRE_PGD1.nam input file. If you do not include it, the default settings are those defined in the table below.

Warning

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

NAM_ZS content

Fortran name

Fortran type

Default value

XUNIF_ZS

REAL

YZS

CHARACTER(LEN=28)

YZSFILETYPE

CHARACTER(LEN=6)

COROGTYPE

CHARACTER(LEN=3)

‘ENV’

XENV

REAL

0.0

LIMP_ZS

LOGICAL

.FALSE.

YSLOPE

CHARACTER(LEN=28)

YSLOPEFILETYPE

CHARACTER(LEN=6)

‘NETCDF’

LEXPLICIT_SLOPE

LOGICAL

.FALSE.

LORORAD

LOGICAL

F

NSECTORS

INTEGER

8

XRFSSO

REAL

1.0

XHALORADIUS

REAL

20000.0

NFSSOMAX

INTEGER

30

CSVF

CHARACTER(LEN=16)

MANNERS

LFSSOVF

LOGICAL

.FALSE.

  • XUNIF_ZS : uniform value of orography imposed on all points (real,meters). If XUNIF_ZS is set, file YZS is not used.

  • YZS : data file name. If XUNIF_ZS is set, file YZS is not used. If neither XUNIF_ZS and YZS is set, then orography is set to zero.

  • YZSFILETYPE : type of data file

  • COROGTYPE : type of orography:

    • ‘AVG’: mean orography Zs.

    • ‘ENV’: envelope relief, defined from mean orography and the subgrid orography standard deviation as: Zs + XENV * \(\sigma(Zs)\)

    • ‘SIL’: silhouette relief, defined as the mean of the two subgrid silhouettes in directions x and y (if two main directions can be defined for the grid chosen).

    • ‘MAX’: maximum orography over grid box (avoid averaging in case of sea/land grid box).

  • XENV : enhance factor in envelope orography definition (real).

  • LIMP_ZS : reads orography from an existing PGD file

  • YSLOPE : file name for slope

  • YSLOPEFILETYPE : data file type for slope

  • LEXPLICIT_SLOPE : Slope is computed from explicit ZS field and not subgrid orography

  • LORORAD : flag to activate orographic radiation parameters in PGD step. New fields are created in the PGD and used in the simulation if orographic shadowing is activated (with LDSV, LDSL or LDSH)

  • NSECTORS : number of aspect sectors

  • XRFSSO : reduction factor for computing NFSSO

  • XHALORADIUS : radius of the halo in which the horizon is computed (m)

  • NFSSOMAX : max for NFSSO (limit for memory reasons)

  • CSVF : formula for SVF computation

    • ‘SENKOVA’ = Senkova et al. 2007

    • ‘MANNERS’ = Manners et al. 2012 (default)

  • LFSSOVF : compute SVF (sky view factor) on fractional slopes if possible

NAM_ZSFILTER

Warning

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

NAM_ZSFILTER content

Fortran name

Fortran type

Default value

NZSFILTER

INTEGER

1

LHSLOP

LOGICAL

.FALSE.

XHSLOP

REAL

1.2

NLOCZSFILTER

INTEGER

3

  • NZSFILTER : number of iterations of the spatial filter applied to smooth the orography over the whole domain (integer, 1 iteration removes the \(2\Delta x\) signal, 50 % of the \(4\Delta x\) signal, 25 % of the \(6\Delta x\) signal, etc…).

Note

The amplitude of the filtered signal for each wavelength \(\lambda\Delta x\) is :

\[\frac{1}{2}\left(\cos\left(\frac{2\pi}{\lambda}\right) + 1\right)\]
  • LHSLOP : flag to use a spatial filter applied to smooth the orography locally over the slopes (along the horizontal directions) higher than XHSLOP.

  • XHSLOP : slope threshold (\(\Delta z/\Delta x\) and \(\Delta z/\Delta y\)) where the local spatial filter is applied.

  • NLOCZSFILTER : number of iterations of the local spatial filter applied to smooth the large slopes. If LHSLOP is TRUE, 3 new variables are written in the output files : ZS_FILTR ([2D] height variations of the orography by local filtering), ZSLOPEX and ZSLOPEY ([2D] orography slopes along i and j indexes respectively after local filtering).

NAM_COVER

Warning

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

This namelist gives the information to compute the surface cover fractions when ECOCLIMAP is used. It is possible to use an existing ECOCLIMAP map or the define the ECOCLIMAP covers for the user’s domain.

NAM_COVER content

Fortran name

Fortran type

Default value

XUNIF_COVER

REAL

YCOVER

CHARACTER(LEN=28)

YCOVERFILETYPE

CHARACTER(LEN=6)

XRM_COVER

REAL

10-6

XRM_COAST

REAL

1.0

XRM_LAKE

REAL

0.0

XRM_SEA

REAL

0.0

LORCA_GRID

LOGICAL

.FALSE.

XLAT_ANT

REAL

-77.0

LIMP_COVER

LOGICAL

.FALSE.

LRM_RIVER

LOGICAL

.FALSE.

  • XUNIF_COVER : specified values for uniform cover fractions. For each index i between 1 and 573, XUNIF_COVER(i) is the fraction of the ith ecosystem of ecoclimap. The same fraction of each ecosystem is set to all points of the grid. The sum of all ecosystem fractions must be equal to one. If XUNIF_COVER is set, it has priority on the use of an ecosystem file (see next item: YCOVER). In the case of grid without any reference to geographical coordinates (“CARTESIAN “ or “NONE “), XUNIF_COVER must be set.

  • YCOVER : ecoclimap data file name. It is used only if XUNIF_COVER is not set.

  • YCOVERFILETYPE : type of YCOVER file (‘DIRECT’, ‘BINLLV’, ‘BINLLF’, ‘ASCLLV’).

  • XRM_COVER : for each point, all fractions of ecosystems that are below XRM_COVER are removed (i.e. set to zero), and the corresponding area fractions are distributed among the remaining ecosystem fractions. Whatever the value of XRM_COVER, at least one ecosystem remains for each grid point.

  • XRM_COAST : limit of coast coverage under which the coast is replaced by sea or inland water.

  • XRM_LAKE : limit of inland lake coverage under which the water is removed.

  • XRM_SEA : limit of sea coverage under which the sea is removed.

  • LORCA_GRID : flag to ensure the compatibility between surfex and Orca grid which minimal latitude over Antarctica is 77S

  • XLAT_ANT : minimum Orca grid latitude over Antarctica

  • LIMP_COVER : reads the cover fractions in an existing PGD file to avoid their computation

  • LRM_RIVER : if T, rivers (cover 3) are removed

NAM_PGD_ARRANGE_COVER

Warning

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

This namelist initializes change water (not lake) to nature and/or town to rock keys.

NAM_PGD_ARRANGE_COVER content

Fortran name

Fortran type

Default value

LWATER_TO_NATURE

LOGICAL

.FALSE.

LTOWN_TO_ROCK

LOGICAL

.FALSE.

LTOWN_TO_COVER

LOGICAL

.FALSE.

NREPLACE_COVER

INTEGER

  • LWATER_TO_NATURE : Change Wetland treated as inland water into nature, i.e. covers with 0. \(\leq\) FRAC_WATER \(\leq\) 1.

  • LTOWN_TO_ROCK : Change Town into Rock

  • LTOWN_TO_COVER : Option to replace (if T) urban landuse by the ecoclimap cover ICOVER

  • NREPLACE_COVER : cover number to replace urban by this cover. If LTOWN_TO_COVER=T and NREPLACE=ICOVER, the urban landuse is replaced by the ECOCLIMAP cover number ICOVER (ICOVER must be present in the domain)

NAM_ISBA

Warning

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

NAM_ISBA content

Fortran name

Fortran type

Default value

NPATCH

INTEGER

1

NGROUND_LAYER

INTEGER

1E+9

CISBA

CHARACTER(LEN=3)

‘3-L’

CPEDO_FUNCTION

CHARACTER(LEN=4)

‘CH78’

CPHOTO

CHARACTER(LEN=3)

‘NON’

LTR_ML

LOGICAL

.FALSE.

CALBEDO

CHARACTER(LEN=3)

‘CM13’

XRM_PATCH

REAL

0.0

XUNIF_CLAY

REAL

0.33

YCLAY

CHARACTER(LEN=28)

YCLAYFILETYPE

CHARACTER(LEN=6)

‘ASCLLV’

XUNIF_SAND

REAL

0.33

YSAND

CHARACTER(LEN=28)

YSANDFILETYPE

CHARACTER(LEN=6)

‘ASCLLV’

XUNIF_RUNOFFB

REAL

0.5

YRUNOFFB

CHARACTER(LEN=28)

YRUNOFFBFILETYPE

CHARACTER(LEN=6)

‘ASCLLV’

XUNIF_WDRAIN

REAL

0.0

YWDRAIN

CHARACTER(LEN=28)

YWDRAINFILETYPE

CHARACTER(LEN=6)

‘ASCLLV’

YCTI

CHARACTER(LEN=28)

YCTIFILETYPE

CHARACTER(LEN=6)

XUNIF_SOC_TOP

REAL

1.E+20

XUNIF_SOC_SUB

REAL

1.E+20

YSOC_TOP

CHARACTER(LEN=28)

YSOC_SUB

CHARACTER(LEN=28)

YSOCFILETYPE

CHARACTER(LEN=6)

XUNIF_PERM

REAL

1.E+20

YPERM

CHARACTER(LEN=28)

YPERMFILETYPE

CHARACTER(LEN=28)

XUNIF_PH

REAL

1.E+20

YPH

CHARACTER(LEN=28)

YPHFILETYPE

CHARACTER(LEN=28)

XUNIF_FERT

REAL

1.E+20

YFERT

CHARACTER(LEN=28)

YFERTFILETYPE

CHARACTER(LEN=28)

LIMP_SAND

LOGICAL

.FALSE.

LIMP_CLAY

LOGICAL

.FALSE.

LIMP_CTI

LOGICAL

.FALSE.

LIMP_SOC

LOGICAL

.FALSE.

LIMP_PERM

LOGICAL

.FALSE.

XSOILGRID

REAL(150)

1.E+20

LMEB

LOGICAL

.FALSE.

LLULCC

LOGICAL

.FALSE.

  • NPATCH : number of patches used in ISBA. One patch corresponds to aggregated parameters. 12 patches correspond to separate energy budgets for all vegetation types present in ISBA. 3 patches correspond to bare soil types, low vegetation, trees. If CPHOTO equals ‘NON’ any number of patches between 1 and 12 is possible, for the other values of CPHOTO, 12 patches are required. The order and the signification of each patch is the following:

    • 1: no vegetation (smooth) - NO

    • 2: no vegetation (rocks) - ROCK

    • 3: permanent snow and ice - SNOW

    • 4: temperate broadleaf cold-deciduous summergreen - TEBD (TREE)

    • 5: boreal needleleaf evergreen - BONE (CONI)

    • 6: tropical broadleaf evergreen - EVER

    • 7: C3 cultures types - C3

    • 8: C4 cultures types - C4

    • 9: irrigated crops - IRR

    • 10: grassland (C3) - GRAS

    • 11: tropical grassland (C4) - TROG

    • 12: peat bogs, parks and gardens (irrigated grass) - PARK

    • 13: tropical broadleaf deciduous - TRBD (TREE)

    • 14: temperate broadleaf evergreen - TEBE (TREE)

    • 15: temperate needleleaf evergreen - TENE (CONI)

    • 16: boreal broadleaf cold-deciduous summergreen - BOBD (TREE)

    • 17: boreal needleleaf cold-deciduous summergreen - BOND (CONI)

    • 18: boreal grass - BOGR (GRASS)

    • 19: shrub - SHRB (TREE)

  • NGROUND_LAYER : number of soil layer used in case of diffusion physics in the soil (CISBA = ‘DIF’):

    • with CISBA = 2-L, NGROUND_LAYER default is 2

    • with CISBA = 3-L, NGROUND_LAYER default is 3

    • with CISBA= DIF and LECOCLIMAP, NGROUND_LAYER default is 14

  • CISBA : type of soil discretization and physics in ISBA:

    • ‘2-L’: force-restore method with 2 layers for hydrology

    • ‘3-L’: force-restore method with 3 layers for hydrology

    • ‘DIF’: diffusion layer, with any number of layers

  • CPEDO_FUNCTION : Pedo-transfert function for DIF. The following options are currently available:

    • “CH78”: Clapp and Hornberger 1978 for BC

    • “C084”: Cosby et al. 1988 for BC

  • CPHOTO :type of photosynthesis physics. The following options are currently available:

    • “NON”: none is used. Jarvis formula is used for plant transpiration.

    • “AST”: ISBA-AGS with offensive/defensive stress, without evolving Leaf Area Index

    • “NIT”: ISBA-AGS with nitrogen, with evolving Leaf Area Index

    • “NCB”: ISBA-AGS with nitrogen, with evolving Leaf Area Index and wood, soil, roots biomass

  • LTR_ML : to activate new radiative transfert calculation, only if CPHOTO/=NON.

  • CALBEDO : type of bare soil albedo. The following options are currently available

    • “DRY “: dry bare soil albedo

    • “WET “: wet bare soil albedo

    • “MEAN”: albedo for bare soil half wet, half dry

    • “EVOL”: albedo of bare soil evolving with soil humidity

    • “CM13”: albedo by cover and vegetation type processed from satellite data

  • XRM_PATCH : threshol to remove little fractions of patches

  • XUNIF_CLAY : uniform prescribed value of clay fraction.

  • YCLAY : clay fraction data file name.

  • YCLAYFILETYPE : type of clay data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_SAND : uniform prescribed value of sand fraction.

  • YSAND : sand fraction data file name.

  • YSANDFILETYPE : type of sand data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_RUNOFFB : uniform prescribed value of subgrid runoff coefficient.

  • YRUNOFFB : subgrid runoff coefficient data file name.

  • YRUNOFFBFILETYPE : type of subgrid runoff data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_WDRAIN : uniform prescribed value of subgrid drainage.

  • YWDRAIN : subgrid drainage data file name.

  • YWDRAINFILETYPE : type of subgrid drainage data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • YCTI : topographic indices file name.

  • YCTIFILETYPE : type of topographic file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_SOC_TOP : uniform prescribed value of topsoil organic carbon (used only in CSOC=SGH in NAM_ISBAn)

  • XUNIF_SOC_SUB : uniform prescribed value of subsoil organic carbon (used only in CSOC=SGH in NAM_ISBAn)

  • YSOC_TOP : organic carbon topsoil data file name (used only in CSOC=SGH in NAM_ISBAn).

  • YSOC_SUB : organic carbon subsoil data file name (used only in CSOC=SGH in NAM_ISBAn).

  • YSOCFILETYPE : type of organic matter data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’) (used only in CSOC=SGH in NAM_ISBAn)

  • XUNIF_PERM : uniform value of permafrost distribution (used only if CISBA=DIF)

  • YPERM : file name for permafrost distribution (used only if CISBA=DIF)

  • YPERMFILETYPE : permafrost distribution data file type(‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’) (used only if CISBA=DIF)

  • XUNIF_PH : uniform value of soil pH (used only if LCH_NO_FLUX=T)

  • YPH : file name for soil pH (used only if LCH_NO_FLUX=T)

  • YPHFILETYPE : soil pH data file type (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’) (used only if LCH_NO_FLUX=T)

  • XUNIF_FERT : uniform value of soil fertilization rate (kgN/ha/h) (used only if LCH_NO_FLUX=T)

  • YFERT : file name for soil fertilisation rate (kgN/ha/h) (used only if LCH_NO_FLUX=T)

  • YFERTFILETYPE : soil fertilisation rate file type (kgN/ha/h)(‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’) (used only if LCH_NO_FLUX=T)

  • LIMP_SAND : reads sand fraction in an existing PGD file

  • LIMP_CLAY : reads clay fraction in an existing PGD file

  • LIMP_CTI : reads topographic indices in an existing PGD file

  • LIMP_SOC : reads organic carbon in an existing PGD file

  • LIMP_PERM : reads permafrost distribution in an existing PGD file

  • XSOILGRID : uniform soil depth grid for CISBA=DIF. Default with CISBA=DIF and LECOCLIMAP is (/0.01,0.04,0.10,0.20,0.40,0.60,0.80,1.00,1.50,2.00,3.00,5.00,8.00,12.0/)

  • LMEB : Flag to activate MEB (please note that by default, MEB uses the TR_LM radiation scheme, so when LMEB=T, LTR_ML=T automatically)

  • LLULCC : land-use land cover change scheme activation key

NAM_SEABATHY

Warning

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

NAM_SEABATHY content

Fortran name

Fortran type

Default value

XUNIF_SEABATHY

REAL

300

YSEABATHY

CHARACTER(LEN=28)

YSEABATHYFILETYPE

CHARACTER(LEN=6)

‘NONE’

YNCVARNAME

CHARACTER(LEN=28)

  • XUNIF_SEABATHY : uniform value of bathymetry imposed on all points (real,meters). If XUNIF_SEABATHY is set, file YSEABATHY is not used ;

  • YSEABATHY : data file name. If XUNIF_SEABATHY is set, file YSEABATHY is not used. If neither XUNIF_SEABATHY and YSEABATHY is set, then bathymetry is set to zero ;

  • YSEABATHYFILETYPE : type of data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’, ‘NETCDF’) ;

  • YNCVARNAME : name of variable to be read in NETCDF file.

NAM_DUMMY_PGD

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 incorporate into the physiographic file any surface field. You can treat up to 999 such fields. These fields will be written on all the files you will use later(after prognostic fields initialization, or during and after run, etc…). Their name in the files are ‘DUMMY_GRnnn’, where nnn goes from 001 to 999. During the execution of the programs, these fields are stored in the XDUMMY_FIELDS(:,:) (first dimension: spatial dimension, second dimension: total number of fields), in the module MODD_DUMMY_SURF_FIELDn. You must modify the fortran source, where you want to use them.

NAM_DUMMY_PGD content

Fortran name

Fortran type

Default value

NDUMMY_NBR

INTEGER

0

CDUMMY_NAME(:)

CHARACTER(LEN=20)

CDUMMY_FILE(:)

CHARACTER(LEN=28)

CDUMMY_FILETYPE(:)

CHARACTER(LEN=6)

CDUMMY_AREA(:)

CHARACTER(LEN=3)

‘ALL’

CDUMMY_ATYPE(:)

CHARACTER(LEN=3)

‘ARI’

Only the first NDUMMY_NBR values in these arrays are meaningfull.

  • NDUMMY_NBR : number of dummy fields.

  • CDUMMY_NAME(:) : list of the dummy fields you want to initialize with your own data. You can give any name you want. This is a way to describe what is the field. This information is not used by the program. It is just written in the Meso-NH files.

  • CDUMMY_FILE(:) : list of the names of the files containing the data for the fields you have specified in CDUMMY_NAME(:).

  • CDUMMY_FILETYPE(:) : list of the types of the files containing the data for the fields you have specified in CDUMMY_NAME(:) (‘DIRECT’, ‘LATLON’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’).

  • CDUMMY_AREA(:) : area of meaningfullness of the fields you have specified in CDUMMY_NAME(:) (‘ALL’, ‘NAT’, ‘TWN’, ‘SEA’, ‘WAT’, ‘LAN’, respectively for everywhere, natural areas, town areas, sea, inland waters, land = natural cover + town). For example, oceanic emission of DNS is relevant on ‘SEA’.

  • CDUMMY_ATYPE(:) : type of averaging (during PGD for the fields you have specified in CDUMMY_NAME(:) (‘ARI’, ‘INV’, ‘LOG’, respectively for arithmetic, inverse and logarithmic averaging).

NAM_CH_EMIS_PGD

This namelist is used to initialize chemistry components emissions. You can treat up to 999 such fields. These fields will be written on all the files you will use later (after prognostic fields initialization, or during and after run, etc…). Their name in the files are ‘EMIS_GRnnn’, where nnn goes from 001 to 999. During the execution of the programs, these fields are stored in the XEMIS_GR_FIELDS(:,:) (first dimension: spatial dimension, second dimension: total number of fields), in the module MODD_EMIS_GR_FIELDn. The temporal evolution, the aggregation of prescribed emissions and the link with the corresponding chemical prognostic variables are handled by the subroutine CH_EMISSION_FLUXn.f90.

NAM_CH_EMIS_PGD content

Fortran name

Fortran type

Default value

NEMIS_PGD_NBR

INTEGER

0

CEMIS_PGD_NAME(:)

CHARACTER(LEN=20)

CEMIS_PGD_FILE(:)

CHARACTER(LEN=28)

CEMIS_PGD_COMMENT(:)

CHARACTER(LEN=40)

NEMIS_PGD_TIME

INTEGER

0

CEMIS_PGD_FILETYPE(:)

CHARACTER(LEN=6)

DIRECT

CEMIS_PGD_AREA(:)

CHARACTER(LEN=3)

ALL

CEMIS_PGD_ATYPE(:)

CHARACTER(LEN=3)

ARI

Only the first NEMIS_PGD_NBR values in these arrays are meaningfull.

  • NEMIS_PGD_NBR : number of dummy fields.

  • CEMIS_PGD_NAME(:) : list of the dummy fields you want to initialize with your own data. You can give any name you want. This is a way to describe what is the field. This information is not used by the program. It is just written in the Meso-NH files.

  • CEMIS_PGD_FILE(:) : list of the names of the files containing the data for the fields you have specified in CEMIS_PGD_NAME(:).

  • CEMIS_PGD_COMMENT(:) : list of the comments associated to each emission field.

  • NEMIS_PGD_TIME(:) : list of the time of the files containing the data for the fields you have specified in CEMIS_PGD_NAME(:).

  • CEMIS_PGD_FILETYPE(:) : list of the types of the files containing the data for the fields you have specified in CEMIS_PGD_NAME(:) (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’).

  • CEMIS_PGD_AREA(:) : area of meaningfullness of the fields you have specified in CEMIS_PGD_NAME(:) (‘ALL’, ‘NAT’, ‘TWN’, ‘SEA’, ‘WAT’, ‘LAN’, respectively for everywhere, natural areas, town areas, sea, inland waters, land = natural cover + town). For example, oceanic emission of DNS is relevant on ‘SEA’.

  • CEMIS_PGD_ATYPE(:) : type of averaging (during PGD for the fields you have specified in CEMIS_PGD_NAME(:) (‘ARI’, ‘INV’, ‘LOG’, respectively for arithmetic, inverse and logarithmic averaging).

Note

Example:

&NAM_CH_EMIS_PGD
   NEMIS_PGD_NBR = 2,
   CEMIS_PGD_NAME(1)='COE',
   NEMIS_PGD_TIME(1)=0,
   CEMIS_PGD_COMMENT(1)='CO_00h00',
   CEMIS_PGD_AREA(1)='LAN',
   CEMIS_PGD_ATYPE(1)='ARI',
   CEMIS_PGD_FILE(1)='co_00.asc',
   CEMIS_PGD_FILETYPE(1)='ASCLLV',
   CEMIS_PGD_NAME(2)='COE',
   NEMIS_PGD_TIME(2)=43200,
   CEMIS_PGD_COMMENT(2)='CO_12h00',
   CEMIS_PGD_AREA(2)='LAN',
   CEMIS_PGD_ATYPE(2)='ARI',
   CEMIS_PGD_FILE(2)='co_12.asc',
   CEMIS_PGD_FILETYPE(2)='ASCLLV',
   CEMIS_PGD_NAME(3)='DMSE',
   NEMIS_PGD_TIME(3)=0,
   CEMIS_PGD_COMMENT(3)='dms_cte',
   CEMIS_PGD_AREA(3)='SEA',
   CEMIS_PGD_ATYPE(3)='ARI',
   CEMIS_PGD_FILE(3)='dms.asc',
   CEMIS_PGD_FILETYPE(3)='ASCLLV'
/

NAM_CH_EMISSIONS

NAM_CH_EMISSIONS content

Fortran name

Fortran type

Default value

CCH_EMIS

CHARACTER(LEN=4)

‘NONE’

  • CCH_EMIS : option for emissions computations:

    • “NONE”: no emission

    • “AGGR”: one aggregated value for each specie and hour

    • “SNAP”: from SNAP data using potential emission and temporal profile

NAM_CH_SNAP_EMIS_PGD

NAM_CH_SNAP_EMIS_PGD content

Fortran name

Fortran type

Default value

NEMIS_NBR

INTEGER

0

NEMIS_SNAP

INTEGER

0

CEMIS_NAME

CHARACTER(LEN=6)

‘’

CEMIS_COMMENT

CHARACTER(LEN=40)

‘’

CSNAP_MONTHLY_FILE

CHARACTER(LEN=28)

‘’

CSNAP_DAILY_FILE

CHARACTER(LEN=28)

‘’

CSNAP_HOURLY_FILE

CHARACTER(LEN=28)

‘’

CSNAP _POTENTIAL_FILE

CHARACTER(LEN=50)

‘’

CSNAP_POTENTIAL_FILETYPE

CHARACTER(LEN=6)

‘’

XUNIF_SNAP

REAL

none

XUNIF_DELTA_LEGAL_TIME

REAL

none

CDELTA_LEGAL_TIME_FILE

CHARACTER(LEN=50)

‘’

CDELTA_LEGAL_TIME_FILETYPE

CHARACTER(LEN=6)

‘’

  • NEMIS_NBR : number of chemical pgd fields chosen by user

  • NEMIS_SNAP : number of snaps

  • CEMIS_NAME : name of the chemical fields (emitted species)

  • CEMIS_COMMENT : comment on the chemical fields (emitted species)

  • CSNAP_MONTHLY_FILE : name of the snap ASCII monthly file

  • CSNAP_DAILY_FILE : name of the snap ASCII daily file

  • CSNAP_HOURLY_FILE : name of the snap ASCII hourly file

  • CSNAP_POTENTIAL_FILE : name of the snap potential file

  • CSNAP_POTENTIAL_FILETYPE : type of the snap potential file

  • XUNIF_SNAP : uniform value for the snap potential (emission factore for each chemical specie and each snap)

  • XUNIF_DELTA_LEGAL_TIME : uniform value for the difference (in hours) between lagal time and UTC time

  • CDELTA_LEGAL_TIME_FILE : name of file for the difference between legal time and UTC time

  • CDELTA_LEGAL_TIME_FILETYPE : filetype for the difference between legal time and UTC time

  • the annual cycle (with a monthly timescale)

  • the weekly cycle (with a daily time scale), typically to separate weekdays, saturdays and sundays.

  • The diurnal cycle (with an hourly time scale). Note here that the hypothesis is done that the diurnal evolution is the same whatever the day in the week. The reference for the calculation of the hour (UTC, solar, legal) is provided at the beginning of this file. This allows to have different timing in different places at the same UTC (if solar or legal time is chosen), for example between China and Europe.

NAM_DATA_BEM

NAM_DATA_BEM content

Fortran name

Fortran type

Default value

NPAR_FLOOR_LAYER

INTEGER

1

NPAR_MASS_LAYER

INTEGER

1

XPAR_CF_CO2_ELEC

REAL

0.0

XPAR_CF_CO2_GAS

REAL

57E-9

XPAR_CF_CO2_FUEL

REAL

75E-9

XPAR_CF_CO2_OTHER

REAL

92E-9

XUNIF_HC_FLOOR

REAL

none

CFNAM_HC_FLOOR

CHARACTER(LEN=28)

‘’

CFTYP_HC_FLOOR

CHARACTER(LEN=6)

‘’

XUNIF_TC_FLOOR

REAL

none

CFNAM_TC_FLOOR

CHARACTER(LEN=28)

‘’

CFTYP_TC_FLOOR

CHARACTER(LEN=6)

‘’

XUNIF_D_FLOOR

REAL

none

CFNAM_D_FLOOR

CHARACTER(LEN=28)

‘’

CFTYP_D_FLOOR

CHARACTER(LEN=6)

‘’

XUNIF_HC_MASS

REAL

2.016E+6

CFNAM_HC_MASS

CHARACTER(LEN=28)

‘’

CFTYP_HC_MASS

CHARACTER(LEN=6)

‘’

XUNIF_TC_MASS

REAL

1.95

CFNAM_TC_MASS

CHARACTER(LEN=28)

‘’

CFTYP_TC_MASS

CHARACTER(LEN=6)

‘’

XUNIF_D_MASS

REAL

0.12

CFNAM_D_MASS

CHARACTER(LEN=28)

‘’

CFTYP_D_MASS

CHARACTER(LEN=6)

‘’

XUNIF_FLOOR_HEIGHT

REAL

none

CFNAM_FLOOR_HEIGHT

CHARACTER(LEN=28)

‘’

CFTYP_FLOOR_HEIGHT

CHARACTER(LEN=6)

‘’

XUNIF_F_WASTE_CAN

REAL

none

CFNAM_F_WASTE_CAN

CHARACTER(LEN=28)

‘’

CFTYP_F_WASTE_CAN

CHARACTER(LEN=6)

‘’

XUNIF_F_WATER_COND

REAL

none

CFNAM_F_WATER_COND

CHARACTER(LEN=28)

‘’

CFTYP_F_WATER_COND

CHARACTER(LEN=6)

‘’

NAM_DATA_BEM content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_DCS_AREA

REAL

1E+20

CFNAM_DCS_AREA

CHARACTER(LEN=28)

‘’

CFTYP_DCS_AREA

CHARACTER(LEN=6)

‘’

XUNIF_HR_TARGET

REAL

none

CFNAM_HR_TARGET

CHARACTER(LEN=28)

‘’

CFTYP_HR_TARGET

CHARACTER(LEN=6)

‘’

XUNIF_QIN

REAL(NBEMCOMP)

5.8

CFNAM_QIN

CHARACTER(LEN=28)

‘’

CFTYP_QIN

CHARACTER(LEN=6)

‘’

XUNIF_QIN_FRAD

REAL

0.2

CFNAM_QIN_FRAD

CHARACTER(LEN=28)

‘’

CFTYP_QIN_FRAD

CHARACTER(LEN=6)

‘’

XUNIF_QIN_FLAT

REAL

0.0

CFNAM_QIN_FLAT

CHARACTER(LEN=28)

‘’

CFTYP_QIN_FLAT

CHARACTER(LEN=6)

‘’

XUNIF_MODQIN_VCD

REAL(NBEMCOMP)

1.0

CFNAM_MODQIN_VCD

CHARACTER(LEN=28)

‘ ‘

CFTYP_MODQIN_VCD

CHARACTER(LEN=6)

‘ ‘

XUNIF_MODQIN_VLD

REAL(NBEMCOMP)

1.0

CFNAM_MODQIN_VLD

CHARACTER(LEN=28)

‘ ‘

CFTYP_MODQIN_VLD

CHARACTER(LEN=6)

‘ ‘

XUNIF_MODQIN_NIG

REAL(NBEMCOMP)

1.0

CFNAM_MODQIN_NIG

CHARACTER(LEN=28)

‘ ‘

CFTYP_MODQIN_NIG

CHARACTER(LEN=6)

‘ ‘

XUNIF_SHGC

REAL

none

CFNAM_SHGC

CHARACTER(LEN=28)

‘ ‘

CFTYP_SHGC

CHARACTER(LEN=6)

‘ ‘

XUNIF_U_WIN

REAL

none

CFNAM_U_WIN

CHARACTER(LEN=28)

‘ ‘

CFTYP_U_WIN

CHARACTER(LEN=6)

‘ ‘

XUNIF_GR

REAL

none

CFNAM_GR

CHARACTER(LEN=28)

‘ ‘

CFTYP_GR

CHARACTER(LEN=6)

‘ ‘

XUNIF_SHGC_SH

REAL

none

CFNAM_SHGC_SH

CHARACTER(LEN=28)

‘ ‘

CFTYP_SHGC_SH

CHARACTER(LEN=6)

‘ ‘

XUNIF_N50

REAL

8.0

CFNAM_N50

CHARACTER(LEN=28)

‘ ‘

CFTYP_N50

CHARACTER(LEN=6)

‘ ‘

XUNIF_CAP_SYS_HEAT

REAL

none

CFNAM_CAP_SYS_HEAT

CHARACTER(LEN=28)

‘ ‘

CFTYP_CAP_SYS_HEAT

CHARACTER(LEN=6)

‘ ‘

NAM_DATA_BEM content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_CAP_SYS_RAT

REAL

none

CFNAM_CAP_SYS_RAT

CHARACTER(LEN=28)

‘ ‘

CFTYP_CAP_SYS_RAT

CHARACTER(LEN=6)

‘ ‘

XUNIF_T_ADP

REAL

none

CFNAM_T_ADP

CHARACTER(LEN=28)

‘ ‘

CFTYP_T_ADP

CHARACTER(LEN=6)

‘ ‘

XUNIF_M_SYS_RAT

REAL

none

CFNAM_M_SYS_RAT

CHARACTER(LEN=28)

‘ ‘

CFTYP_M_SYS_RAT

CHARACTER(LEN=6)

‘ ‘

XUNIF_COP_RAT

REAL

none

CFNAM_COP_RAT

CHARACTER(LEN=28)

‘ ‘

CFTYP_COP_RAT

CHARACTER(LEN=6)

‘ ‘

XUNIF_COP_DCS

REAL

1E+20

CFNAM_COP_DCS

CHARACTER(LEN=28)

‘ ‘

CFTYP_COP_DCS

CHARACTER(LEN=6)

‘ ‘

XUNIF_T_SIZE_MAX

REAL

none

CFNAM_T_SIZE_MAX

CHARACTER(LEN=28)

‘’

CFTYP_T_SIZE_MAX

CHARACTER(LEN=6)

‘’

XUNIF_T_SIZE_MIN

REAL

none

CFNAM_T_SIZE_MIN

CHARACTER(LEN=28)

‘’

CFTYP_T_SIZE_MIN

CHARACTER(LEN=6)

‘’

XUNIF_ISMECH

REAL

0.0

CFNAM_ISMECH

CHARACTER(LEN=28)

‘ ‘

CFTYP_ISMECH

CHARACTER(LEN=6)

‘ ‘

XUNIF_MECHRATE

REAL

0.0

CFNAM_MECHRATE

CHARACTER(LEN=28)

‘ ‘

CFTYP_MECHRATE

CHARACTER(LEN=6)

‘ ‘

XUNIF_SHADEARCHI

REAL

0.0

CFNAM_SHADEARCHI

CHARACTER(LEN=28)

‘ ‘

CFTYP_SHADEARCHI

CHARACTER(LEN=6)

‘ ‘

XUNIF_NATVENT

REAL(NBEMCOMP)

0

CFNAM_NATVENT

CHARACTER(LEN=28)

‘ ‘

CFTYP_NATVENT

CHARACTER(LEN=6)

‘ ‘

XUNIF_FRACOMP

REAL(NBEMCOMP)

1.0

CFNAM_FRACOMP

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACOMP

CHARACTER(LEN=6)

‘ ‘

XUNIF_RESIDENTIAL

REAL

1.0

CFNAM_RESIDENTIAL

CHARACTER(LEN=28)

‘ ‘

CFTYP_RESIDENTIAL

CHARACTER(LEN=6)

‘ ‘

NAM_DATA_BEM content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_TDESV

REAL

295.16

CFNAM_TDESV

CHARACTER(LEN=28)

‘ ‘

CFTYP_TDESV

CHARACTER(LEN=6)

‘ ‘

XUNIF_WIN_SW_MAX

REAL

150.0

CFNAM_WIN_SW_MAX

CHARACTER(LEN=28)

‘ ‘

CFTYP_WIN_SW_MAX

CHARACTER(LEN=6)

‘ ‘

XUNIF_FOPEN

REAL

0.0

CFNAM_FOPEN

CHARACTER(LEN=28)

‘ ‘

CFTYP_FOPEN

CHARACTER(LEN=6)

‘ ‘

XUNIF_FVSUM

REAL(NBEMCOMP)

0.0

CFNAM_FVSUM

CHARACTER(LEN=28)

‘ ‘

CFTYP_FVSUM

CHARACTER(LEN=6)

‘ ‘

XUNIF_FVVAC

REAL(NBEMCOMP)

0.0

CFNAM_FVVAC

CHARACTER(LEN=28)

‘ ‘

CFTYP_FVVAC

CHARACTER(LEN=6)

‘ ‘

XUNIF_FVNIG

REAL(NBEMCOMP)

0.0

CFNAM_FVNIG

CHARACTER(LEN=28)

‘ ‘

CFTYP_FVNIG

CHARACTER(LEN=6)

‘ ‘

XUNIF_FSSUM

REAL(NBEMCOMP)

0.0

CFNAM_FSSUM

CHARACTER(LEN=28)

‘ ‘

CFTYP_FSSUM

CHARACTER(LEN=6)

‘ ‘

XUNIF_FSVAC

REAL(NBEMCOMP)

0.0

CFNAM_FSVAC

CHARACTER(LEN=28)

‘ ‘

CFTYP_FSVAC

CHARACTER(LEN=6)

‘ ‘

XUNIF_FSNIG

REAL(NBEMCOMP)

0.0

CFNAM_FSNIG

CHARACTER(LEN=28)

‘ ‘

CFTYP_FSNIG

CHARACTER(LEN=6)

‘ ‘

XUNIF_DAYWBEG_SCHED

REAL(3,NBEMCOMP)

(/1,6,7/)

CFNAM_DAYWBEG_SCHED

CHARACTER(LEN=28)

‘ ‘

CFTYP_DAYWBEG_SCHED

CHARACTER(LEN=6)

‘ ‘

XUNIF_HOURWBEG_SCHED

REAL(4*3,NBEMCOMP)

(/5,7,16,23/)

CFNAM_HOURWBEG_SCHED

CHARACTER(LEN=28)

‘ ‘

CFTYP_HOURWBEG_SCHED

CHARACTER(LEN=6)

‘ ‘

XUNIF_PROBOCC

REAL(4*3,NBEMCOMP)

1.0

CFNAM_PROBOCC

CHARACTER(LEN=28)

‘ ‘

CFTYP_PROBOCC

CHARACTER(LEN=6)

‘ ‘

XUNIF_BEG_HOLIDAY

REAL(1,NBEMCOMP)

CFNAM_BEG_HOLIDAY

CHARACTER(LEN=28)

‘ ‘

CFTYP_BEG_HOLIDAY

CHARACTER(LEN=6)

‘ ‘

XUNIF_END_HOLIDAY

REAL(1,NBEMCOMP)

CFNAM_END_HOLIDAY

CHARACTER(LEN=28)

‘ ‘

CFTYP_END_HOLIDAY

CHARACTER(LEN=6)

‘ ‘

NAM_DATA_BEM content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_MOD_HOLIDAY

REAL

1.0

CFNAM_MOD_HOLIDAY

CHARACTER(LEN=28)

‘ ‘

CFTYP_MOD_HOLIDAY

CHARACTER(LEN=6)

‘ ‘

XUNIF_TCOOL_OCCD

REAL(NBEMCOMP)

300.16

CFNAM_TCOOL_OCCD

CHARACTER(LEN=28)

‘ ‘

CFTYP_TCOOL_OCCD

CHARACTER(LEN=6)

‘ ‘

XUNIF_TCOOL_OCCN

REAL(NBEMCOMP)

300.16

CFNAM_TCOOL_OCCN

CHARACTER(LEN=28)

‘ ‘

CFTYP_TCOOL_OCCN

CHARACTER(LEN=6)

‘ ‘

XUNIF_TCOOL_VCDD

REAL(NBEMCOMP)

300.16

CFNAM_TCOOL_VCDD

CHARACTER(LEN=28)

‘ ‘

CFTYP_TCOOL_VCDD

CHARACTER(LEN=6)

‘ ‘

XUNIF_TCOOL_VCDN

REAL(NBEMCOMP)

300.16

CFNAM_TCOOL_VCDN

CHARACTER(LEN=28)

‘ ‘

CFTYP_TCOOL_VCDN

CHARACTER(LEN=6)

‘ ‘

XUNIF_TCOOL_VCLD

REAL(NBEMCOMP)

300.16

CFNAM_TCOOL_VCLD

CHARACTER(LEN=28)

‘ ‘

CFTYP_TCOOL_VCLD

CHARACTER(LEN=6)

‘ ‘

XUNIF_THEAT_OCCD

REAL(NBEMCOMP)

293.16

CFNAM_THEAT_OCCD

CHARACTER(LEN=28)

‘ ‘

CFTYP_THEAT_OCCD

CHARACTER(LEN=6)

‘ ‘

XUNIF_THEAT_OCCN

REAL(NBEMCOMP)

293.16

CFNAM_THEAT_OCCN

CHARACTER(LEN=28)

‘ ‘

CFTYP_THEAT_OCCN

CHARACTER(LEN=6)

‘ ‘

XUNIF_THEAT_VCDD

REAL(NBEMCOMP)

293.16

CFNAM_THEAT_VCDD

CHARACTER(LEN=28)

‘ ‘

CFTYP_THEAT_VCDD

CHARACTER(LEN=6)

‘ ‘

XUNIF_THEAT_VCDN

REAL(NBEMCOMP)

293.16

CFNAM_THEAT_VCDN

CHARACTER(LEN=28)

‘ ‘

CFTYP_THEAT_VCDN

CHARACTER(LEN=6)

‘ ‘

XUNIF_THEAT_VCLD

REAL(NBEMCOMP)

293.16

CFNAM_THEAT_VCLD

CHARACTER(LEN=28)

‘ ‘

CFTYP_THEAT_VCLD

CHARACTER(LEN=6)

‘ ‘

XUNIF_FRAC_HEAT_ELEC

REAL(NBEMCOMP)

0.5

CFNAM_FRAC_HEAT_ELEC

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_HEAT_ELEC

CHARACTER(LEN=6)

‘ ‘

XUNIF_FRAC_HEAT_GAS

REAL(NBEMCOMP)

0.25

CFNAM_FRAC_HEAT_GAS

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_HEAT_GAS

CHARACTER(LEN=6)

‘ ‘

XUNIF_FRAC_HEAT_FUEL

REAL(NBEMCOMP)

0.25

CFNAM_FRAC_HEAT_FUEL

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_HEAT_FUEL

CHARACTER(LEN=6)

‘ ‘

NAM_DATA_BEM content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_FRAC_HEAT_OTHER

REAL(NBEMCOMP)

0.0

CFNAM_FRAC_HEAT_OTHER

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_HEAT_OTHER

CHARACTER(LEN=6)

‘ ‘

XUNIF_HOTWAT

REAL(NBEMCOMP)

0.0

CFNAM_HOTWAT

CHARACTER(LEN=28)

‘ ‘

CFTYP_HOTWAT

CHARACTER(LEN=6)

‘ ‘

XUNIF_F_HW_GAS

REAL

0.0

CFNAM_F_HW_GAS

CHARACTER(LEN=28)

‘ ‘

CFTYP_F_HW_GAS

CHARACTER(LEN=6)

‘ ‘

  • NPAR_FLOOR_LAYER : number of layers in roofs

  • NPAR_MASS_LAYER : number of layers for the internal mass in input data. This does NOT refer to the computational grid. The mass properties are interpolated from the input grid to the computational grid.

  • XPAR_CF_CO2_ELEC : Emission factor CO$_{2}$/electricity (KgCO$_{2}$.J$^{-1}$)

  • XPAR_CF_CO2_GAS : Emission factor CO$_{2}$/gas (KgCO$_{2}$.J$^{-1}$)

  • XPAR_CF_CO2_FUEL : Emission factor CO$_{2}$/fuel (KgCO$_{2}$.J$^{-1}$)

  • XPAR_CF_CO2_OTHER : Emission factor CO$_{2}$/other sources. The defaults emission factor assumes wood. (KgCO$_{2}$.J$^{-1}$)

  • XUNIF_HC_FLOOR / CFNAM_HC_FLOOR / CFTYP_HC_FLOOR : heat capacity of floor layers (J m$^{-3}$ K$^{-1}$)

  • XUNIF_TC_FLOOR / CFNAM_TC_FLOOR / CFTYP_TC_FLOOR : thermal conductivity of floor layers (W m$^{-1}$ K$^{-1}$)

  • XUNIF_D_FLOOR / CFNAM_D_FLOOR / CFTYP_D_FLOOR : thickness of floor layers (m)

  • XUNIF_HC_MASS / CFNAM_HC_MASS / CFTYP_HC_MASS : heat capacity of up to 9 mass layers (J/K/m$^{3}$)

  • XUNIF_TC_MASS / CFNAM_TC_MASS / CFTYP_TC_MASS : thermal conductivity of up to 9 mass layers (W/m/K)

  • XUNIF_D_MASS / CFNAM_D_MASS / CFTYP_D_MASS : depth of up to 9 mass layers (m)

  • XUNIF_FLOOR_HEIGHT / CFNAM_FLOOR_HEIGHT / CFTYP_FLOOR_HEIGHT : building floor height (m)

  • XUNIF_F_WASTE_CAN / CFNAM_F_WASTE_CAN / CFTYP_F_WASTE_CAN : fraction of waste heat into the canyon

  • XUNIF_F_WATER_COND / CFNAM_F_WATER_COND / CFTYP_F_WATER_COND : fraction of evaporation for condensers

  • XUNIF_DCS_AREA / CFNAM_DCS_AREA / CFTYP_DCS_AREA : presence of district cooling system

  • XUNIF_HR_TARGET / CFNAM_HR_TARGET / CFTYP_HR_TARGET : relative humidity setpoint

  • XUNIF_QIN / CFNAM_QIN / CFTYP_QIN : internal heat release (W m$^{-2}$). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_QIN_FRAD / CFNAM_QIN_FRAD / CFTYP_QIN_FRAD : radiant fraction of internal heat gains

  • XUNIF_QIN_FLAT / CFNAM_QIN_FLAT / CFTYP_QIN_FLAT : latent fraction of internal heat gains

  • XUNIF_MODQIN_VCD / CFNAM_MODQIN_VCD / CFTYP_MODQIN_VCD : Modulation factor for internal heat release when the building is vacant for short duration. This value can be specified for up to 9 tiles of use/behaviour (NBEMCOMP)

  • XUNIF_MODQIN_VLD  / CFNAM_MODQIN_VLD  / CFTYP_MODQIN_VLD : Modulation factor for internal heat release when the building is vacant for long duration (e.g. holidays). Can be specified for up to 9 tiles of use/behaviour (NBEMCOMP)

  • XUNIF_MODQIN_NIG / CFNAM_MODQIN_NIG / CFTYP_MODQIN_NIG : Modulation factor for internal heat release during the night. This value can be specified for up to 9 tiles of use/behaviour (NBEMCOMP)

  • XUNIF_SHGC / CFNAM_SHGC / CFTYP_SHGC : solar transmitance of windows (1)

  • XUNIF_U_WIN / CFNAM_U_WIN / CFTYP_U_WIN : U-Value of window (W.m$^{-2}$.K$^{-1}$)

  • XUNIF_GR / CFNAM_GR / CFTYP_GR : glazing ratio (1)

  • XUNIF_SHGC_SH / CFNAM_SHGC_SH / CFTYP_SHGC_SH : solar transmitance of windows + shading

  • XUNIF_N50 / CFNAM_N50 / CFTYP_N50 : Airtightness of the building (vol/h at 5O Pa)

  • XUNIF_CAP_SYS_HEAT / CFNAM_CAP_SYS_HEAT / CFTYP_CAP_SYS_HEAT : capacity of the heating system (W.m$^{-2}$)

  • XUNIF_CAP_SYS_RAT / CFNAM_CAP_SYS_RAT / CFTYP_CAP_SYS_RAT : rated capacity of the cooling system (W.m$^{-2}$)

  • XUNIF_T_ADP / CFNAM_T_ADP / CFTYP_T_ADP : Apparatus dewpoint temperature of the cooling coil (K)

  • XUNIF_M_SYS_RAT / CFNAM_M_SYS_RAT / CFTYP_M_SYS_RAT : rated HVAC mass flow rate (kg.s$^{-1}$.m$^{-2}$)

  • XUNIF_COP_RAT / CFNAM_COP_RAT / CFTYP_COP_RAT : rated COP of the cooling system (1)

  • XUNIF_COP_DCS / CFNAM_COP_DCS / CFTYP_COP_DCS : rated COP of the district cooling system (1)

  • XUNIF_T_SIZE_MAX / CFNAM_T_SIZE_MAX / CFTYP_T_SIZE_MAX : Temperature for capacity of the cooling system (K)

  • XUNIF_T_SIZE_MIN / CFNAM_T_SIZE_MIN / CFTYP_T_SIZE_MIN : Temperature for capacity of the heating system (K)

  • XUNIF_ISMECH / CFNAM_ISMECH / CFTYP_ISMECH : control variable for presence of mechanical ventilation (0=no mechanical ventilation / 1=mechanical ventilation)

  • XUNIF_MECHRATE / CFNAM_MECHRATE / CFTYP_MECHRATE : air exchange due to mechanical ventilation (vol/h). Replace old key XUNIF_V_VENT. 0=

  • XUNIF_SHADEARCHI / CFNAM_SHADEARCHI / CFTYP_SHADEARCHI : presence of shading devices. 0=no / 1=adjustable / 2=permanent

  • XUNIF_NATVENT / CFNAM_NATVENT / CFTYP_NATVENT : Control variable for ventilation for up to 9 behaviours in building. 0=No ventilation / 1=Manual ventilation / 2=Automatic ventilation

  • XUNIF_FRACOMP / CFNAM_FRACOMP / CFTYP_FRACOMP : fractions of up to 9 tiles of building use/human behaviour. Sum of the fractions must equal 1.

  • XUNIF_RESIDENTIAL / CFNAM_RESIDENTIAL / CFTYP_RESIDENTIAL : residential fractions (only used for solar panel)

  • XUNIF_TDESV / CFNAM_TDESV / CFTYP_TDESV : Design temperature for ventilation. Indoor air temperature, people or automatic ventilation try to achieve by opening/closing of windows (K)

  • XUNIF_WIN_SW_MAX / CFNAM_WIN_SW_MAX / CFTYP_WIN_SW_MAX : threshold for shortwave radiation received by walls used for shading calculations (W/m$^{2}$)

  • XUNIF_FOPEN / CFNAM_FOPEN / CFTYP_FOPEN : maximum fraction of windows opened in case ventilation is made

  • XUNIF_FVSUM / CFNAM_FVSUM / CFTYP_FVSUM : fraction of households using natural ventilation when the building during summer (warm conditions). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_FVVAC / CFNAM_FVVAC / CFTYP_FVVAC : fraction of households using natural ventilation when the building is vacant. This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_FVNIG / CFNAM_FVNIG / CFTYP_FVNIG : fraction of households using natural ventilation during the night. This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_FSSUM / CFNAM_FSSUM / CFTYP_FSSUM : fraction of households closing shading elements during summer (warm conditions). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_FSVAC / CFNAM_FSVAC / CFTYP_FSVAC : fraction of households closing shading elements when the building is vacant. This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_FSNIG / CFNAM_FSNIG / CFTYP_FSNIG : fraction of households closing shading elements duting the night. This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_DAYWBEG_SCHED / CFNAM_DAYWBEG_SCHED / CFTYP_DAYWBEG_SCHED : day of the week for schedules on human behaviour. 1=Monday, 2=Tuesday, …, 7=Sunday. 3 periods can be specified (by default 1,6,7 = Monday to Friday, Saturday, Sunday) for up to 9 tiles of human behaviour.

  • XUNIF_HOURWBEG_SCHED / CFNAM_HOURWBEG_SCHED / \

  • XUNIF_PROBOCC / CFNAM_PROBOCC / CFTYP_PROBOCC : Probability that the building is occupied for the schedules defined by DAYWBEG_SCHED and HOURBEG_SCHED

  • XUNIF_BEG_HOLIDAY / CFNAM_BEG_HOLIDAY / CFTYP_BEG_HOLIDAY : Julian day of year of the beginning of holiday period. One holiday period can be specified for up to 9 tiles for human behaviour.

  • XUNIF_END_HOLIDAY / CFNAM_END_HOLIDAY / CFTYP_END_HOLIDAY : Julian day of year of the end of holiday period. One holiday period can be specified for up to 9 tiles for human behaviour.

  • XUNIF_MOD_HOLIDAY / CFNAM_MOD_HOLIDAY / CFTYP_MOD_HOLIDAY : Modulation factor for internal heat release during holiday period.

  • XUNIF_TCOOL_OCCD / CFNAM_TCOOL_OCCD / CFTYP_TCOOL_OCCD : Design temperature for air conditioning when the building is occupied during the day (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_TCOOL_OCCN / CFNAM_TCOOL_OCCN / CFTYP_TCOOL_OCCN : Design temperature for air conditioning when the building is occupied during the night (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_TCOOL_VCDD / CFNAM_TCOOL_VCDD / CFTYP_TCOOL_VCDD : Design temperature for air conditioning when the building is vacant during the day (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_TCOOL_VCDN / CFNAM_TCOOL_VCDN / CFTYP_TCOOL_VCDN : Design temperature for air conditioning when the building is vacant during the night (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_TCOOL_VCLD / CFNAM_TCOOL_VCLD / CFTYP_TCOOL_VCLD : Design temperature for air conditioning when the building is vacant for long duration (K). Example : holiday home. This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_THEAT_OCCD / CFNAM_THEAT_OCCD / CFTYP_THEAT_OCCD : Design temperature for heating when the building is occupied during the day (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_THEAT_OCCN / CFNAM_THEAT_OCCN / CFTYP_THEAT_OCCN : Design temperature for heating when the building is occupied during the night (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_THEAT_VCDD / CFNAM_THEAT_VCDD / CFTYP_THEAT_VCDD : Design temperature for heating when the building is vacant During the Day (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_THEAT_VCDN / CFNAM_THEAT_VCDN / CFTYP_THEAT_VCDN : Design temperature for heating when the building is vacant During the Night (K). This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_THEAT_VCLD / CFNAM_THEAT_VCLD / CFTYP_THEAT_VCLD : Design temperature for heating when the building is vacant for Long Duration (K). Example : holiday home. This value can be specified for up to 9 tiles of use/behaviour.

  • XUNIF_FRAC_HEAT_ELEC / CFNAM_FRAC_HEAT_ELEC / \

  • XUNIF_FRAC_HEAT_GAS / CFNAM_FRAC_HEAT_GAS / CFTYP_FRAC_HEAT_GAS : Fraction of households with gas as heating combustible

  • XUNIF_FRAC_HEAT_FUEL / CFNAM_FRAC_HEAT_FUEL / \

  • XUNIF_FRAC_HEAT_OTHER / CFNAM_FRAC_HEAT_OTHER / \

  • XUNIF_HOTWAT / CFNAM_HOTWAT / CFTYP_HOTWAT : Energy consumption for domestic warm water (W/m$^{2}$)

  • XUNIF_F_HW_GAS / CFNAM_F_HW_GAS / CFTYP_F_HW_GAS : Fraction of domestic warm water heated with gas

NAM_DATA_ISBA

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_VEGTYPE

REAL

none

CFNAM_VEGTYPE

CHARACTER(LEN=28)

CFTYP_VEGTYPE

CHARACTER(LEN=6)

none

XUNIF_RSMIN

REAL

none

CFNAM_RSMIN

CHARACTER(LEN=28)

‘ ‘

CFTYP_RSMIN

CHARACTER(LEN=6)

none

XUNIF_GAMMA

REAL

none

CFNAM_GAMMA

CHARACTER(LEN=28)

‘ ‘

CFTYP_GAMMA

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

XUNIF_WRMAX_CF

REAL

none

CFNAM_WRMAX_CF

CHARACTER(LEN=28)

‘ ‘

CFTYP_WRMAX_CF

CHARACTER(LEN=6)

none

XUNIF_RGL

REAL

none

CFNAM_RGL

CHARACTER(LEN=28)

‘ ‘

CFTYP_RGL

CHARACTER(LEN=6)

none

XUNIF_CV

REAL

none

CFNAM_CV

CHARACTER(LEN=28)

‘ ‘

CFTYP_CV

CHARACTER(LEN=6)

none

XUNIF_Z0_O_Z0H

REAL

none

CFNAM_Z0_O_Z0H

CHARACTER(LEN=28)

‘ ‘

CFTYP_Z0_O_Z0H

CHARACTER(LEN=6)

none

XUNIF_SEED_M

REAL

none

CFNAM_SEED_M

CHARACTER(LEN=28)

CFTYP_SEED_M

CHARACTER(LEN=6)

none

XUNIF_SEED_D

REAL

none

CFNAM_SEED_D

CHARACTER(LEN=28)

CFTYP_SEED_D

CHARACTER(LEN=6)

none

XUNIF_REAP_M

REAL

none

CFNAM_REAP_M

CHARACTER(LEN=28)

CFTYP_REAP_M

CHARACTER(LEN=6)

none

XUNIF_REAP_D

REAL

none

CFNAM_REAP_D

CHARACTER(LEN=28)

CFTYP_REAP_D

CHARACTER(LEN=6)

none

XUNIF_SEED_S2_M

REAL

none

CFNAM_SEED_S2_M

CHARACTER(LEN=28)

CFTYP_SEED_S2_M

CHARACTER(LEN=6)

none

XUNIF_SEED_S2_D

REAL

none

CFNAM_SEED_S2_D

CHARACTER(LEN=28)

CFTYP_SEED_S2_D

CHARACTER(LEN=6)

none

XUNIF_REAP_S2_M

REAL

none

CFNAM_REAP_S2_M

CHARACTER(LEN=28)

CFTYP_REAP_S2_M

CHARACTER(LEN=6)

none

XUNIF_REAP_S2_D

REAL

none

CFNAM_REAP_S2_D

CHARACTER(LEN=28)

CFTYP_REAP_S2_D

CHARACTER(LEN=6)

none

XUNIF_SEED_S3_M

REAL

none

CFNAM_SEED_S3_M

CHARACTER(LEN=28)

CFTYP_SEED_S3_M

CHARACTER(LEN=6)

none

XUNIF_SEED_S3_D

REAL

none

CFNAM_SEED_S3_D

CHARACTER(LEN=28)

CFTYP_SEED_S3_D

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

XUNIF_REAP_S3_M

REAL

none

CFNAM_REAP_S3_M

CHARACTER(LEN=28)

CFTYP_REAP_S3_M

CHARACTER(LEN=6)

none

XUNIF_REAP_S3_D

REAL

none

CFNAM_REAP_S3_D

CHARACTER(LEN=28)

CFTYP_REAP_S3_D

CHARACTER(LEN=6)

none

XUNIF_IRRIGTYPE

REAL

none

CFNAM_IRRIGTYPE

CHARACTER(LEN=28)

CFTYP_IRRIGTYPE

CHARACTER(LEN=6)

none

XUNIF_IRRIGFRAC

REAL

none

CFNAM_IRRIGFRAC

CHARACTER(LEN=28)

CFTYP_IRRIGFRAC

CHARACTER(LEN=6)

none

XUNIF_IRRIGFREQ

REAL

none

CFNAM_IRRIGFREQ

CHARACTER(LEN=28)

CFTYP_IRRIGFREQ

CHARACTER(LEN=6)

none

XUNIF_IRRIGTIME

REAL

none

CFNAM_IRRIGTIME

CHARACTER(LEN=28)

CFTYP_IRRIGTIME

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

Name

TYPE

Default

NTIME

INTEGER

36

Name

TYPE

Default

XUNIF_VEG

REAL

none

CFNAM_VEG

CHARACTER(LEN=28)

CFTYP_VEG

CHARACTER(LEN=6)

none

XUNIF_LAI

REAL

none

CFNAM_LAI

CHARACTER(LEN=28)

CFTYP_LAI

CHARACTER(LEN=6)

none

XUNIF_Z0

REAL

none

CFNAM_Z0

CHARACTER(LEN=28)

CFTYP_Z0

CHARACTER(LEN=6)

none

XUNIF_EMIS

REAL

none

CFNAM_EMIS

CHARACTER(LEN=28)

CFTYP_EMIS

CHARACTER(LEN=6)

none

XUNIF_ALBNIR_VEG

REAL

none

CFNAM_ALBNIR_VEG

CHARACTER(LEN=28)

CFTYP_ALBNIR_VEG

CHARACTER(LEN=6)

none

XUNIF_ALBVIS_VEG

REAL

none

CFNAM_ALBVIS_VEG

CHARACTER(LEN=28)

CFTYP_ALBVIS_VEG

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

XUNIF_ALBUV_VEG

REAL

none

CFNAM_ALBUV_VEG

CHARACTER(LEN=28)

CFTYP_ALBUV_VEG

CHARACTER(LEN=6)

none

XUNIF_ALBNIR_SOIL

REAL

none

CFNAM_ALBNIR_SOIL

CHARACTER(LEN=28)

CFTYP_ALBNIR_SOIL

CHARACTER(LEN=6)

none

XUNIF_ALBVIS_SOIL

REAL

none

CFNAM_ALBVIS_SOIL

CHARACTER(LEN=28)

CFTYP_ALBVIS_SOIL

CHARACTER(LEN=6)

none

XUNIF_ALBUV_SOIL

REAL

none

CFNAM_ALBUV_SOIL

CHARACTER(LEN=28)

CFTYP_ALBUV_SOIL

CHARACTER(LEN=6)

none

XUNIF_IRRIG

REAL

none

CFNAM_IRRIG

CHARACTER(LEN=28)

CFTYP_IRRIG

CHARACTER(LEN=6)

none

XUNIF_GNDLITTER

REAL

XUNIF_Z0LITTER

REAL

XUNIF_WATSUP

REAL

none

CFNAM_WATSUP

CHARACTER(LEN=28)

CFTYP_WATSUP

CHARACTER(LEN=6)

none

XUNIF_F2THRESHOLD

REAL

none

CFNAM_F2THRESHOLD

CHARACTER(LEN=28)

CFTYP_F2THRESHOLD

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_DG

REAL

none

CFNAM_DG

CHARACTER(LEN=28)

CFTYP_DG

CHARACTER(LEN=6)

none

XUNIF_ROOTFRAC

REAL

none

CFNAM_ROOTFRAC

CHARACTER(LEN=28)

CFTYP_ROOTFRAC

CHARACTER(LEN=6)

none

XUNIF_ROOT_DEPTH

REAL

none

CFNAM_ROOT_DEPTH

CHARACTER(LEN=28)

CFTYP_ROOT_DEPTH

CHARACTER(LEN=6)

none

XUNIF_GROUND_DEPTH

REAL

none

CFNAM_GROUND_DEPTH

CHARACTER(LEN=28)

CFTYP_GROUND_DEPTH

CHARACTER(LEN=6)

none

XUNIF_ROOT_EXTINCTION

REAL

none

CFNAM_ROOT_EXTINCTION

CHARACTER(LEN=28)

CFTYP_ROOT_EXTINCTION

CHARACTER(LEN=6)

none

XUNIF_ROOT_LIN

REAL

none

CFNAM_ROOT_LIN

CHARACTER(LEN=28)

CFTYP_ROOT_LIN

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

Name

TYPE

Default

LUNIF_STRESS

LOGICAL

T

XUNIF_GMES

REAL

none

CFNAM_GMES

CHARACTER(LEN=28)

CFTYP_GMES

CHARACTER(LEN=6)

none

XUNIF_BSLAI

REAL

none

CFNAM_BSLAI

CHARACTER(LEN=28)

CFTYP_BSLAI

CHARACTER(LEN=6)

none

XUNIF_LAIMIN

REAL

none

CFNAM_LAIMIN

CHARACTER(LEN=28)

CFTYP_LAIMIN

CHARACTER(LEN=6)

none

XUNIF_SEFOLD

REAL

none

CFNAM_SEFOLD

CHARACTER(LEN=28)

CFTYP_SEFOLD

CHARACTER(LEN=6)

none

XUNIF_GC

REAL

none

CFNAM_GC

CHARACTER(LEN=28)

CFTYP_GC

CHARACTER(LEN=6)

none

XUNIF_DMAX

REAL

none

CFNAM_DMAX

CHARACTER(LEN=28)

CFTYP_DMAX

CHARACTER(LEN=6)

none

XUNIF_F2I

REAL

none

CFNAM_F2I

CHARACTER(LEN=28)

CFTYP_F2I

CHARACTER(LEN=6)

none

XUNIF_H_TREE

REAL

none

CFNAM_H_TREE

CHARACTER(LEN=28)

CFTYP_H_TREE

CHARACTER(LEN=6)

none

XUNIF_RE25

REAL

none

CFNAM_RE25

CHARACTER(LEN=28)

CFTYP_RE25

CHARACTER(LEN=6)

none

XUNIF_CE_NITRO

REAL

none

CFNAM_CE_NITRO

CHARACTER(LEN=28)

CFTYP_CE_NITRO

CHARACTER(LEN=6)

none

XUNIF_CF_NITRO

REAL

none

CFNAM_CF_NITRO

CHARACTER(LEN=28)

CFTYP_CF_NITRO

CHARACTER(LEN=6)

none

XUNIF_CNA_NITRO

REAL

none

CFNAM_CNA_NITRO

CHARACTER(LEN=28)

CFTYP_CNA_NITRO

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_CONDSAT

REAL

none

CFNAM_CONDSAT

CHARACTER(LEN=28)

CFTYP_CONDSAT

CHARACTER(LEN=6)

none

XUNIF_MPOTSAT

REAL

none

CFNAM_MPOTSAT

CHARACTER(LEN=28)

CFTYP_MPOTSAT

CHARACTER(LEN=6)

none

XUNIF_BCOEF

REAL

none

CFNAM_BCOEF

CHARACTER(LEN=28)

CFTYP_BCOEF

CHARACTER(LEN=6)

none

XUNIF_WSAT

REAL

none

CFNAM_WSAT

CHARACTER(LEN=28)

CFTYP_WSAT

CHARACTER(LEN=6)

none

XUNIF_WFC

REAL

none

CFNAM_WFC

CHARACTER(LEN=28)

CFTYP_WFC

CHARACTER(LEN=6)

none

XUNIF_WWILT

REAL

none

CFNAM_WWILT

CHARACTER(LEN=28)

CFTYP_WWILT

CHARACTER(LEN=6)

none

NAM_DATA_ISBA content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_XUNIF_IRRIGTYPE_C

REAL

0 for non irrigated vegtype

1 (sprinkler) for irrigated vegtypes

XUNIF_XUNIF_IRRIGFRAC_C

REAL

0.05

XUNIF_XUNIF_IRRIGFREQ_C

REAL

XUNIF_IRRIGTIME_C

REAL

28800

XUNIF_WATSUP_C

REAL

30

XUNIF_F2THRESHOLD_C

REAL

XUNIF_SEED_M_C

REAL

3

XUNIF_SEED_D_C

REAL

15

XUNIF_REAP_M_C

REAL

8

XUNIF_REAP_D_C

REAL

31

XUNIF_SEED_S2_M_C

REAL

XUNIF_SEED_S2_D_C

REAL

XUNIF_REAP_S2_M_C

REAL

XUNIF_REAP_S2_D_C

REAL

XUNIF_SEED_S3_M_C

REAL

XUNIF_SEED_S3_D_C

REAL

XUNIF_REAP_S3_M_C

REAL

XUNIF_REAP_S3_D_C

REAL

XUNIF_SEED_D_DELTA

REAL

0

XUNIF_REAP_D_DELTA

REAL

0

XUNIF_SEED_S2_D_DELTA

REAL

0

XUNIF_REAP_S2_D_DELTA

REAL

0

XUNIF_SEED_S3_D_DELTA

REAL

0

Name

TYPE

Default

NUNIF_VEG_IRR_USE

INTEGER

(/5,7,12,16,17,18/)

XUNIF_IRRIGFREQ_CTYPE

INTEGER

(/604800,0,604800/)

Name

TYPE

Default

XUNIF_WATSUP_CTIME

INTEGER

XUNIF_F2THRESHOLD_CTIME

INTEGER

  • XUNIF_VEGTYPE / CFNAM_VEGTYPE / CFTYP_VEGTYPE : fractions of each vegetation types

  • XUNIF_RSMIN / CFNAM_RSMIN / CFTYP_RSMIN : minimal stomatal resistance (s/m)

  • XUNIF_GAMMA / CFNAM_GAMMA / CFTYP_GAMMA : coefficient used in the computation of RSMIN (-)

  • XUNIF_WRMAX_CF / CFNAM_WRMAX_CF / CFTYP_WRMAX_CF : coefficient for maximum interception water storage capacity (-)

  • XUNIF_RGL / CFNAM_RGL / CFTYP_RGL : maximum solar radiation available for photosynthesis (W/m$^{2}$)

  • XUNIF_CV / CFNAM_CV / CFTYP_CV : vegetation thermal inertia coefficient (K m$^{2}$/J)

  • XUNIF_Z0_O_Z0H / CFNAM_Z0_O_Z0H / CFTYP_Z0_O_Z0H : ratio of surface roughness lengths (-)

  • XUNIF_SEED_M / CFNAM_SEED_M / CFTYP_SEED_M : month of seeding

  • XUNIF_SEED_D / CFNAM_SEED_D / CFTYP_SEED_D : day of seeding

  • XUNIF_REAP_M / CFNAM_REAP_M / CFTYP_REAP_M : month of reaping

  • XUNIF_REAP_D / CFNAM_REAP_D / CFTYP_REAP_D : day of reaping

  • XUNIF_SEED_S2_M / CFNAM_SEED_S2_M / CFTYP_SEED_S2_M : month for a second season of seeding

  • XUNIF_SEED_S2_D / CFNAM_SEED_S2_D / CFTYP_SEED_S2_D : day for a second season of seeding

  • XUNIF_REAP_S2_M / CFNAM_REAP_S2_M / CFTYP_REAP_S2_M : month for a second season of reaping

  • XUNIF_REAP_S2_D / CFNAM_REAP_S2_D / CFTYP_REAP_S2_D : day for a second season of reaping

  • XUNIF_SEED_S3_M / CFNAM_SEED_S3_M / CFTYP_SEED_S3_M : month for a third season of seeding

  • XUNIF_SEED_S3_D / CFNAM_SEED_S3_D / CFTYP_SEED_S3_D : day for a third season of seeding

  • XUNIF_REAP_S3_M / CFNAM_REAP_S3_M / CFTYP_REAP_S3_M : month for a third season of reaping

  • XUNIF_REAP_S3_D / CFNAM_REAP_S3_D / CFTYP_REAP_S3_D : day for a third season of reaping

  • XUNIF_IRRIGTYPE / CFNAM_IRRIGTYPE / CFTYP_IRRIGTYPE : irrigation type when LIRRIGMODE or LECOSG are activated. 0 for none, 1 for sprinkling, 2 for dripping and 3 for flooding. By default an irrigated vegetation type is 1 (sprinkler) and the others 0.

  • XUNIF_IRRIGFRAC / CFNAM_IRRIGFRAC / CFTYP_IRRIGFRAC : if LECOSG and LIRRIGMODE are activated, this key indicates the irrigation fraction [0-1] for each vegetation type (but only the vegetation types indicated in NUNIF_VEG_IRR_USE will be irrigated).

  • XUNIF_IRRIGFREQ / CFNAM_IRRIGFREQ / CFTYP_IRRIGFREQ : if LIRRIGMODE, keys to indicate the minimum time (in s) between two irrigation triggers. By default it is defined with XUNIF_IRRIGFREQ_CTYPE: values for the 3 types of irrigation, respectively sprinkling, dripping and flooding.

  • XUNIF_IRRIGTIME / CFNAM_IRRIGTIME / CFTYP_IRRIGTIME : if LIRRIGMODE, keys to indicate the duration of irrigation (in s).

  • NTIME : time dimension for ISBA parameters. 1=a single value for the whole year / 2=two values from January to June, and from July to December / 12=monthly parameters / 36=parameters updated each 10 days

  • XUNIF_VEG / CFNAM_VEG / CFTYP_VEG : fraction of vegetation for each vegetation types (-)

  • XUNIF_LAI / CFNAM_LAI / CFTYP_LAI : leaf area index (m$^{2}$/m$^{2}$)

  • XUNIF_Z0 / CFNAM_Z0 / CFTYP_Z0 : roughness length (m)

  • XUNIF_EMIS / CFNAM_EMIS / CFTYP_EMIS : emissivity (-)

  • XUNIF_ALBNIR_VEG / CFNAM_ALBNIR_VEG / CFTYP_ALBNIR_VEG : vegetation near-infra-red albedo (-)

  • XUNIF_ALBVIS_VEG / CFNAM_ALBVIS_VEG / CFTYP_ALBVIS_VEG : vegetation visible albedo (-)

  • XUNIF_ALBUV_VEG / CFNAM_ALBUV_VEG / CFTYP_ALBUV_VEG : vegetation UV albedo(-)

  • XUNIF_ALBNIR_SOIL / CFNAM_ALBNIR_SOIL / CFTYP_ALBNIR_SOIL : soil near-infra-red albedo (-)

  • XUNIF_ALBVIS_SOIL / CFNAM_ALBVIS_SOIL / CFTYP_ALBVIS_SOIL : soil visible albedo (-)

  • XUNIF_ALBUV_SOIL / CFNAM_ALBUV_SOIL / CFTYP_ALBUV_SOIL : soil UV albedo (-)

  • XUNIF_IRRIG / CFNAM_IRRIG / CFTYP_IRRIG : flag for irrigation

  • XUNIF_GNDLITTER : litter layer thickness (m)

  • XUNIF_Z0LITTER : sub-forest canopy litter layer roughness (m)

  • XUNIF_WATSUP / CFNAM_WATSUP / CFTYP_WATSUP : water supply during irrigation process (mm)

  • XUNIF_F2THRESHOLD / CFNAM_F2THRESHOLD / CFTYP_F2THRESHOLD : if LIRRIGMODE, keys to indicate the threshold [0-1] for irrigation triggering. By default the value given by XTHRESHOLD in the namelist NAM_AGRI is used, but the value can be overwritten here.

  • XUNIF_DG / CFNAM_DG / CFTYP_DG : soil layer thickness (m)

  • XUNIF_ROOTFRAC / CFNAM_ROOTFRAC / CFTYP_ROOTFRAC : root fraction (-)

  • XUNIF_ROOT_DEPTH / CFNAM_ROOT_DEPTH / CFTYP_ROOT_DEPTH : root depth (-)

  • XUNIF_GROUND_DEPTH / CFNAM_GROUND_DEPTH / CFTYP_GROUND_DEPTH : ground depth for hydrology (-)

  • XUNIF_ROOT_EXTINCTION / CFNAM_ROOT_EXTINCTION / CFTYP_ROOT_EXTINCTION : root extinction percentage(-)

  • XUNIF_ROOT_LIN / CFNAM_ROOT_LIN / CFTYP_ROOT_LIN : root linear parameter (-)

  • XUNIF_GMES / CFNAM_GMES / CFTYP_GMES : mesophyll conductance (m/s$^{-1}$)

  • XUNIF_BSLAI / CFNAM_BSLAI / CFTYP_BSLAI : ratio d(biomass)/d(lai) (kg/m$^{2}$)

  • XUNIF_LAIMIN / CFNAM_LAIMIN / CFTYP_LAIMIN : minimum LAI (m$^{2}$/m$^{2}$)

  • XUNIF_SEFOLD / CFNAM_SEFOLD / CFTYP_SEFOLD : e-folding time for senescence (s)

  • XUNIF_GC / CFNAM_GC / CFTYP_GC : cuticular conductance (m/s)

  • XUNIF_DMAX / CFNAM_DMAX / CFTYP_DMAX : maximum air saturation deficit (kg/kg)

  • XUNIF_F2I / CFNAM_F2I / CFTYP_F2I : critical normilized soil water content for stress parameterization (-)

  • XUNIF_H_TREE / CFNAM_H_TREE / CFTYP_H_TREE : height of trees (m)

  • XUNIF_RE25 / CFNAM_RE25 / CFTYP_RE25 : Ecosystem respiration parameter (kg/kgms$^{-1}$)

  • XUNIF_CE_NITRO / CFNAM_CE_NITRO / CFTYP_CE_NITRO : leaf aera ratio sensivity to [nitrogen] (m$^{2}$/kg)

  • XUNIF_CF_NITRO / CFNAM_CF_NITRO / CFTYP_CF_NITRO : lethal minimum value of leaf area ratio (m$^{2}$/kg)

  • XUNIF_CNA_NITRO / CFNAM_CNA_NITRO / CFTYP_CNA_NITRO : nitrogen concentration of active biomass (kg/kg)

  • LUNIF_STRESS : stress type

  • XUNIF_CONDSAT / CFNAM_CONDSAT / CFTYP_CONDSAT : hydraulic conductivity at saturation (m/s)

  • XUNIF_MPOTSAT / CFNAM_MPOTSAT / CFTYP_MPOTSAT : matric potential at saturation (m)

  • XUNIF_BCOEF / CFNAM_BCOEF / CFTYP_BCOEF : soil water CH78 b-parameter (-)

  • XUNIF_WSAT / CFNAM_WSAT / CFTYP_WSAT : porosity profile (m$^{3}$/m$^{3}$)

  • XUNIF_WFC / CFNAM_WFC / CFTYP_WFC : field capacity volumetric water content profile (m$^{3}$/m$^{3}$)

  • XUNIF_WWILT / CFNAM_WWILT / CFTYP_WWILT : wilting point volumetric water content profile (m/s)

  • NUNIF_VEG_IRR_USE : if LAGRIP or/and LIRRIGMODE are activated, corresponds to the number of vegetation types irrigated or/and with agricultural practices. By default if LECOCLIMAP-SG and LIRRIGMODE (with or without LAGRIP), it is (/5,7,12,16,17,18/) (temperate broadleaf deciduous, temperate broadleaf evergreen, shrubs, C3 winter crops, C3 summer crops and C4 crops. And with ECOCLIMAP, it is (/9/), the value of the NVT_IRR vegetation type.

  • XUNIF_IRRIGFREQ_CTYPE : values for the 3 types of irrigation respectively sprinkling dripping and flooding (s).

  • XUNIF_WATSUP_CTIME : water supply during irrigation process (mm)

  • XUNIF_F2THRESHOLD_CTIME : threshold for irrigation triggering

  • XUNIF_IRRIGTYPE_C : Type of irrigation (constant value for all irrigated type of vegetation). 0 for none, 1 for sprinkling, 2 for dripping and 3 for flooding.

  • XUNIF_IRRIGFRAC_C : Irrigation fraction (constant value for all irrigated type of vegetation).

  • XUNIF_IRRIGFREQ_C : minimum time between two irrigation triggers in s (constant value for all irrigated type of vegetation).

  • XUNIF_IRRIGTIME_C : duration of irrigation in s (constant value for all irrigated type of vegetation).

  • XUNIF_WATSUP_C : water supply during irrigation process in mm (constant value for all irrigated type of vegetation).

  • XUNIF_F2THRESHOLD_C : threshold for irrigation triggering (constant value for all irrigated type of vegetation).

  • XUNIF_SEED_M_C : seeding month and/or month of the beginning of irrigation (constant value for all irrigated type of vegetation)

  • XUNIF_SEED_D_C : seeding day and/or day of the beginning of irrigation (constant value for all irrigated type of vegetation)

  • XUNIF_REAP_M_C : reaping month and/or month corresponding 2 weeks after the end of irrigation (constant value for all irrigated type of vegetation)

  • XUNIF_REAP_D_C : reaping day and/or day corresponding 2 weeks after the end of irrigation (constant value for all irrigated type of vegetation)

  • XUNIF_SEED_S2_M_C : idem for a second season

  • XUNIF_SEED_S2_D_C : idem for a second season

  • XUNIF_REAP_S2_M_C : idem for a second season

  • XUNIF_REAP_S2_D_C : idem for a second season

  • XUNIF_SEED_S3_M_C : idem for a third season

  • XUNIF_SEED_S3_D_C : idem for a third season

  • XUNIF_REAP_S3_M_C : idem for a third season

  • XUNIF_REAP_S3_D_C : idem for a third season

  • XUNIF_SEED_D_DELTA : if date of irrigation are given with XUNIF the seeding date changes with a random value around the DELTA given here (in days)

  • XUNIF_REAP_D_DELTA : if date of irrigation are given with XUNIF the reaping date changes with a random value around the DELTA given here (in days)

  • XUNIF_SEED_S2_D_DELTA : idem for a second season (in days)

  • XUNIF_REAP_S2_D_DELTA : idem for a second season (in days)

  • XUNIF_SEED_S3_D_DELTA : idem for a third season (in days)

  • XUNIF_REAP_S3_D_DELTA : oden for a third season (in days)

NAM_DATA_TEB

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

NPAR_ROOF_LAYER

INTEGER

0

NPAR_WALL_LAYER

INTEGER

0

CBLD_ATYPE

CHARACTER(LEN=3)

‘MAJ’

CCSVFILEARCHI

CHARACTER(LEN=28)

‘ ‘

CCSVFILECOMPO

CHARACTER(LEN=28)

‘ ‘

NUNIF_BLDTYPE

INTEGER

none

CFNAM_BLDTYPE

CHARACTER(LEN=28)

‘ ‘

CFTYP_BLDTYPE

CHARACTER(LEN=6)

none

NUNIF_IND_BLD_AGE

INTEGER

none

CFNAM_IND_BLD_AGE

CHARACTER(LEN=28)

‘ ‘

CFTYP_IND_BLD_AGE

CHARACTER(LEN=6)

none

NUNIF_COL_BLD_AGE

INTEGER

none

CFNAM_COL_BLD_AGE

CHARACTER(LEN=28)

‘ ‘

CFTYP_COL_BLD_AGE

CHARACTER(LEN=6)

none

NUNIF_USETYPE

INTEGER

none

CFNAM_USETYPE

CHARACTER(LEN=28)

‘ ‘

CFTYP_USETYPE

CHARACTER(LEN=6)

none

NUNIF_P1TERRITORY

INTEGER

none

CFNAM_P1TERRITORY

CHARACTER(LEN=28)

‘ ‘

CFTYP_P1TERRITORY

CHARACTER(LEN=6)

none

NUNIF_PXTERRITORY

INTEGER

none

CFNAM_PXTERRITORY

CHARACTER(LEN=28)

‘ ‘

CFTYP_PXTERRITORY

CHARACTER(LEN=6)

none

XUNIF_FRACIHS

REAL

1E+20

CFNAM_FRACIHS

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACIHS

CHARACTER(LEN=6)

none

XUNIF_FRACCHS

REAL

1E+20

CFNAM_FRACCHS

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACCHS

CHARACTER(LEN=6)

none

XUNIF_FRACCOM

REAL

1E+20

CFNAM_FRACCOM

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACCOM

CHARACTER(LEN=6)

none

XUNIF_FRACTER

REAL

1E+20

CFNAM_FRACTER

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACTER

CHARACTER(LEN=6)

none

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_FRACIND

REAL

1E+20

CFNAM_FRACIND

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACIND

CHARACTER(LEN=6)

none

XUNIF_FRACNHE

REAL

1E+20

CFNAM_FRACNHE

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACNHE

CHARACTER(LEN=6)

none

XUNIF_FRACPAV

REAL

1E+20

CFNAM_FRACPAV

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACPAV

CHARACTER(LEN=6)

none

XUNIF_FRACMRI

REAL

1E+20

CFNAM_FRACMRI

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACMRI

CHARACTER(LEN=6)

none

XUNIF_FRACHRI

REAL

1E+20

CFNAM_FRACHRI

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACHRI

CHARACTER(LEN=6)

none

XUNIF_FRACATB

REAL

1E+20

CFNAM_FRACATB

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRACATB

CHARACTER(LEN=6)

none

XUNIF_FOEQI_MAIS

REAL

1E+20

CFNAM_FOEQI_MAIS

CHARACTER(LEN=28)

‘ ‘

CFTYP_FOEQI_MAIS

CHARACTER(LEN=6)

none

XUNIF_FOEQI_APPT

REAL

1E+20

CFNAM_FOEQI_APPT

CHARACTER(LEN=28)

‘ ‘

CFTYP_FOEQI_APPT

CHARACTER(LEN=6)

none

XUNIF_FAEQI_MAIS

REAL

1E+20

CFNAM_FAEQI_MAIS

CHARACTER(LEN=28)

‘ ‘

CFTYP_FAEQI_MAIS

CHARACTER(LEN=6)

none

XUNIF_FAEQI_APPT

REAL

1E+20

CFNAM_FAEQI_APPT

CHARACTER(LEN=28)

‘ ‘

CFTYP_FAEQI_APPT

CHARACTER(LEN=6)

none

XUNIF_CRE_MAIS

REAL

1E+20

CFNAM_CRE_MAIS

CHARACTER(LEN=28)

‘ ‘

CFTYP_CRE_MAIS

CHARACTER(LEN=6)

none

XUNIF_CRE_APPT

REAL

1E+20

CFNAM_CRE_APPT

CHARACTER(LEN=28)

‘ ‘

CFTYP_CRE_APPT

CHARACTER(LEN=6)

none

XUNIF_ALB_ROOF

REAL

none

CFNAM_ALB_ROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_ALB_ROOF

CHARACTER(LEN=6)

none

XUNIF_EMIS_ROOF

REAL

none

CFNAM_EMIS_ROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_EMIS_ROOF

CHARACTER(LEN=6)

none

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_HC_ROOF

REAL

none

CFNAM_HC_ROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_HC_ROOF

CHARACTER(LEN=6)

none

XUNIF_TC_ROOF

REAL

none

CFNAM_TC_ROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_TC_ROOF

CHARACTER(LEN=6)

none

XUNIF_D_ROOF

REAL

none

CFNAM_D_ROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_D_ROOF

CHARACTER(LEN=6)

none

XUNIF_ALB_ROAD

REAL

none

CFNAM_ALB_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_ALB_ROAD

CHARACTER(LEN=6)

none

XUNIF_EMIS_ROAD

REAL

none

CFNAM_EMIS_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_EMIS_ROAD

CHARACTER(LEN=6)

none

XUNIF_HC_COATING_ROAD

REAL

none

CFNAM_HC_COATING_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_HC_COATING_ROAD

CHARACTER(LEN=6)

none

XUNIF_TC_COATING_ROAD

REAL

none

CFNAM_TC_COATING_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_TC_COATING_ROAD

CHARACTER(LEN=6)

none

XUNIF_D_COATING_ROAD

REAL

none

CFNAM_D_COATING_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_D_COATING_ROAD

CHARACTER(LEN=6)

none

XUNIF_HC_BASEMENT_ROAD

REAL

none

CFNAM_HC_BASEMENT_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_HC_BASEMENT_ROAD

CHARACTER(LEN=6)

none

XUNIF_TC_BASEMENT_ROAD

REAL

none

CFNAM_TC_BASEMENT_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_TC_BASEMENT_ROAD

CHARACTER(LEN=6)

none

XUNIF_ALB_WALL

REAL

none

CFNAM_ALB_WALL

CHARACTER(LEN=28)

‘ ‘

CFTYP_ALB_WALL

CHARACTER(LEN=6)

none

XUNIF_EMIS_WALL

REAL

none

CFNAM_EMIS_WALL

CHARACTER(LEN=28)

‘ ‘

CFTYP_EMIS_WALL

CHARACTER(LEN=6)

none

XUNIF_HC_WALL

REAL

none

CFNAM_HC_WALL

CHARACTER(LEN=28)

‘ ‘

CFTYP_HC_WALL

CHARACTER(LEN=6)

none

XUNIF_TC_WALL

REAL

none

CFNAM_TC_WALL

CHARACTER(LEN=28)

‘ ‘

CFTYP_TC_WALL

CHARACTER(LEN=6)

none

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_D_WALL

REAL

none

CFNAM_D_WALL

CHARACTER(LEN=28)

‘ ‘

CFTYP_D_WALL

CHARACTER(LEN=6)

none

XUNIF_Z0_TOWN

REAL

none

CFNAM_Z0_TOWN

CHARACTER(LEN=28)

‘ ‘

CFTYP_Z0_TOWN

CHARACTER(LEN=6)

none

XUNIF_BLD

REAL

none

CFNAM_BLD

CHARACTER(LEN=28)

‘ ‘

CFTYP_BLD

CHARACTER(LEN=6)

none

XUNIF_ROAD

REAL

none

CFNAM_ROAD

CHARACTER(LEN=28)

‘ ‘

CFTYP_ROAD

CHARACTER(LEN=6)

none

XUNIF_BLD_HEIGHT

REAL

none

CFNAM_BLD_HEIGHT

CHARACTER(LEN=28)

‘ ‘

CFTYP_BLD_HEIGHT

CHARACTER(LEN=6)

none

XUNIF_WALL_O_HOR

REAL

none

CFNAM_WALL_O_HOR

CHARACTER(LEN=28)

‘ ‘

CFTYP_WALL_O_HOR

CHARACTER(LEN=6)

none

XUNIF_H_TRAFFIC

REAL

none

CFNAM_H_TRAFFIC

CHARACTER(LEN=28)

‘ ‘

CFTYP_H_TRAFFIC

CHARACTER(LEN=6)

none

XUNIF_LE_TRAFFIC

REAL

none

CFNAM_LE_TRAFFIC

CHARACTER(LEN=28)

‘ ‘

CFTYP_LE_TRAFFIC

CHARACTER(LEN=6)

none

XUNIF_H_INDUSTRY

REAL

none

CFNAM_H_INDUSTRY

CHARACTER(LEN=28)

‘ ‘

CFTYP_H_INDUSTRY

CHARACTER(LEN=6)

none

XUNIF_LE_INDUSTRY

REAL

none

CFNAM_LE_INDUSTRY

CHARACTER(LEN=28)

‘ ‘

CFTYP_LE_INDUSTRY

CHARACTER(LEN=6)

none

XUNIF_ROAD_DIR

REAL

1.E+20

CFNAM_ROAD_DIR

CHARACTER(LEN=28)

‘ ‘

CFTYP_ROAD_DIR

CHARACTER(LEN=6)

none

XUNIF_GREENROOF

REAL

1.E+20

CFNAM_GREENROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_GREENROOF

CHARACTER(LEN=6)

none

XUNIF_FRAC_HVEG

REAL

1.E+20

CFNAM_FRAC_HVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_HVEG

CHARACTER(LEN=6)

none

XUNIF_FRAC_LVEG

REAL

1.E+20

CFNAM_FRAC_LVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_LVEG

CHARACTER(LEN=6)

none

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XUNIF_FRAC_NVEG

REAL

1.E+20

CFNAM_FRAC_NVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_NVEG

CHARACTER(LEN=6)

none

XUNIF_ROUGH_ROOF

REAL

none

CFNAM_ROUGH_ROOF

CHARACTER(LEN=28)

‘ ‘

CFTYP_ROUGH_ROOF

CHARACTER(LEN=6)

none

XUNIF_ROUGH_WALL

REAL

none

CFNAM_ROUGH_WALL

CHARACTER(LEN=28)

‘ ‘

CFTYP_ROUGH_WALL

CHARACTER(LEN=6)

none

XUNIF_EMIS_PANEL

REAL

1.E+20

CFNAM_EMIS_PANEL

CHARACTER(LEN=28)

‘ ‘

CFTYP_EMIS_PANEL

CHARACTER(LEN=6)

none

XUNIF_ALB_PANEL

REAL

1.E+20

CFNAM_ALB_PANEL

CHARACTER(LEN=28)

‘ ‘

CFTYP_ALB_PANEL

CHARACTER(LEN=6)

none

XUNIF_EFF_PANEL

REAL

1.E+20

CFNAM_EFF_PANEL

CHARACTER(LEN=28)

‘ ‘

CFTYP_EFF_PANEL

CHARACTER(LEN=6)

none

XUNIF_FRAC_PANEL

REAL

1.E+20

CFNAM_FRAC_PANEL

CHARACTER(LEN=28)

‘ ‘

CFTYP_FRAC_PANEL

CHARACTER(LEN=6)

none

XUNIF_NB_POP

REAL

0.0

CFNAM_NB_POP

CHARACTER(LEN=28)

‘ ‘

CFTYP_NB_POP

CHARACTER(LEN=6)

none

XUNIF_SFCO2_RD

REAL

0.0

CFNAM_SFCO2_RD

CHARACTER(LEN=28)

‘ ‘

CFTYP_SFCO2_RD

CHARACTER(LEN=6)

none

XUNIF_DELTA_LEGAL_TIME

REAL

1.E+20

CFNAM_DELTA_LEGAL_TIME

CHARACTER(LEN=28)

‘ ‘

CFTYP_DELTA_LEGAL_TIME

CHARACTER(LEN=6)

none

XUNIF_TIME_OF_CHANGE

REAL

1.E+20

XPAR_POP_MONTHLY

REAL(12)

(/1,1,1,1,1,

1,1,1,1,

1,1,1,1/)

XPAR_POP_DAILY

REAL(7)

(/1,1,1,1,

1,1,1/)

1,1,1/)

XPAR_POP_HOURLY

REAL(24)

(/1,1,1,1,

1,1,1,1,

1,1,1,1,

1,1,1,1,

1,1,1,1,

1,1,1,1/)

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Name

TYPE

Default

XPAR_TRAF_MONTHLY

REAL(12)

(/1,1,1,1,1,1,1,1,1,1,1,1/)

XPAR_TRAF_DAILY

REAL(7)

(/1.05,1.07,1.08,1.09,1.15,0.86,0.7/)

XPAR_TRAF_HOURLY

REAL(24)

(/(12/33),(12/33),(12/33),(12/33),

(12/33),(12/33),(12/33),(48/33),

(48/33),(48/33),(48/33),(48/33),

(48/33),(48/33),(48/33),(48/33),

(48/33),(48/33),(48/33),(48/33),

(48/33),(12/33),(12/33),(12/33),

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Identifier

NAME

1

DETACHED LOW-RISE

2

SEMI-DETACHED LOW-RISE

3

ROWS OF OPEN LOW-RISE

4

BLOCKS OF OPEN LOW-RISE

5

OPEN MID-RISE

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Identifier

BUILDING USE

Identifier

1

AGRICULTURE

8

2

CASTLE

9

3

COMMERCE

10

4

COLLECTIVE HOUSING

11

5

INDIVIDUAL HOUSING

12

6

INDUSTRIAL

13

7

NON HEATED

NAM_DATA_TEB content

Fortran name

Fortran type

Default value

Identifier

NAME

Name

1

FRANCE

FRANCE_PIERRE_GALET_TUILE

2

FRANCE_BRIQUE

FRANCE_PIERRE_MEULIERE_TUILE

3

FRANCE_PIERRE

FRANCE_PIERRE_SCHISTE_TUILE

4

FRANCE_PIERRE_CALCAIRE

FRANCE_PIERRE_GNEISS_TUILE

5

FRANCE_PIERRE_CALCAIRE_ARDOISE

FRANCE_PIERRE_VOLCANIQUE_ARDOISE

6

FRANCE_PIERRE_CALCAIRE_ZINC

FRANCE_BOIS_TUILE

7

FRANCE_PIERRE_GRES_TUILE

FRANCE_BOIS_ARDOISE

8

FRANCE_PIERRE_GRES_ARDOISE

FRANCE_TERRE_TUILE

9

FRANCE_PIERRE_GRANITE_TUILE

FRANCE_BRIQUE_TUILE

10

FRANCE_PIERRE_GRANITE_ARDOISE

  • NPAR_ROOF_LAYER : number of layers in roofs (-)

  • NPAR_WALL_LAYER : number of layers in walls (-)

  • CBLD_ATYPE : type of averaging for building (-)

    • ‘MAJ’: majoritary building in grid mesh is chosen

    • ‘ARI’: characteristics are linearly averaged

  • CCSVFILEARCHI : name of the .csv file containing information on building construction materials. The following parameters can be initialised via the MApUCE architectural tables (CCSVFILEARCHI ). Most of these parameters did already exist in previous versions of TEB. In the case one of these parameters is specified via the namelist (XUNIF_...), this entry is prioritised with respect to the entries in the architectural tables. Care is therefore needed during namelist construction.

    • Road properties (ALB_ROAD; EMIS_ROAD; HC_ROAD; TC_ROAD; D_ROAD)

    • Roof properties (ALB_ROOF; EMIS_ROOF; HC_ROOF; TC_ROOF; D_ROOF)

    • Wall properties (ALB_WALL; EMIS_WALL; HC_WALL; TC_WALL; D_WALL)

    • Ground floor properties (HC_FLOOR; TC_FLOOR; D_FLOOR)

    • Thermal mass properties (HC_MASS; TC_MASS; D_MASS)

    • Flag for presence of internal mass (ISMASS)

    • Window properties (GR; U_WIN; SHGC; SHGC_SH

    • Solar panel properties (ALB_PANEL; EMIS_PANEL; EFF_PANEL; FRAC_PANEL)

    • Airtightness (N50)

    • Flag for presence of shading elements (SHADEARCHI)

    • Flag for presence of mechanical ventilation (ISMECH)

    • Air exchange rate due to mechanical ventilation (MECHRATE)

    • Fraction of green roofs (GREENROOF)

  • CCSVFILECOMPO : name of the .csv file containing information on human behaviours as a function of building use. The following parameters can be initialised via the MApUCE behavioural table (CCSVFILECOMPO ). If one of these parameters is specified via the namelist (XUNIF_...), this entry is prioritised with respect to the entries in the behavioural table. Care is therefore needed during namelist construction.

    • Schedules of building occupation (DAYWBEG_SCHED ; HOURBEG_SCHED)

    • Probability of building occupation (PROBOCC)

    • Holiday periods (BEG_HOLIDAY ; END_HOLIDAY ; MOD_HOLIDAY)

    • Design temperature for heating (THEAT...)

    • Design temperature and relative humidity for air conditioning (TCOOL... ; HR_TARGET)

    • Fraction of evaporative air conditioning systems (F_WATER_COND)

    • Fraction of waste heat to the street canyon (F_WASTE_CAN)

    • Rated COP of air conditioning system (COP_RAT)

    • Internal heat release (QIN ; QIN_FRAD ; QIN_FLAT ; MODQIN_VCD ; MODQIN_VLD ; MODQIN_NIG ; HOTWAT)

    • Ventilation (NATVENT ; FVSUM ; FVVAC ; FVNIG ; FOPEN)

    • Shading (FSSUM ; FSVAC ; FSNIG ; WIN_SW_MAX)

  • NUNIF_BLDTYPE / CFNAM_BLDTYPE / CFTYP_BLDTYPE : identifier for building type \ \

  • NUNIF_IND_BLD_AGE / CFNAM_IND_BLD_AGE / CFTYP_IND_BLD_AGE : identifier for construction period of buildings with individual housing use

  • NUNIF_COL_BLD_AGE / CFNAM_COL_BLD_AGE / CFTYP_COL_BLD_AGE : identifier for construction period of buildings (collective housing) \ \

  • NUNIF_USETYPE / CFNAM_USETYPE / CFTYP_USETYPE : Identifier for building use \ \

  • NUNIF_P1TERRITORY / CFNAM_P1TERRITORY / CFTYP_P1TERRITORY : Identifier for construction material of historical buildings (before 1948). The P1 territory describes the dominant construction materials for historical buildings (construction period P1). For P1, there is a large variety of materials used for the walls. The identifiers 4 to 19 are related to the P1 territory. (see table below)

  • NUNIF_PXTERRITORY / CFNAM_PXTERRITORY / CFTYP_PXTERRITORY : Identifier for construction material of recent buildings (after 1948). The PX territory describes the dominant construction material for the more recent buildings. The identifiers 1 to 3 are related to the PX territory. (see table below) \ \

  • XUNIF_FRACIHS / CFNAM_FRACIHS / CFTYP_FRACIHS : individual housing fraction

  • XUNIF_FRACCHS / CFNAM_FRACCHS / CFTYP_FRACCHS : collective housing fraction

  • XUNIF_FRACCOM / CFNAM_FRACCOM / CFTYP_FRACCOM : fraction of commercial building use

  • XUNIF_FRACTER / CFNAM_FRACTER / CFTYP_FRACTER : fraction of tertiary building use

  • XUNIF_FRACIND / CFNAM_FRACIND / CFTYP_FRACIND : fraction of industrial building use

  • XUNIF_FRACNHE / CFNAM_FRACNHE / CFTYP_FRACNHE : fraction of non heated buildings

  • XUNIF_FRACPAV / CFNAM_FRACPAV / CFTYP_FRACPAV : fraction of low-rise building types

  • XUNIF_FRACMRI / CFNAM_FRACMRI / CFTYP_FRACMRI : fraction of mid-rise building types

  • XUNIF_FRACHRI / CFNAM_FRACHRI / CFTYP_FRACHRI : fraction of high-rise building types

  • XUNIF_FRACATB / CFNAM_FRACATB / CFTYP_FRACATB : fraction of activity buildings

  • XUNIF_FOEQI_MAIS / CFNAM_FOEQI_MAIS / CFTYP_FOEQI_MAIS : fraction of strong equipment and use in individual housing (-)

  • XUNIF_FOEQI_APPT / CFNAM_FOEQI_APPT / CFTYP_FOEQI_APPT : fraction of strong equipment and use in collective housing (-)

  • XUNIF_FAEQI_MAIS / CFNAM_FAEQI_MAIS / CFTYP_FAEQI_MAIS : fraction of weak equipment and use in individual housing (-)

  • XUNIF_FAEQI_APPT / CFNAM_FAEQI_APPT / CFTYP_FAEQI_APPT : fraction of weak equipment and use in collective housing (-)

  • XUNIF_CRE_MAIS / CFNAM_CRE_MAIS / CFTYP_CRE_MAIS : fraction of high regulation in individual housing (-)

  • XUNIF_CRE_APPT / CFNAM_CRE_APPT / CFTYP_CRE_APPT : fraction of high regulation in collective housing (-)

  • XUNIF_ALB_ROOF / CFNAM_ALB_ROOF / CFTYP_ALB_ROOF : roof albedo (-)

  • XUNIF_EMIS_ROOF / CFNAM_EMIS_ROOF / CFTYP_EMIS_ROOF : roof emissivity (-)

  • XUNIF_HC_ROOF / CFNAM_HC_ROOF / CFTYP_HC_ROOF : roof layers heat capacity (J/K/m$^{3}$)

  • XUNIF_TC_ROOF / CFNAM_TC_ROOF / CFTYP_TC_ROOF : roof layers thermal conductivity (W/K/m)

  • XUNIF_D_ROOF / CFNAM_D_ROOF / CFTYP_D_ROOF : roof layers depth (m)

  • XUNIF_ALB_ROAD / CFNAM_ALB_ROAD / CFTYP_ALB_ROAD : road albedo (-)

  • XUNIF_EMIS_ROAD / CFNAM_EMIS_ROAD / CFTYP_EMIS_ROAD : road emissivity (-)

  • XUNIF_HC_COATING_ROAD / CFNAM_HC_COATING_ROAD / \

  • XUNIF_TC_COATING_ROAD / CFNAM_TC_COATING_ROAD / \

  • XUNIF_D_COATING_ROAD / CFNAM_D_COATING_ROAD / \

  • XUNIF_HC_BASEMENT_ROAD / CFNAM_HC_BASEMENT_ROAD / \

  • XUNIF_TC_BASEMENT_ROAD / CFNAM_TC_BASEMENT_ROAD / \

  • XUNIF_ALB_WALL / CFNAM_ALB_WALL / CFTYP_ALB_WALL : wall albedo (-)

  • XUNIF_EMIS_WALL / CFNAM_EMIS_WALL / CFTYP_EMIS_WALL : wall emissivity (-)

  • XUNIF_HC_WALL / CFNAM_HC_WALL / CFTYP_HC_WALL : wall layers heat capacity (J/K/m$^{3}$)

  • XUNIF_XUNIF_TC_WALL / CFNAM_XUNIF_TC_WALL / CFTYP_XUNIF_TC_WALL : wall layers thermal conductivity (W/K/m)

  • XUNIF_D_WALL / CFNAM_D_WALL / CFTYP_D_WALL : wall layers depth (m)

  • XUNIF_Z0_TOWN / CFNAM_Z0_TOWN / CFTYP_Z0_TOWN : roughness length for momentum (m)

  • XUNIF_BLD / CFNAM_BLD / CFTYP_BLD : fraction of buildings (-)

  • XUNIF_ROAD / CFNAM_ROAD / CFTYP_ROAD : fraction of road (-)

  • XUNIF_BLD_HEIGHT / CFNAM_BLD_HEIGHT / CFTYP_BLD_HEIGHT : buildings height (m)

  • XUNIF_WALL_O_HOR / CFNAM_WALL_O_HOR / CFTYP_WALL_O_HOR : ratio between facade and urban horizontal surface (-)

  • XUNIF_H_TRAFFIC / CFNAM_H_TRAFFIC / CFTYP_H_TRAFFIC : anthropogenic sensible heat fluxes due to traffic (W/m$^{2}$)

  • XUNIF_LE_TRAFFIC / CFNAM_LE_TRAFFIC / CFTYP_LE_TRAFFIC : anthropogenic latent heat fluxes due to traffic (W/m$^{2}$)

  • XUNIF_H_INDUSTRY / CFNAM_H_INDUSTRY / CFTYP_H_INDUSTRY : anthropogenic sensible heat fluxes due to factories (W/m$^{2}$)

  • XUNIF_LE_INDUSTRY / CFNAM_LE_INDUSTRY / CFTYP_LE_INDUSTRY : anthropogenic latent heat fluxes due to factories (W/m$^{2}$)

  • XUNIF_ROAD_DIR / CFNAM_ROAD_DIR / CFTYP_ROAD_DIR : road direction (in degrees from North clockwise)

  • XUNIF_GREENROOF / CFNAM_GREENROOF / CFTYP_GREENROOF : fraction of greenroofs on roofs (-)

  • XUNIF_FRAC_HVEG / CFNAM_FRAC_HVEG / CFTYP_FRAC_HVEG : fraction of high vegetation (-)

  • XUNIF_FRAC_LVEG / CFNAM_FRAC_LVEG / CFTYP_FRAC_LVEG : fraction of low vegetation (-)

  • XUNIF_FRAC_NVEG / CFNAM_FRAC_NVEG / CFTYP_FRAC_NVEG : fraction of bare soil (-)

  • XUNIF_ROUGH_ROOF / CFNAM_ROUGH_ROOF / CFTYP_ROUGH_ROOF : roof roughness coefficient

  • XUNIF_ROUGH_WALL / CFNAM_ROUGH_WALL / CFTYP_ROUGH_WALL : wall roughness coefficient

  • XUNIF_EMIS_PANEL / CFNAM_EMIS_PANEL / CFTYP_EMIS_PANEL : emissivity of solar panel

  • XUNIF_ALB_PANEL / CFNAM_ALB_PANEL / CFTYP_ALB_PANEL : albedo of solar panel

  • XUNIF_EFF_PANEL / CFNAM_EFF_PANEL / CFTYP_EFF_PANEL : efficiency of solar panel

  • XUNIF_FRAC_PANEL / CFNAM_FRAC_PANEL / CFTYP_FRAC_PANEL : fraction of solar panel

  • XUNIF_NB_POP / CFNAM_NB_POP / CFTYP_NB_POP : population density (1/km$^{2}$)

  • XUNIF_SFCO2_RD / CFNAM_SFCO2_RD / CFTYP_SFCO2_RD : CO$_{2}$ flux due to traffic (kg/s/m$^{2}$)

  • XUNIF_DELTA_LEGAL_TIME / CFNAM_DELTA_LEGAL_TIME / \

  • XUNIF_TIME_OF_CHANGE : time of time change of the legal hour

  • XUNIF_POP_MONTHLY : monthly cycle of inhabitants density

  • XUNIF_POP_DAILY : daily cycle of inhabitants density

  • XUNIF_POP_HOURLY : hourly cycle of inhabitants density

  • XUNIF_TRAF_MONTHLY : monthly cycle of traffic

  • XUNIF_TRAF_DAILY : daily cycle of traffic

  • XUNIF_TRAF_HOURLY : hourly cycle of traffic

NAM_DATA_TEB_GARDEN

NAM_DATA_TEB_GARDEN content

Fortran name

Fortran type

Default value

NTIME_GD

INTEGER

12

CTYP_GARDEN_HVEG

CHARACTER(LEN=4)

‘TEBD’

CTYP_GARDEN_LVEG

CHARACTER(LEN=4)

‘GRAS’

CTYP_GARDEN_NVEG

CHARACTER(LEN=4)

‘NO’

CSHAPE_GARDEN_NVEG

CHARACTER(LEN=3)

‘CYL’

XUNIF_LAI_HVEG

REAL

1.E+20

CFNAM_LAI_HVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_LAI_HVEG

CHARACTER(LEN=28)

‘ ‘

XUNIF_LAI_LVEG

REAL

1.E+20

CFNAM_LAI_LVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_LAI_LVEG

CHARACTER(LEN=28)

‘ ‘

XUNIF_H_HVEG

REAL

1.E+20

CFNAM_H_HVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_H_HVEG

CHARACTER(LEN=28)

‘ ‘

XUNIF_HTRUNK_HVEG

REAL

3.0

CFNAM_HTRUNK_HVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_HTRUNK_HVEG

CHARACTER(LEN=28)

‘ ‘

XUNIF_WCROWN_HVEG

REAL

5.0

CFNAM_WCROWN_HVEG

CHARACTER(LEN=28)

‘ ‘

CFTYP_WCROWN_HVEG

CHARACTER(LEN=28)

‘ ‘

XUNIF_RE25

REAL

1E+20

CFNAM_RE25

CHARACTER(LEN=28)

‘ ‘

CFTYP_RE25

CHARACTER(LEN=28)

‘ ‘

  • NTIME_GD : time dimension

  • CTYP_GARDEN_HVEG : type of high vegetation

  • CTYP_GARDEN_LVEG : type of low vegetation

  • CTYP_GARDEN_NVEG : type of bare soil

  • CSHAPE_GARDEN_NVEG : shape of crown for urban trees. For the moment, only cylindric shape of crown ‘CYL’is available.

  • XUNIF_LAI_HVEG / CFNAM_LAI_HVEG / CFTYP_LAI_HVEG : LAI of high vegetation (m$^{2}$/m$^{2}$)

  • XUNIF_LAI_LVEG / CFNAM_LAI_LVEG / CFTYP_LAI_LVEG : LAI of low vegetation (m$^{2}$/m$^{2}$)

  • XUNIF_H_HVEG / CFNAM_H_HVEG / CFTYP_H_HVEG : height of trees (m)

  • XUNIF_HTRUNK_HVEG / CFNAM_HTRUNK_HVEG / CFTYP_HTRUNK_HVEG : height of trunk of trees (m)

  • XUNIF_WCROWN_HVEG / CFNAM_WCROWN_HVEG / CFTYP_WCROWN_HVEG : width of crown of trees (m)

  • XUNIF_RE25 / CFNAM_RE25 / CFTYP_RE25 : ecosystem respiration parameter (kg/m$^{2}$/s)

NAM_DATA_TEB_GREENROOF

NAM_DATA_TEB_GREENROOF content

Fortran name

Fortran type

Default value

NTIME_GR

INTEGER

1

NLAYER_GR

INTEGER

6

CTYP_GR

CHARACTER(LEN=5)

‘GRASS’

XUNIF_OM_GR

REAL,DIMENSION(NLAYER_GR)

1.E+20

XUNIF_CLAY_GR

REAL,DIMENSION(NLAYER_GR)

1.E+20

XUNIF_SAND_GR

REAL,DIMENSION(NLAYER_GR)

1.E+20

XUNIF_LAI_GR

REAL,DIMENSION(NTIME_GR)

1.E+20

CFNAM_OM_GR

CHARACTER(LEN=28),DIM(NLAYER_GR)

‘’

CFNAM_CLAY_GR

CHARACTER(LEN=28),DIM(NLAYER_GR)

‘’

CFNAM_SAND_GR

CHARACTER(LEN=28),DIM(NLAYER_GR)

‘’

CFNAM_LAI_GR

CHARACTER(LEN=28),DIM(NTIME_GR)

‘’

CFTYP_OM_GR

CHARACTER(LEN=6),DIM(NLAYER_GR)

‘’

CFTYP_CLAY_GR

CHARACTER(LEN=6),DIM(NLAYER_GR)

‘’

CFTYP_SAND_GR

CHARACTER(LEN=6),DIM(NLAYER_GR)

‘’

CFTYP_LAI_GR

CHARACTER(LEN=6),DIM(NTIME_GR)

‘’

  • NTIME_GR : time dimension (1=uniform LAI / 12=monthly LAI)

  • NLAYER_GR : number of layers in greenroofs

  • CTYP_GR : type of vegetation for greenroofs

    • ‘GRASS’: Grasses - graminoïds

    • ‘SEDUM’: Sedum (succulent plants)

  • XUNIF_OM_GR / CFNAM_OM_GR / CFTYP_OM_GR : fraction of organic matter in greenroof layer

  • XUNIF_CLAY_GR / CFNAM_CLAY_GR / CFTYP_CLAY_GR : fraction of clay for the non-OM part of the green roof layer

  • XUNIF_SAND_GR / CFNAM_SAND_GR / CFTYP_SAND_GR : fraction of sand for the non-OM part of the green roof layer

  • XUNIF_LAI_GR / CFNAM_LAI_GR / CFTYP_LAI_GR : LAI of green roof vegetation (m$^{2}$/m$^{2}$)

NAM_DATA_TEB_HYDRO

NAM_DATA_TEB_HYDRO content

Fortran name

Fortran type

Default value

XUNIF_DENS_WASTE

REAL

1.E+20

CFNAM_DENS_WASTE

CHARACTER(LEN=28)

CFTYP_DENS_WASTE

CHARACTER(LEN=6)

XUNIF_DENS_STORM

REAL

1.E+20

CFNAM_DENS_STORM

CHARACTER(LEN=28)

CFTYP_DENS_STORM

CHARACTER(LEN=6)

XUNIF_DSEWER

REAL

1.E+20

CFNAM_DSEWER

CHARACTER(LEN=28)

CFTYP_DSEWER

CHARACTER(LEN=6)

XUNIF_WS_ROOF_MAX

REAL

1

CFNAM_WS_ROOF_MAX

CHARACTER(LEN=28)

CFTYP_WS_ROOF_MAX

CHARACTER(LEN=6)

XUNIF_WS_ROAD_MAX

REAL

1

CFNAM_WS_ROAD_MAX

CHARACTER(LEN=28)

CFTYP_WS_ROAD_MAX

CHARACTER(LEN=6)

XUNIF_IP_SEWER

REAL

0

CFNAM_IP_SEWER

CHARACTER(LEN=28)

CFTYP_IP_SEWER

CHARACTER(LEN=6)

XUNIF_CONNEX

REAL

1

CFNAM_CONNEX

CHARACTER(LEN=28)

CFTYP_CONNEX

CHARACTER(LEN=6)

XUNIF_INFIL_ROAD

REAL

0

CFNAM_INFIL_ROAD

CHARACTER(LEN=28)

CFTYP_INFIL_ROAD

CHARACTER(LEN=6)

XUNIF_URBDRAIN

REAL

0

CFNAM_URBDRAIN

CHARACTER(LEN=28)

CFTYP_URBDRAIN

CHARACTER(LEN=6)

  • XUNIF_DENS_WASTE / CFNAM_DENS_WASTE / CFTYP_DENS_WASTE : wastewater sewer length density (-)

  • XUNIF_DENS_STORM / CFNAM_DENS_STORM / CFTYP_DENS_STORM : tormwater sewer length density (-)

  • XUNIF_DSEWER / CFNAM_DSEWER / CFTYP_DSEWER : waste water sewer depth (m)

  • XUNIF_WS_ROOF_MAX / CFNAM_WS_ROOF_MAX / CFTYP_WS_ROOF_MAX : maximum capacity of surface roof water storage (mm)

  • XUNIF_WS_ROAD_MAX / CFNAM_WS_ROAD_MAX / CFTYP_WS_ROAD_MAX : maximum capacity of surface road water storage (mm)

  • XUNIF_IP_SEWER / CFNAM_IP_SEWER / CFTYP_IP_SEWER : parasite infiltrations into sewer (-)

  • XUNIF_CONNEX / CFNAM_CONNEX/ CFTYP_CONNEX : impervious surfaces connexion rate to the sewer (-)

  • XUNIF_INFIL_ROAD / CFNAM_INFIL_ROAD / CFTYP_INFIL_ROAD : water infiltration through the roads (kg/m$^{2}$/s)

  • XUNIF_URBDRAIN / CFNAM_URBDRAIN / CFTYP_URBDRAIN : limitation fraction of urban deep drainage (-)

NAM_ECOCLIMAP2

NAM_ECOCLIMAP2 content

Fortran name

Fortran type

Default value

LCLIM_LAI

LOGICAL

T

YIRRIG

CHARACTER(LEN=28)

‘ ‘

  • LCLIM_LAI : if T, climatological LAI is computed otherwise, the LAI corresponding to current year (if between 2002 and 2006) is used.

  • YIRRIG : irrigation file name

NAM_FRAC

NAM_FRAC content

Fortran name

Fortran type

Default value

LECOCLIMAP

LOGICAL

T

LECOSG

LOGICAL

F

XUNIF_SEA

REAL

none

CFNAM_SEA

CHARACTER(LEN=28)

‘ ‘

CFTYP_SEA

CHARACTER(LEN=6)

none

XUNIF_WATER

REAL

none

CFNAM_WATER

CHARACTER(LEN=28)

‘ ‘

CFTYP_WATER

CHARACTER(LEN=6)

none

XUNIF_NATURE

REAL

none

CFNAM_NATURE

CHARACTER(LEN=28)

‘ ‘

CFTYP_NATURE

CHARACTER(LEN=6)

none

XUNIF_TOWN

REAL

none

CFNAM_TOWN

CHARACTER(LEN=28)

‘ ‘

CFTYP_TOWN

CHARACTER(LEN=6)

‘ ‘

  • LECOCLIMAP : flag to use ECOCLIMAP or not. From version 7.1, it’s possible to partially use ECOCLIMAP to complete missing parameters when they are given directly in the namelist.

  • LECOSG : flag to use ECOCLIMAP-SG database (from SURFEX 8.1)

  • XUNIF_SEA : uniform prescribed value of sea fraction. If XUNIF_SEA is set, file CFNAM_SEA is not used.

  • CFNAM_SEA : sea fraction data file name. If XUNIF_SEA is set, file CFNAM_SEA is not used.

  • CFTYP_SEA : type of sea data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_WATER : uniform prescribed value of water fraction. If XUNIF_WATER is set, file CFNAM_WATER is not used.

  • CFNAM_WATER : water fraction data file name. If XUNIF_WATER is set, file CFNAM_WATER is not used.

  • CFTYP_WATER : type of water data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_NATURE : uniform prescribed value of nature fraction. If XUNIF_NATURE is set, file CFNAM_NATURE is not used.

  • CFNAM_NATURE : nature fraction data file name. If XUNIF_NATURE is set, file \

  • CFTYP_NATURE : type of nature data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

  • XUNIF_TOWN : uniform prescribed value of town fraction. If XUNIF_TOWN is set, file CFNAM_TOWN is not used.

  • CFNAM_TOWN : town fraction data file name. If XUNIF_TOWN is set, file CFNAM_TOWN is not used.

  • CFTYP_TOWN : type of town data file (‘DIRECT’, ‘BINLLF’, ‘BINLLV’, ‘ASCLLV’)

NAM_READ_DATA_COVER

NAM_READ_DATA_COVER content

Fortran name

Fortran type

Default value

LREAD_DATA_COVER

LOGICAL

F

  • :code:`` : LREAD_DATA_COVER: if T, covers data are read in .bin files; if F, in fortran routines