Tip

  1. Need help? Please let us know in the UMEP Community.

  2. Please report issues with the manual on the GitHub Issues.

  3. Please cite SUEWS with proper information from our Zenodo page.

2.2.11. SUEWS_Veg.txt

SUEWS_Veg.txt specifies the characteristics for the vegetated surface cover types (EveTr, DecTr, Grass) by linking codes in column 1 of SUEWS_Veg.txt to the codes specified in SUEWS_SiteSelect.txt (Code_EveTr, Code_DecTr, Code_Grass). Each row should correspond to a particular surface type. For suggestions on how to complete this table, see: Typical Values.

No.

Column Name

Use

Description

1

Code

L

Code linking to a corresponding look-up table.

2

AlbedoMin

MU

Effective surface albedo (middle of the day value) for wintertime (not including snow).

3

AlbedoMax

MU

Effective surface albedo (middle of the day value) for summertime.

4

Emissivity

MU

Effective surface emissivity.

5

StorageMin

MD

Minimum water storage capacity for upper surfaces (i.e. canopy).

6

StorageMax

MD

Maximum water storage capacity for upper surfaces (i.e. canopy)

7

WetThreshold

MD

Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface [mm].

8

StateLimit

MD

Upper limit to the surface state. [mm]

9

DrainageEq

MD

Calculation choice for Drainage equation

10

DrainageCoef1

MD

Coefficient D0 [mm h-1] used in DrainageEq

11

DrainageCoef2

MD

Coefficient b [-] used in DrainageEq

12

SoilTypeCode

L

Code for soil characteristics below this surface linking to Code of SUEWS_Soil.txt

13

SnowLimPatch

O

Limit for the snow water equivalent when snow cover starts to be patchy [mm]

14

BaseT

MU

Base Temperature for initiating growing degree days (GDD) for leaf growth. [°C]

15

BaseTe

MU

Base temperature for initiating sensesance degree days (SDD) for leaf off. [°C]

16

GDDFull

MU

The growing degree days (GDD) needed for full capacity of the leaf area index (LAI) [°C].

17

SDDFull

MU

The sensesence degree days (SDD) needed to initiate leaf off. [°C]

18

LAIMin

MD

leaf-off wintertime value

19

LAIMax

MD

full leaf-on summertime value

20

PorosityMin

MD

leaf-off wintertime value Used only for DecTr (can affect roughness calculation)

21

PorosityMax

MD

full leaf-on summertime value Used only for DecTr (can affect roughness calculation)

22

MaxConductance

MD

The maximum conductance of each vegetation or surface type. [mm s-1]

23

LAIEq

MD

LAI calculation choice.

24

LeafGrowthPower1

MD

a parameter required by LAI calculation in LAIEq

25

LeafGrowthPower2

MD

a parameter required by LAI calculation [K-1] in LAIEq

26

LeafOffPower1

MD

a parameter required by LAI calculation [K-1] in LAIEq

27

LeafOffPower2

MD

a parameter required by LAI calculation [K-1] in LAIEq

28

OHMCode_SummerWet

L

Code for OHM coefficients to use for this surface during wet conditions in summer, linking to SUEWS_OHMCoefficients.txt.

29

OHMCode_SummerDry

L

Code for OHM coefficients to use for this surface during dry conditions in summer, linking to SUEWS_OHMCoefficients.txt.

30

OHMCode_WinterWet

L

Code for OHM coefficients to use for this surface during wet conditions in winter, linking to SUEWS_OHMCoefficients.txt.

31

OHMCode_WinterDry

L

Code for OHM coefficients to use for this surface during dry conditions in winter, linking to SUEWS_OHMCoefficients.txt.

32

OHMThresh_SW

MD

Temperature threshold determining whether summer/winter OHM coefficients are applied [°C]

33

OHMThresh_WD

MD

Soil moisture threshold determining whether wet/dry OHM coefficients are applied [-]

34

ESTMCode

L

Code for ESTM coefficients linking to SUEWS_ESTMCoefficients.txt

35

AnOHM_Cp

MU

Volumetric heat capacity for this surface to use in AnOHM [J m-3]

36

AnOHM_Kk

MU

Thermal conductivity for this surface to use in AnOHM [W m K-1]

37

AnOHM_Ch

MU

Bulk transfer coefficient for this surface to use in AnOHM [-]

38

BiogenCO2Code

MU

Code linking to the Code column in SUEWS_BiogenCO2.txt.

An example SUEWS_Veg.txt can be found below:

