Note

  1. Please report issues with the manual on the GitHub page.

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

4.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