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 SUEWS_SiteSelect.txt for evergreen trees and shrubs (Code_EveTr), deciduous trees and shrubs (Code_DecTr) and grass surfaces (Code_Grass). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.
2 AlbedoMin MU Effective surface albedo (middle of the day value) for wintertime (not including snow), leaf-off. View factors should be taken into account. Example values [-] 0.1 EveTr Oke (1987) [Ok87] 0.18 DecTr Oke (1987) [Ok87] 0.21 Grass Oke (1987) [Ok87]
3 AlbedoMax MU Effective surface albedo (middle of the day value) for summertime, full leaf-on. View factors should be taken into account. Example values [-] 0.1 EveTr Oke (1987) [Ok87] 0.18 DecTr Oke (1987) [Ok87] 0.21 Grass Oke (1987) [Ok87]
4 Emissivity MU Effective surface emissivity. View factors should be taken into account. Example values [-] 0.98 EveTr Oke (1987) [Ok87] 0.98 DecTr Oke (1987) [Ok87] 0.93 Grass Oke (1987) [Ok87]
5 StorageMin MD Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation (e.g. leaf-off/leaf-on differences for vegetated surfaces). Example values [mm] 1.3 EveTr Breuer et al. (2003) [Br03] 0.3 DecTr Breuer et al. (2003) [Br03] 1.9 Grass Breuer et al. (2003) [Br03]
6 StorageMax MD Maximum water storage capacity for upper surfaces (i.e. canopy) Min/max values are to account for seasonal variation (e.g. leaf-off/leaf-on differences for vegetated surfaces) Only used for DecTr surfaces - set EveTr and Grass values the same as StorageMin. Example values [mm] 1.3 EveTr Breuer et al. (2003) [Br03] 0.8 DecTr Breuer et al. (2003) [Br03] 1.9 Grass Breuer et al. (2003) [Br03]
7 WetThreshold MD Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface. Example values [mm] 1.8 EveTr 1. DecTr 2. Grass
8 StateLimit MD Currently only used for the water surface
9 DrainageEq MD Options 1 Falk and Niemczynowicz (1978) [FN78] 2 Halldin et al. (1979) [Ha79] (Rutter eqn corrected for c=0, see Calder & Wright (1986) [CW86] ) Recommended [3] for EveTr, DecTr, Grass (unirrigated) 3 Falk and Niemczynowicz (1978) [FN78] Recommended [3] for Grass (irrigated) Coefficients are specified in the following two columns.
10 DrainageCoef1 MD Example values DrainageEq 10 Coefficient D0 [mm h-1] 3 Recommended [3] for Grass (irrigated) 0.013 Coefficient D0 [mm h-1] 2 Recommended [3] for EveTr, DecTr, Grass (unirrigated)
11 DrainageCoef2 MD Example values DrainageEq 3 Coefficient b [-] 3 Recommended [3] for Grass (irrigated) 1.71 Coefficient b [m|m^-1|] 2 Recommended [3] for EveTr, DecTr, Grass (unirrigated)
12 SoilTypeCode L Code for soil characteristics below this surface Provides the link to column 1 of SUEWS_Soil.txt, which contains the attributes describing sub-surface soil for this surface type. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Soil.txt.
13 SnowLimPatch O Limit of snow water equivalent when the surface surface is fully covered with snow. Not needed if SnowUse = 0 in RunControl.nml . Example values [mm] 190 EveTr Järvi et al. (2014) [Leena2014] 190 DecTr Järvi et al. (2014) [Leena2014] 190 Grass Järvi et al. (2014) [Leena2014]
14 BaseT MU See section 2.2 Järvi et al. (2011) [J11]; Appendix A Järvi et al. (2014) [Leena2014]. Example values [°C] 5 EveTr Järvi et al. (2011) [J11] 5 DecTr Järvi et al. (2011) [J11] 5 Grass Järvi et al. (2011) [J11]
15 BaseTe MU See section 2.2 Järvi et al. (2011) [J11] ; Appendix A Järvi et al. (2014) [Leena2014]. Example values [°C] 10 EveTr Järvi et al. (2011) [J11] 10 DecTr Järvi et al. (2011) [J11] 10 Grass Järvi et al. (2011) [J11]
16 GDDFull MU This should be checked carefully for your study area using modelled LAI from the DailyState output file compared to known behaviour in the study area. See section 2.2 Järvi et al. (2011) [J11] ; Appendix A Järvi et al. (2014) [Leena2014] for more details. Example values [°C] 300 EveTr Järvi et al. (2011) [J11] 300 DecTr Järvi et al. (2011) [J11] 300 Grass Järvi et al. (2011) [J11]
17 SDDFull MU This should be checked carefully for your study area using modelled LAI from the DailyState output file compared to known behaviour in the study area. See section 2.2 Järvi et al. (2011) [J11] ; Appendix A Järvi et al. (2014) [Leena2014] for more details. Example values [°C] -450 EveTr Järvi et al. (2011) [J11] -450 DecTr Järvi et al. (2011) [J11] -450 Grass Järvi et al. (2011) [J11]
18 LAIMin MD leaf-off wintertime value Example values [m-2 m-2] 4. EveTr Järvi et al. (2011) [J11] 1. DecTr Järvi et al. (2011) [J11] 1.6 Grass Grimmond and Oke (1991) [3] and references therein
19 LAIMax MD full leaf-on summertime value Example values [m-2 m-2] 5.1 EveTr Breuer et al. (2003) [Br03] 5.5 DecTr Breuer et al. (2003) [Br03] 5.9 Grass Breuer et al. (2003) [Br03]
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 Example values [mm s-1] 7.4 EveTr Järvi et al. (2011) [J11] 11.7 DecTr Järvi et al. (2011) [J11] 33.1 Grass (unirrigated) Järvi et al. (2011) [J11] 40. Grass (irrigated) Järvi et al. (2011) [J11]
23 LAIEq MD Options 0 Järvi et al. (2011) [J11] 1 Järvi et al. (2014) [Leena2014] Coefficients are specified in the following four columns. N.B. North and South hemispheres are treated slightly differently.
24 LeafGrowthPower1 MD Example values LAIEq 0.03 Järvi et al. (2011) [J11] 0 0.04 Järvi et al. (2014) [Leena2014] 1
25 LeafGrowthPower2 MD Example values [K-1] LAIEq 0.0005 Järvi et al. (2011) [J11] 0 0.001 Järvi et al. (2014) [Leena2014] 1
26 LeafOffPower1 MD Example values LAIEq 0.03 Järvi et al. (2011) [J11] 0 -1.5 Järvi et al. (2014) [Leena2014] 1
27 LeafOffPower2 MD Example values [K-1] LAIEq 0.0005 Järvi et al. (2011) [J11] 0 0.0015 Järvi et al. (2014) [Leena2014] 1
28 OHMCode_SummerWet L Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
29 OHMCode_SummerDry L Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
30 OHMCode_WinterWet L Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
31 OHMCode_WinterDry L Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
32 OHMThresh_SW MD Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.
33 OHMThresh_WD MD Soil moisture threshold determining whether wet/dry OHM coefficients are applied [-] If soil moisture (as a proportion of maximum soil moisture capacity) exceeds this threshold for bare soil and vegetated surfaces, OHM coefficients for wet conditions are applied; otherwise coefficients for dry coefficients are applied. Note that OHM coefficients for wet conditions are applied if the surface is wet.
34 ESTMCode L Code for ESTM coefficients to use for this surface. Links to SUEWS_ESTMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of 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 [-]
37 BiogenCO2Code MU Code linking to 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