1        2           3           4               5               6               7               8               9               10              11              12              13              14      15          16          17          18          19          20              21              22                  23      24                  25                  26              27              28                  29                  30                  31                  32              33              34          35          36          37       38
Code     AlbedoMin   AlbedoMax   Emissivity      StorageMin      StorageMax      WetThreshold    StateLimit      DrainageEq      DrainageCoef1   DrainageCoef2   SoilTypeCode    SnowLimPatch    BaseT   BaseTe      GDDFull     SDDFull     LAIMin      LAIMax      PorosityMin     PorosityMax     MaxConductance   LAIEq      LeafGrowthPower1    LeafGrowthPower2    LeafOffPower1   LeafOffPower2   OHMCode_SummerWet   OHMCode_SummerDry   OHMCode_WinterWet   OHMCode_WinterDry   OHMThresh_SW    OHMThresh_WD    ESTMCode    AnOHM_Cp    AnOHM_Kk    AnOHM_Ch BiogenCO2Code
300      0.1         0.1         0.98            1.3             1.3             1.3             1.3             2               0.013           1.71            70              190             5       10          300         -450        4           5.1         -999            -999            7.4                 1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             200         1000000     1.2         4        21                 !   ET      Helsinki    Jarvi et al  (2014)
330      0.16        0.16        0.98            0.3             0.8             0.8             0.8             2               0.013           1.71            70              190             5       10          300         -450        1           5.5         0.2             0.6             11.7                1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             200         1000000     1.2         4        21                 !   DT      Helsinki    Jarvi et al  (2014)
360      0.19        0.19        0.93            1.9             1.9             1.9             1.9             3               10              3               70              190             5       10          300         -450        1.6         5.9         -999            -999            40                  1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             200         1000000     1.2         4        21                 !   IG      Helsinki    Jarvi et al  (2014)
361      0.19        0.19        0.93            1.9             1.9             1.9             1.9             2               0.13            1.71            70              190             5       10          300         -450        1.6         5.9         -999            -999            33.1                1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             200         1000000     1.2         4        21                 !   UG      Helsinki    Jarvi et al  (2014)
551      0.1         0.1         0.98            1.3             1.3             1.8             1.3             2               0.013           1.71            553             -999            6       11          300         -450        4           5.1         -999            -999            7.4                 1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             810         1000000     1.2         4        11                 !   EveTr   Swindon     Ward  et al. (2013)
552      0.12        0.18        0.98            0.3             0.8             1               0.8             2               0.013           1.71            553             -999            6       11          300         -450        1           5.5         0.2             0.6             11.7                1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             811         1000000     1.2         4        11                 !   DecTr   Swindon     Ward  et al. (2013)
553      0.18        0.21        0.93            1.9             1.9             2               1.9             2               0.013           1.71            553             -999            6       11          300         -450        1.6         5.9         -999            -999            33.1                1       0.04                0.001               -1.5            0.0015          200                 200                 200                 200                 10              0.9             812         1000000     1.2         4        11                 !   Grass   Swindon     Ward  et al. (2013)
661      0.11        0.12        0.98            1.3             1.3             1.3             1.3             2               0.013           1.71            661             120             5       11          300         -450        4           5.1         -999            -999            7.4                 0       0.03                0.0005              0.03            0.0005          200                 200                 200                 200                 10              0.9             810         1000000     1.2         4        11                 !   EveTr   London
662      0.12        0.18        0.98            0.3             0.8             0.8             0.8             2               0.013           1.71            661             120             5       11          300         -450        1           5.5         0.2             0.6             11.7                0       0.03                0.0005              0.03            0.0005          200                 200                 200                 200                 10              0.9             811         1000000     1.2         4        11                 !   DecTr   London
663      0.18        0.21        0.93            1.9             1.9             1.9             1.9             2               0.013           1.71            661             120             5       11          300         -450        1.6         5.9         -999            -999            33.1                0       0.03                0.0005              0.03            0.0005          200                 200                 200                 200                 10              0.9             812         1000000     1.2         4        11                 !   Grass   London
700      0.11        0.12        0.98            1.3             1.3             1.3             1.3             2               0.013           1.71            661             120             5       11          300         -450        4           5.1         -999            -999            7.4                 0       0.03                0.0005              0.03            0.0005          201                 201                 201                 201                 10              0.9             810         1000000     1.2         4        11                 !   EveTr   London
701      0.12        0.18        0.98            0.3             0.8             0.8             0.8             2               0.013           1.71            661             120             5       11          300         -450        1           5.5         0.2             0.6             11.7                0       0.03                0.0005              0.03            0.0005          201                 201                 201                 201                 10              0.9             811         1000000     1.2         4        11                 !   DecTr   London
702      0.18        0.21        0.93            1.9             1.9             1.9             1.9             2               0.013           1.71            661             120             5       11          300         -450        1.6         5.9         -999            -999            33.1                0       0.03                0.0005              0.03            0.0005          201                 201                 201                 201                 10              0.9             812         500000      0.2         1        11                 !   Grass   London
-9
-9