4.2.14. Input Options

a1
Description:

Coefficient for Q* term [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_OHMCoefficients.txt MU Coefficient for Q* term [-]
a2
Description:

Coefficient for dQ*/dt term [h]

Configuration:
Referencing Table Requirement Comment
SUEWS_OHMCoefficients.txt MU Coefficient for dQ*/dt term [h]
a3
Description:

Constant term [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_OHMCoefficients.txt MU Constant term [W m-2]
FcEF_v_kgkm
Description:

CO2 emission factor [kg km-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
ActivityProfWD
Description:

Code linking to ActivityProfWD in SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for human activity profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. Used for CO2 flux calculation - not used in v2018a
ActivityProfWE
Description:

Code linking to ActivityProfWE in SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for human activity profile (weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Look the codes Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. Used for CO2 flux calculation - not used in v2017a
AHMin_WD
Description:

Minimum QF on weekdays [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
AHMin_WE
Description:

Minimum QF on weekends [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
AHSlope_Heating_WD
Description:

Heating slope of QF on weekdays [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
AHSlope_Heating_WE
Description:

Heating slope of QF on weekends [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
AHSlope_Cooling_WD
Description:

Cooling slope of QF on weekdays [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
AHSlope_Cooling_WE
Description:

Cooling slope of QF on weekends [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
AlbedoMax
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MU Effective surface albedo (middle of the day value) for summertime. View factors should be taken into account.
SUEWS_Veg.txt MU

Example values [-]

SUEWS_Water.txt MU

Example values [-]

SUEWS_Snow.txt MU

Example values [-]

AlbedoMin
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MU Not currently used for non-vegetated surfaces – set the same as AlbedoMax.
SUEWS_Veg.txt MU

Example values [-]

SUEWS_Water.txt MU Not currently used for water surface - set same as AlbedoMax.
SUEWS_Snow.txt MU

Example values [-]

alpha
Description:

The mean apparent ecosystem quantum. Represents the initial slope of the light-response curve. [umol CO2 umol photons^-1]

If EmissionsMethod = 11, 12, 13, 14, 15 or 16. Example values: 0.044 Ruimy et al (1995) [R95], 0.0593 Schmid et al. (2000) [S200], 0.0205 Flanagan et al. (2002) [FWC2002].

If EmissionsMethod = 21, 22, 23, 24, 25, or 26. Example value: 0.031 Bellucco et al. (2017) [B2017]

If EmissionsMethod = 31, 32, 33, 34, 35, 36. Example value: 0.005 Bellucco et al. (2017) [B2017]

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
Alt
Description:

Used for both the radiation and water flow between grids.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Used for both the radiation and water flow between grids. Not available in this version.
AnOHM_Ch
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MU Bulk transfer coefficient for this surface to use in AnOHM [-]
SUEWS_Veg.txt MU Bulk transfer coefficient for this surface to use in AnOHM [-]
SUEWS_Water.txt MU Bulk transfer coefficient for this surface to use in AnOHM [-]
SUEWS_Snow.txt MU Bulk transfer coefficient for this surface to use in AnOHM [-]
AnOHM_Cp
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MU Volumetric heat capacity for this surface to use in AnOHM [J m-3]
SUEWS_Veg.txt MU Volumetric heat capacity for this surface to use in AnOHM [J m-3]
SUEWS_Water.txt MU Volumetric heat capacity for this surface to use in AnOHM [J m-3]
SUEWS_Snow.txt MU Volumetric heat capacity for this surface to use in AnOHM [J m-3]
AnOHM_Kk
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MU Thermal conductivity for this surface to use in AnOHM [W m K-1]
SUEWS_Veg.txt MU Thermal conductivity for this surface to use in AnOHM [W m K-1]
SUEWS_Water.txt MU Thermal conductivity for this surface to use in AnOHM [W m K-1]
SUEWS_Snow.txt MU Thermal conductivity for this surface to use in AnOHM [W m K-1]
AnthropogenicCode
Description:

Code for modelling anthropogenic heat flux linking to Code of SUEWS_AnthropogenicHeat.txt, which contains the model coefficients for estimation of the anthropogenic heat flux (used if EmissionsMethod = 1, 2 in RunControl.nml).

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for modelling anthropogenic heat flux Provides the link to column 1 of SUEWS_AnthropogenicHeat.txt, which contains the model coefficients for estimation of the anthropogenic heat flux (used if EmissionsMethod = 1, 2 in RunControl.nml ). Value of integer is arbitrary but must match code specified in column 1 of SUEWS_AnthropogenicHeat.txt.
AreaWall
Description:

Area of wall within grid (needed for ESTM calculation).

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Area of wall within grid (needed for ESTM calculation).
BaseT
Description:

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

See section 2.2 Järvi et al. (2011); Appendix A Järvi et al. (2014).

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MU See section 2.2 Järvi et al. (2011); Appendix A Järvi et al. (2014). 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]
BaseTe
Description:

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

See section 2.2 Järvi et al. (2011) [J11] ; Appendix A Järvi et al. (2014) [Leena2014] .

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt 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]
BaseTHDD
Description:

Base temperature for heating degree days [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU Base temperature for heating degree days [°C] e.g. Sailor and Vasireddy (2006) [SV06]
beta
Description:

The light-saturated gross photosynthesis of the canopy. [umol m-2 s-1 ]

If EmissionsMethod = 11, 12, 13, 14, 15, 16. Example values: 43.35 Ruimy et al. (1995) [R95], 35 Schmid et al. (2000) [S2000], 16.3 Flanagan et al. (2002) [FWC2002]

If EmissionsMethod = 21, 22, 23, 24, 25, 26. Example value: 17.793 Bellucco et al. (2017) [B2017]

If EmissionsMethod = 31, 32, 33, 34, 35, 36. Example value: 8.474 Bellucco et al. (2017) [B2017]

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
theta
Description:

The convexity of the curve at light saturation.

If EmissionsMethod = 21, 22, 23, 24, 25, 26. Example value: 0.723 Bellucco et al. (2017) [B2017]

If EmissionsMethod = 31, 32, 33, 34, 35, 36. Example value: 0.96 Bellucco et al. (2017) [B2017]

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
alpha_enh
Description:

Part of the alpha coefficient related to the fraction of vegetation. Example value: 0.016 Bellucco et al. (2017) [B2017]

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
beta_enh
Description:

Part of the beta coefficient related to the fraction of vegetation. Example values: 33.454 Bellucco et al. (2017) [B2017]

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
resp_a
Description:

Respiration coefficient a. Example values: 1.08 Schmid et al. (2000) [S2000], 3.229 Järvi et al. (2012) [J12]

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
resp_b
Description:

Respiration coefficient b - related to air temperature dependency. Example values: 0.0064 Schmid et al. (2000) [S2000], 0.0329 Järvi et al. (2012) [J12].

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
min_respi
Description:

Minimum soil respiration rate (for cold-temperature limit) [umol m-2 s-1]. Example values: 0.6 estimate from Hyytiälä forest site.

Configuration:
Referencing Table Requirement Comment
SUEWS_BiogenCO2.txt MU O TODO
BiogenCO2Code
Description:

Code linking to the Code column in SUEWS_BiogenCO2.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt L Code linking to the Code column in SUEWS_BiogenCO2.txt.
QF0_BEU_WD
Description:

Building energy use [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
QF0_BEU_WE
Description:

Building energy use [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekend building energy use [W m-2] Can be used for CO2 flux calculation. Do not use in v2017a - set to -999
Code
Description:

Code linking to various look-up talbes described below.

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt L Code linking to SUEWS_SiteSelect.txt for paved surfaces (Code_Paved), buildings (Code_Bldgs) and bare soil surfaces (Code_BSoil). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.
SUEWS_Veg.txt 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.
SUEWS_Water.txt L Code linking to SUEWS_SiteSelect.txt for water surfaces (Code_Water). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
SUEWS_Snow.txt L Code linking to SUEWS_SiteSelect.txt for snow surfaces (SnowCode). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
SUEWS_Soil.txt L Code linking to the SoilTypeCode column in SUEWS_NonVeg.txt (for Paved, Bldgs and BSoil surfaces) and SUEWS_Veg.txt (for EveTr, DecTr and Grass surfaces). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
SUEWS_Conductance.txt L Code linking to the CondCode column in SUEWS_SiteSelect.txt . Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
SUEWS_AnthropogenicHeat.txt L Code linking to the AnthropogenicCode column in SUEWS_SiteSelect.txt . Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
SUEWS_Irrigation.txt L Code linking to SUEWS_SiteSelect.txt for irrigation modelling (IrrigationCode). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.
SUEWS_OHMCoefficients.txt L Code linking to the OHMCode_SummerWet, OHMCode_SummerDry, OHMCode_WinterWet and OHMCode_WinterDry columns in SUEWS_NonVeg.txt, SUEWS_Veg.txt, SUEWS_Water.txt and SUEWS_Snow.txt files. Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
SUEWS_ESTMCoefficients.txt L For buildings and paved surfaces, set to zero if there is more than one ESTM class per grid and the codes and surface fractions specified in SUEWS_SiteSelect.txt will be used instead.
SUEWS_BiogenCO2.txt L Code linking to the BiogenCO2Code column in SUEWS_Veg.txt.
Code_Bldgs
Description:

Code for Bldgs surface characteristics linking to Code of SUEWS_NonVeg.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for Bldgs surface characteristics Provides the link to column 1 of SUEWS_NonVeg.txt, which contains the attributes describing buildings in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt.
Code_BSoil
Description:

Code for BSoil surface characteristics linking to Code of SUEWS_NonVeg.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt.
Code_DecTr
Description:

Code for DecTr surface characteristics linking to Code of SUEWS_Veg.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for DecTr surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing deciduous trees and shrubs in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.
Code_ESTMClass_Bldgs1
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Bldgs2
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Bldgs3
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Bldgs4
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Bldgs5
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Paved1
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Paved2
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_ESTMClass_Paved3
Description:

Code linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code linking to SUEWS_ESTMCoefficients.txt
Code_EveTr
Description:

Code for EveTr surface characteristics linking to Code of SUEWS_Veg.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for EveTr surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing evergreen trees and shrubs in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.
Code_Grass
Description:

Code for Grass surface characteristics linking to Code of SUEWS_Veg.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for Grass surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing grass surfaces in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.
Code_Paved
Description:

Code for Paved surface characteristics linking to Code of SUEWS_NonVeg.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for Paved surface characteristics Provides the link to column 1 of SUEWS_NonVeg.txt, which contains the attributes describing paved areas in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt. e.g. 331 means use the characteristics specified in the row of input file SUEWS_NonVeg.txt which has 331 in column 1 (Code).
Code_Water
Description:

Code for Water surface characteristics linking to Code of SUEWS_Water.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for Water surface characteristics Provides the link to column 1 of SUEWS_Water.txt, which contains the attributes describing open water in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Water.txt.
CondCode
Description:

Code for surface conductance parameters linking to Code of SUEWS_Conductance.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for surface conductance parameters Provides the link to column 1 of SUEWS_Conductance.txt, which contains the parameters for the Jarvis (1976) parameterisation of surface conductance. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Conductance.txt. e.g. 33 means use the characteristics specified in the row of input file SUEWS_Conductance.txt which has 33 in column 1 (Code).
CRWMax
Description:

Maximum water holding capacity of snow [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Maximum water holding capacity of snow [mm]
CRWMin
Description:

Minimum water holding capacity of snow [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Minimum water holding capacity of snow [mm]
DayWat(1)
Description:

Irrigation allowed on Sundays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Sundays [1], if not [0]
DayWat(2)
Description:

Irrigation allowed on Mondays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Mondays [1], if not [0]
DayWat(3)
Description:

Irrigation allowed on Tuesdays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Tuesdays [1], if not [0]
DayWat(4)
Description:

Irrigation allowed on Wednesdays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Wednesdays [1], if not [0]
DayWat(5)
Description:

Irrigation allowed on Thursdays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Thursdays [1], if not [0]
DayWat(6)
Description:

Irrigation allowed on Fridays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Fridays [1], if not [0]
DayWat(7)
Description:

Irrigation allowed on Saturdays [1], if not [0]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Irrigation allowed on Saturdays [1], if not [0]
DayWatPer(1)
Description:

Fraction of properties using irrigation on Sundays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Sundays [0-1]
DayWatPer(2)
Description:

Fraction of properties using irrigation on Mondays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Mondays [0-1]
DayWatPer(3)
Description:

Fraction of properties using irrigation on Tuesdays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Tuesdays [0-1]
DayWatPer(4)
Description:

Fraction of properties using irrigation on Wednesdays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Wednesdays [0-1]
DayWatPer(5)
Description:

Fraction of properties using irrigation on Thursdays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Thursdays [0-1]
DayWatPer(6)
Description:

Fraction of properties using irrigation on Fridays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Fridays [0-1]
DayWatPer(7)
Description:

Fraction of properties using irrigation on Saturdays [0-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of properties using irrigation on Saturdays [0-1]
DrainageCoef1
Description:

Coefficient D0 [mm h-1] used in DrainageEq

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Example values DrainageEq 10 Coefficient D0 [mm h-1] 3 Recommended [3] for Paved and Bldgs 0.013 Coefficient D0 [mm h-1] 2 Recommended [3] for BSoil
SUEWS_Veg.txt 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)
SUEWS_Water.txt MD Not currently used for water surface
DrainageCoef2
Description:

Coefficient b [-] used in DrainageEq

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Example values DrainageEq 3 Coefficient b [-] 3 Recommended [3] for Paved and Bldgs 1.71 Coefficient b [m|m^-1|] 2 Recommended [3] for BSoil
SUEWS_Veg.txt 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)
SUEWS_Water.txt MD Not currently used for water surface
DrainageEq
Description:

Calculation choice for Drainage equation

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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 BSoil 3 Falk and Niemczynowicz (1978) [FN78] Recommended [3] for Paved and Bldgs Coefficients are specified in the following two columns.
SUEWS_Veg.txt 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.
SUEWS_Water.txt MD Not currently used for water surface.
EF_umolCO2perJ
Description:

Emission factor for fuels used for building heating.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
Emissivity
Description:

Effective surface emissivity.

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MU Effective surface emissivity. View factors should be taken into account.
SUEWS_Veg.txt MU

Example values [-]

SUEWS_Water.txt MU

Example values [-]

  • 0.95 Water Oke (1987) [Ok87]
SUEWS_Snow.txt MU

Example values [-]

EndDLS
Description:

End of the day light savings [DOY]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU End of the day light savings [DOY] See Day Light Savings (DLS).
EnEF_v_Jkm
Description:

TODO - Should be anthropogenic heat.txt in the table below

Emission factor for heat [J k|m^-1|]. Example values: 3.97e6 Sailor and Lu (2004) [SL04]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
EnergyUseProfWD
Description:

Code linking to EnergyUseProfWD in SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for energy use profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Look the codes Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
EnergyUseProfWE
Description:

Code linking to EnergyUseProfWE in SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for energy use profile (weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
ESTMCode
Description:

Code for ESTM coefficients linking to SUEWS_ESTMCoefficients.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt L For paved and building surfaces, it is possible to specify multiple codes per grid (3 for paved, 5 for buildings) using SUEWS_SiteSelect.txt . In this case, set ESTMCode here to zero.
SUEWS_Veg.txt 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.
SUEWS_Water.txt 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.
SUEWS_Snow.txt L For paved and building surfaces, it is possible to specify multiple codes per grid (3 for paved, 5 for buildings) using SUEWS_SiteSelect.txt . In this case, set ESTM code here to zero.
FAI_Bldgs
Description:

Frontal area index for buildings [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Frontal area index for buildings [-] Required if RoughLenMomMethod = 3 in RunControl.nml .
FAI_DecTr
Description:

Frontal area index for deciduous trees [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Frontal area index for deciduous trees [-] Required if RoughLenMomMethod = 3 in RunControl.nml .
FAI_EveTr
Description:

Frontal area index for evergreen trees [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Frontal area index for evergreen trees [-] Required if RoughLenMomMethod = 3 in RunControl.nml .
Faut
Description:

Fraction of irrigated area that is irrigated using automated systems

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Fraction of irrigated area that is irrigated using automated systems (e.g. sprinklers).
FcEF_v_Jkm
Description:

Traffic emission factor for CO2.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
fcld
Description:

Cloud fraction [tenths]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Cloud fraction [tenths]
FlowChange
Description:

Difference in input and output flows for water surface [mm h-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Difference in input and output flows for water surface [mm h-1] Used to indicate river or stream flow through the grid. Currently not fully tested!
Fraction1of8
Description:

Fraction of water that can flow to GridConnection1of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction2of8
Description:

Fraction of water that can flow to GridConnection2of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction3of8
Description:

Fraction of water that can flow to GridConnection3of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction4of8
Description:

Fraction of water that can flow to GridConnection4of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction5of8
Description:

Fraction of water that can flow to GridConnection5of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction6of8
Description:

Fraction of water that can flow to GridConnection6of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction7of8
Description:

Fraction of water that can flow to GridConnection7of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fraction8of8
Description:

Fraction of water that can flow to GridConnection8of8 [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of water that can flow to the grid specified in previous column [-]
Fr_Bldgs
Description:

Surface cover fraction of buildings [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Surface cover fraction of buildings [-]
Fr_Bsoil
Description:

Surface cover fraction of bare soil or unmanaged land [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Surface cover fraction of bare soil or unmanaged land [-]
Fr_DecTr
Description:

Surface cover fraction of deciduous trees and shrubs [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Surface cover fraction of deciduous trees and shrubs [-]
Fr_ESTMClass_Bldgs1
Description:

Surface cover fraction of building class 1 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 94-98 must add up to 1
Fr_ESTMClass_Bldgs2
Description:

Surface cover fraction of building class 2 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 94-98 must add up to 1
Fr_ESTMClass_Bldgs3
Description:

Surface cover fraction of building class 3 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 94-98 must add up to 1
Fr_ESTMClass_Bldgs4
Description:

Surface cover fraction of building class 4 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 94-98 must add up to 1
Fr_ESTMClass_Bldgs5
Description:

Surface cover fraction of building class 5 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 94-98 must add up to 1
Fr_ESTMClass_Paved1
Description:

Surface cover fraction of Paved surface class 1 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 88-90 must add up to 1
Fr_ESTMClass_Paved2
Description:

Surface cover fraction of Paved surface class 2 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 88-90 must add up to 1
Fr_ESTMClass_Paved3
Description:

Surface cover fraction of Paved surface class 3 used in ESTM calculations

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 88-90 must add up to 1
Fr_EveTr
Description:

Surface cover fraction of evergreen trees and shrubs [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Surface cover fraction of evergreen trees and shrubs [-]
Fr_Grass
Description:

Surface cover fraction of Grass [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Surface cover fraction of grass [-]
Fr_Paved
Description:

Surface cover fraction of Paved surfaces [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Columns 14 to 20 must sum to 1 .
Fr_Water
Description:

Surface cover fraction of open water [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Surface cover fraction of open water [-] (e.g. river, lakes, ponds, swimming pools)
FrFossilFuel_Heat
Description:

Fraction of fossil fuels used for building heating [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
FrFossilFuel_NonHeat
Description:

Fraction of fossil fuels used for building energy use [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
G1
Description:

Related to maximum surface conductance [mm s-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to maximum surface conductance [mm s-1]
G2
Description:

Related to Kdown dependence [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to Kdown dependence [W m-2]
G3
Description:

Related to VPD dependence [units depend on gsModel]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to VPD dependence [units depend on gsChoice in RunControl.nml ]
G4
Description:

Related to VPD dependence [units depend on gsModel]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to VPD dependence [units depend on gsChoice in RunControl.nml ]
G5
Description:

Related to temperature dependence [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to temperature dependence [°C]
G6
Description:

Related to soil moisture dependence [mm-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to soil moisture dependence [m|m^-1|]
gamq_gkgm
Description:

vertical gradient of specific humidity [g kg-1 m-1]

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU vertical gradient of specific humidity (g kg-1 m-1 )
gamt_Km
Description:

vertical gradient of potential temperature [K m-1]

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU vertical gradient of potential temperature (K m-1 ) strength of the inversion
GDDFull
Description:

The growing degree days (GDD) needed for full capacity of the leaf area index (LAI) [°C]. 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.

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt 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]
Grid
Description:

a unique number to represent grid

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Grid numbers do not need to be consecutive and do not need to start at a particular value. Each grid must have a unique grid number. All grids must be present for all years. These grid numbers are referred to in GridConnections (columns 64-79) ( N.B. Not available in this version. )
GridConnection1of8
Description:

Number of the 1st grid where water can flow to The next 8 pairs of columns specify the water flow between grids. The first column of each pair specifies the grid that the water flows to (from the current grid, column 1); the second column of each pair specifies the fraction of water that flow to that grid. The fraction (i.e. amount) of water transferred may be estimated based on elevation, the length of connecting surface between grids, presence of walls, etc. Water cannot flow from the current grid to the same grid, so the grid number here must be different to the grid number in column 1. Water can flow to a maximum of 8 other grids. If there is no water flow between grids, or a single grid is run, set to 0. See section on Grid Connections

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU The next 8 pairs of columns specify the water flow between grids. The first column of each pair specifies the grid that the water flows to (from the current grid, column 1); the second column of each pair specifies the fraction of water that flow to that grid. The fraction (i.e. amount) of water transferred may be estimated based on elevation, the length of connecting surface between grids, presence of walls, etc. Water cannot flow from the current grid to the same grid, so the grid number here must be different to the grid number in column 1. Water can flow to a maximum of 8 other grids. If there is no water flow between grids, or a single grid is run, set to 0. See section on Grid Connections
GridConnection2of8
Description:

Number of the 2nd grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
GridConnection3of8
Description:

Number of the 3rd grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
GridConnection4of8
Description:

Number of the 4th grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
GridConnection5of8
Description:

Number of the 5th grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
GridConnection6of8
Description:

Number of the 6th grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
GridConnection7of8
Description:

Number of the 7th grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
GridConnection8of8
Description:

Number of the 8th grid where water can flow to

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Number of the grid where water can flow to
gsModel
Description:

Formulation choice for conductance calculation.

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD
  • 1 Järvi et al. (2011) [J11]
  • 2 (Recommended) Ward et al. (2016) [W16]
H_Bldgs
Description:

Mean building height [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Mean building height [m]
H_DecTr
Description:

Mean height of deciduous trees [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Mean height of deciduous trees [m]
H_EveTr
Description:

Mean height of evergreen trees [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Mean height of evergreen trees [m]
id
Description:

Day of year [DOY]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Not used: set to 1 in this version.
SSss_YYYY_ESTM_Ts_data_tt.txt MU Day of year [DOY]
SSss_YYYY_data_tt.txt MU Day of year [DOY]
CBL_initial_data.txt MU Day of year [DOY]
Ie_a1
Description:

Coefficient for automatic irrigation model [mm d-1 ]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MD Coefficient for automatic irrigation model [mm d -1 ]
Ie_a2
Description:

Coefficient for automatic irrigation model [mm d-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MD Coefficient for automatic irrigation model [mm d -1 K-1]
Ie_a3
Description:

Coefficient for automatic irrigation model [mm d-2 ]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MD Coefficient for automatic irrigation model [mm d -2 ]
Ie_end
Description:

Day when irrigation ends [DOY]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Day when irrigation ends [DOY]
Ie_m1
Description:

Coefficient for manual irrigation model [mm d-1 ]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MD Coefficient for manual irrigation model [mm d -1 ]
Ie_m2
Description:

Coefficient for manual irrigation model [mm d-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MD Coefficient for manual irrigation model [mm d -1 K-1]
Ie_m3
Description:

Coefficient for manual irrigation model [mm d-2 ]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MD Coefficient for manual irrigation model [mm d -2 ]
Ie_start
Description:

Day when irrigation starts [DOY]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Day when irrigation starts [DOY]
ih
Description:

Hour [H]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Hour [H] Not used: set to 0 in this version.
imin
Description:

Minute [M]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Minute [M] Not used: set to 0 in this version.
SSss_YYYY_ESTM_Ts_data_tt.txt MU Minute [M]
SSss_YYYY_data_tt.txt MU Minute [M]
InfiltrationRate
Description:

Infiltration rate.

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt O Not currently used
Internal_albedo
Description:

Albedo of all internal elements for building surfaces only

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Albedo of all internal elements for building surfaces only
Internal_CHbld
Description:

Bulk transfer coefficient of internal building elements [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Bulk transfer coefficient of internal building elements [W m-2 K-1] (for building surfaces only and if IbldCHmod == 0 in ESTMinput.nml
Internal_CHroof
Description:

Bulk transfer coefficient of internal roof [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Bulk transfer coefficient of internal roof [W m-2 K-1] (for building surfaces only and if IbldCHmod == 0 in ESTMinput.nml
Internal_CHwall
Description:

Bulk transfer coefficient of internal wall [W m-2 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Bulk transfer coefficient of internal wall [W m-2 K-1] (for building surfaces only and if IbldCHmod == 0 in ESTMinput.nml
Internal_emissivity
Description:

Emissivity of all internal elements for building surfaces only

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Emissivity of all internal elements for building surfaces only
Internal_k1
Description:

Thermal conductivity of the first layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Thermal conductivity of the first layer [W m-1 K-1]
Internal_k2
Description:

Thermal conductivity of the second layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the second layer [W m-1 K-1]
Internal_k3
Description:

Thermal conductivity of the third layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the third layer [W m-1 K-1]
Internal_k4
Description:

Thermal conductivity of the fourth layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the fourth layer [W m-1 K-1]
Internal_k5
Description:

Thermal conductivity of the fifth layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the fifth layer [W m-1 K-1]
Internal_rhoCp1
Description:

Volumetric heat capacity of the first layer[J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Volumetric heat capacity of the first layer[J m-3 K-1]
Internal_rhoCp2
Description:

Volumetric heat capacity of the second layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the second layer [J m-3 K-1]
Internal_rhoCp3
Description:

Volumetric heat capacity of the third layer[J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the third layer[J m-3 K-1]
Internal_rhoCp4
Description:

Volumetric heat capacity of the fourth layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the fourth layer [J m-3 K-1]
Internal_rhoCp5
Description:

Volumetric heat capacity of the fifth layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the fifth layer [J m-3 K-1]
Internal_thick1
Description:

Thickness of the first layer [m] for building surfaces only

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Thickness of the first layer [m] for building surfaces only; set to -999 for all other surfaces
Internal_thick2
Description:

Thickness of the second layer [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the second layer [m] (if no second layer, set to -999.)
Internal_thick3
Description:

Thickness of the third layer [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the third layer [m] (if no third layer, set to -999.)
Internal_thick4
Description:

Thickness of the fourth layer [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the fourth layer [m] (if no fourth layer, set to -999.)
Internal_thick5
Description:

Thickness of the fifth layer [m]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the fifth layer [m] (if no fifth layer, set to -999.)
InternalWaterUse
Description:

Internal water use [mm h-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Irrigation.txt MU Internal water use [mm h-1]
IrrFr_DecTr
Description:

Fraction of deciduous trees that are irrigated [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Fraction of deciduous trees that are irrigated [-]
IrrFr_EveTr
Description:

Fraction of evergreen trees that are irrigated [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Fraction of evergreen trees that are irrigated [-] e.g. 50% of the evergreen trees/shrubs are irrigated
IrrFr_Grass
Description:

Fraction of Grass that is irrigated [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Fraction of grass that is irrigated [-]
IrrigationCode
Description:

Code for modelling irrigation linking to Code of SUEWS_Irrigation.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for modelling irrigation Provides the link to column 1 of SUEWS_Irrigation.txt, which contains the model coefficients for estimation of the water use (used if WU_Choice = 0 in RunControl.nml ). Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Irrigation.txt.
it
Description:

Hour [H]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Hour [H]
SSss_YYYY_data_tt.txt MU Hour [H]
iy
Description:

Year [YYYY]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Year [YYYY]
SSss_YYYY_data_tt.txt MU Year [YYYY]
kdiff
Description:

Diffuse radiation [W m-2].

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Recommended if SOLWEIGUse = 1
kdir
Description:

Direct radiation [W m-2].

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Recommended if SOLWEIGUse = 1
kdown
Description:

Incoming shortwave radiation [W m-2].

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt MU Must be > 0 W m-2 .
Kmax
Description:

Maximum incoming shortwave radiation [W m-2]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Maximum incoming shortwave radiation [W m-2]
lai
Description:

Observed leaf area index [m-2 m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Observed leaf area index [m-2 m-2]
LAIEq
Description:

LAI calculation choice.

Note

North and South hemispheres are treated slightly differently.

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD

Coefficients are specified in the following parameters: LeafGrowthPower1, LeafGrowthPower2, LeafOffPower1 and LeafOffPower2.

Options

LAIMax
Description:

full leaf-on summertime value

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt 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]
LAIMin
Description:

leaf-off wintertime value

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt 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
lat
Description:

Latitude [deg].

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Use coordinate system WGS84. Positive values are northern hemisphere (negative southern hemisphere). Used in radiation calculations. Note, if the total modelled area is small the latitude and longitude could be the same for each grid but small differences in radiation will not be determined. If you are defining the latitude and longitude differently between grids make certain that you provide enough decimal places.
ldown
Description:

Incoming longwave radiation [W m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Incoming longwave radiation [W m-2]
LeafGrowthPower1
Description:

a parameter required by LAI calculation in LAIEq

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD

Example values

LeafGrowthPower2
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD

Example values

LeafOffPower1
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD

Example values

LeafOffPower2
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD Example values [K-1] LAIEq 0.0005 Järvi et al. (2011) [J11] 0 0.0015 Järvi et al. (2014) [Leena2014] 1
lng
Description:

longitude [deg]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Use coordinate system WGS84. For compatibility with GIS, negative values are to the west, positive values are to the east (e.g. Vancouver = -123.12; Shanghai = 121.47) Note this is a change of sign convention between v2016a and v2017a See latitude for more details.
LUMPS_Cover
Description:

Limit when surface totally covered with water for LUMPS [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Limit when surface totally covered with water [mm] Used for LUMPS surface wetness control. Default recommended value of 1 mm from Loridan et al. (2011) [L2011] .
LUMPS_DrRate
Description:

Drainage rate of bucket for LUMPS [mm h-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Drainage rate of bucket for LUMPS [mm h-1] Used for LUMPS surface wetness control. Default recommended value of 0.25 mm h-1 from Loridan et al. (2011) [L2011] .
LUMPS_MaxRes
Description:

Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control. Default recommended value of 10 mm from Loridan et al. (2011) [L2011] .
MaxQFMetab
Description:

Maximum value for human heat emission. [W m-2]

Example values: 175 Sailor and Lu (2004) [SL04]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
MinQFMetab
Description:

Minimum value for human heat emission. [W m-2]

Example values: 75 Sailor and Lu (2004) [SL04]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
MaxConductance
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt 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]
NARP_Trans
Description:

Atmospheric transmissivity for NARP [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD Atmospheric transmissivity for NARP [-] Value must in the range 0-1. Default recommended value of 1.
nroom
Description:

Number of rooms per floor for building surfaces only [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Number of rooms per floor for building surfaces only
OBS_SMCap
Description:

The maximum observed soil moisture. [m3 m-3 or kg kg-1] Use only if soil moisture is observed and provided in the met forcing file and SMDMethod = 1 or 2. Use of observed soil moisture not currently tested

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt O Use only if soil moisture is observed and provided in the met forcing file and SMDMethod = 1 or 2. Use of observed soil moisture not currently tested
OBS_SMDepth
Description:

The depth of soil moisture measurements. [mm]

Use only if soil moisture is observed and provided in the met forcing file and SMDMethod = 1 or 2. Use of observed soil moisture not currently tested

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt O Use only if soil moisture is observed and provided in the met forcing file and SMDMethod = 1 or 2. Use of observed soil moisture not currently tested
OBS_SoilNotRocks
Description:

Fraction of soil without rocks. [-]

Use only if soil moisture is observed and provided in the met forcing file and SMDMethod = 1 or 2. Use of observed soil moisture not currently tested

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt O Use only if soil moisture is observed and provided in the met forcing file and SMDMethod = 1 or 2. Use of observed soil moisture not currently tested
OHMCode_SummerDry
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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.
SUEWS_Veg.txt 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.
SUEWS_Water.txt 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.
SUEWS_Snow.txt 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.
OHMCode_SummerWet
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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.
SUEWS_Veg.txt 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.
SUEWS_Water.txt 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.
SUEWS_Snow.txt 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.
OHMCode_WinterDry
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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.
SUEWS_Veg.txt 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.
SUEWS_Water.txt 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.
SUEWS_Snow.txt 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.
OHMCode_WinterWet
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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.
SUEWS_Veg.txt 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.
SUEWS_Water.txt 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.
SUEWS_Snow.txt 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.
OHMThresh_SW
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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.
SUEWS_Veg.txt 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.
SUEWS_Water.txt 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.
SUEWS_Snow.txt MD Not actually used for Snow surface as winter wet conditions always assumed.
OHMThresh_WD
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Not actually used for building and paved surfaces (as impervious).
SUEWS_Veg.txt MD Note that OHM coefficients for wet conditions are applied if the surface is wet.
SUEWS_Water.txt MD Not actually used for water surface (as no soil surface beneath).
SUEWS_Snow.txt MD Not actually used for Snow surface as winter wet conditions always assumed.
PipeCapacity
Description:

Storage capacity of pipes [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Storage capacity of pipes [mm] Runoff amounting to less than the value specified here is assumed to be removed by pipes.
PopDensDay
Description:

Daytime population density (i.e. workers, tourists) [people ha-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Daytime population density (i.e. workers, tourists) [people ha -1 ] Population density is required if EmissionsMethod = 2 in RunControl.nml . The model will use the average of daytime and night-time population densities, unless only one is provided. If daytime population density is unknown, set to -999.
PopDensNight
Description:

Night-time population density (i.e. residents) [people ha-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Night-time population density (i.e. residents) [people ha -1 ] Population density is required if EmissionsMethod = 2 in RunControl.nml . The model will use the average of daytime and night-time population densities, unless only one is provided. If night-time population density is unknown, set to -999.
PopProfWD
Description:

Code for population density profile (weekdays) linking to Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
PopProfWE
Description:

Code for population density profile (weekends) linking to Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
PorosityMax
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD full leaf-on summertime value Used only for DecTr (can affect roughness calculation)
PorosityMin
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt MD leaf-off wintertime value Used only for DecTr (can affect roughness calculation)
PrecipiLimAlb
Description:

Limit for hourly precipitation when the ground is fully covered with snow [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Limit for hourly precipitation when the ground is fully covered with snow. Then snow albedo is reset to AlbedoMax [mm]
PrecipLimSnow
Description:

Limit for hourly snowfall when the ground is fully covered with snow [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Auer (1974) [Au74]
pres
Description:

Barometric pressure [kPa]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt MU Barometric pressure [kPa]
qe
Description:

Latent heat flux [W m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Latent heat flux [W m-2]
qf
Description:

Anthropogenic heat flux [W m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Anthropogenic heat flux [W m-2]
QF_A_WD
Description:

Base value for QF on weekdays [W m-2 (Cap ha-1 )-1 ]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 2 Example values [W m-2 (Cap ha-1) -1 ] 0.3081 Järvi et al. (2011) [J11] 0.1 Järvi et al. (2014) [Leena2014]
QF_A_WE
Description:

ase value for QF on weekends [W m-2 (Cap ha-1 )-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 2 Example values [W m-2 (Cap ha -1 ) -1 ] 0.3081 Järvi et al. (2011) [J11] 0.1 Järvi et al. (2014) [Leena2014]
QF_B_WD
Description:

Parameter related to heating degree days on weekdays [W m-2 K-1 (Cap ha-1 )-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 2 Example values [W m-2 K-1 (Cap ha -1 ) -1 ] 0.0099 Järvi et al. (2011) [J11] 0.0099 Järvi et al. (2014) [Leena2014]
QF_B_WE
Description:

Parameter related to cooling degree days on weekends [W m-2 K-1 (Cap ha-1 )-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 2 Example values [W m-2 K-1 (Cap ha -1 ) -1 ] 0.0099 Järvi et al. (2011) [J11] 0.0099 Järvi et al. (2014) [Leena2014]
QF_C_WD
Description:

Parameter related to heating degree days on weekdays [W m-2 K-1 (Cap ha-1 )-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 2 Example values [W m-2 K-1 (Cap ha -1 ) -1 ] 0.0102 Järvi et al. (2011) [J11] 0.0102 Järvi et al. (2014) [Leena2014]
QF_C_WE
Description:

Parameter related to heating degree days on weekends [W m-2 K-1 (Cap ha-1 )-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Example values [W m-2 K-1 (Cap ha -1 ) -1 ] 0.0102 Järvi et al. (2011) [J11] 0.0102 Järvi et al. (2014) [Leena2014]
q+_gkg
Description:

specific humidity at the top of CBL [g kg-1]

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU specific humidity at the top of CBL (g kg-1 )
q_gkg
Description:

specific humidiy in CBL [g kg-1]

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU specific humidiy in CBL (g kg-1 )
qh
Description:

Sensible heat flux [W m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Sensible heat flux [W m-2]
qn
Description:

Net all-wave radiation [W m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Required if NetRadiationMethod = 1.
qs
Description:

Storage heat flux [W m-2]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Storage heat flux [W m-2]
RadMeltFactor
Description:

Hourly radiation melt factor of snow [mm W-1 h-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MU Hourly radiation melt factor of snow [mm W-1 h-1]
rain
Description:

Rainfall [mm]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt MU Rainfall [mm]
RH
Description:

Relative Humidity [%]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt MU Relative Humidity [%]
RunoffToWater
Description:

Fraction of above-ground runoff flowing to water surface during flooding [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MD MU Fraction of above-ground runoff flowing to water surface during flooding [-] Value must be in the range 0-1. Fraction of above-ground runoff that can flow to the water surface in the case of flooding.
S1
Description:

A parameter related to soil moisture dependence [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to soil moisture dependence [-] These will change in the future to ensure consistency with soil behaviour
S2
Description:

A parameter related to soil moisture dependence [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Related to soil moisture dependence [mm] These will change in the future to ensure consistency with soil behaviour
SatHydraulicCond
Description:

Hydraulic conductivity for saturated soil [mm s-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt MD Hydraulic conductivity for saturated soil [mm s-1]
SDDFull
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_Veg.txt 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]
snow
Description:

Snowfall [mm]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Required if SnowUse = 1
SnowClearingProfWD
Description:

Code for snow clearing profile (weekdays) linking to Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for snow clearing profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. e.g. 1 means use the characteristics specified in the row of input file SUEWS_Profiles.txt which has 1 in column 1 (Code).
SnowClearingProfWE
Description:

Code for snow clearing profile (weekends) linking to Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for snow clearing profile (weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. e.g. 1 means use the characteristics specified in the row of input file SUEWS_Profiles.txt which has 1 in column 1 (Code). Providing the same code for SnowClearingProfWD and SnowClearingProfWE would link to the same row in SUEWS_Profiles.txt, i.e. the same profile would be used for weekdays and weekends.
SnowCode
Description:

Code for snow surface characteristics linking to Code of SUEWS_Snow.txt

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for snow surface characteristics Provides the link to column 1 of SUEWS_Snow.txt, which contains the attributes describing snow surfaces in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Snow.txt.
snowDensMax
Description:

Maximum snow density [kg m-3]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Maximum snow density [kg m-3]
snowDensMin
Description:

Fresh snow density [kg m-3]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Fresh snow density [kg m-3]
SnowLimPatch
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt O Not needed if SnowUse = 0 in RunControl.nml . Example values [mm] 190 Paved Järvi et al. (2014) [Leena2014] 190 Bldgs Järvi et al. (2014) [Leena2014] 190 BSoil Järvi et al. (2014) [Leena2014]
SUEWS_Veg.txt 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]
SnowLimRemove
Description:

Limit of the snow water equivalent for snow removal from roads and roofs [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt O

Not needed if SnowUse = 0 in RunControl.nml . Not available in this version.

Example values [mm]

SoilDensity
Description:

Soil density [kg m-3]

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt MD Soil density [kg m-3]
SoilDepth
Description:

Depth of soil beneath the surface [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt MD Depth of sub-surface soil store [mm] i.e. the depth of soil beneath the surface
SoilStoreCap
Description:

Limit value for SoilDepth [mm]

Configuration:
Referencing Table Requirement Comment
SUEWS_Soil.txt MD SoilStoreCap must not be greater than SoilDepth.
SoilTypeCode
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt 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.
SUEWS_Veg.txt 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.
StartDLS
Description:

Start of the day light savings [DOY]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Start of the day light savings [DOY] See Day Light Savings (DLS).
StateLimit
Description:

Upper limit to the surface state. [mm]

Currently only used for the water surface. Set to a large value (e.g. 20000 mm = 20 m) if the water body is substantial (lake, river, etc) or a small value (e.g. 10 mm) if water bodies are very shallow (e.g. fountains). WaterDepth (column 9) must not exceed this value.

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Currently only used for the water surface
SUEWS_Veg.txt MD Currently only used for the water surface
SUEWS_Water.txt MU Surface state cannot exceed this value. Set to a large value (e.g. 20000 mm = 20 m) if the water body is substantial (lake, river, etc) or a small value (e.g. 10 mm) if water bodies are very shallow (e.g. fountains). WaterDepth (column 9) must not exceed this value.
StorageMax
Description:

Maximum water storage capacity for upper surfaces (i.e. canopy) Min and max values are to account for seasonal variation (e.g. leaf-on/leaf-off differences for vegetated surfaces). Not currently used for non-vegetated surfaces - set the same as StorageMin.

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Maximum water storage capacity for upper surfaces (i.e. canopy) Min and max values are to account for seasonal variation (e.g. leaf-on/leaf-off differences for vegetated surfaces). Not currently used for non-vegetated surfaces - set the same as StorageMin. Example values [mm] 0.48 Paved 0.25 Bldgs 0.8 BSoil
SUEWS_Veg.txt 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]
SUEWS_Water.txt MD Maximum water storage capacity for upper surfaces (i.e. canopy) Min and max values are to account for seasonal variation - not used for water surfaces so set same as StorageMin.
StorageMin
Description:

Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variationMinimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation (e.g. leaf-on/leaf-off differences for vegetated surfaces). Not currently used for non-vegetated surfaces - set the same as StorageMax. Example values [mm] 0.48 Paved 0.25 Bldgs 0.8 BSoil
SUEWS_Veg.txt 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]
SUEWS_Water.txt MD Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation - not used for water surfaces. Example values [mm] 0.5 Water
SurfaceArea
Description:

Area of the grid [ha].

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Area of the grid [ha].
Surf_k1
Description:

Thermal conductivity of the first layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Thermal conductivity of the first layer [W m-1 K-1]
Surf_k2
Description:

Thermal conductivity of the second layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the second layer [W m-1 K-1]
Surf_k3
Description:

Thermal conductivity of the third layer[W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the third layer[W m-1 K-1]
Surf_k4
Description:

Thermal conductivity of the fourth layer[W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the fourth layer[W m-1 K-1]
Surf_k5
Description:

Thermal conductivity of the fifth layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the fifth layer [W m-1 K-1]
Surf_rhoCp1
Description:

Volumetric heat capacity of the first layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Volumetric heat capacity of the first layer [J m-3 K-1]
Surf_rhoCp2
Description:

Volumetric heat capacity of the second layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the second layer [J m-3 K-1]
Surf_rhoCp3
Description:

Volumetric heat capacity of the third layer[J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the third layer[J m-3 K-1]
Surf_rhoCp4
Description:

Volumetric heat capacity of the fourth layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the fourth layer [J m-3 K-1]
Surf_rhoCp5
Description:

Volumetric heat capacity of the fifth layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the fifth layer [J m-3 K-1]
Surf_thick1
Description:

Thickness of the first layer [m] for roofs (building surfaces) and ground (all other surfaces)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Thickness of the first layer [m] for roofs (building surfaces) and ground (all other surfaces)
Surf_thick2
Description:

Thickness of the second layer [m] (if no second layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the second layer [m] (if no second layer, set to -999.)
Surf_thick3
Description:

Thickness of the third layer [m] (if no third layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the third layer [m] (if no third layer, set to -999.)
Surf_thick4
Description:

Thickness of the fourth layer [m] (if no fourth layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the fourth layer [m] (if no fourth layer, set to -999.)
Surf_thick5
Description:

Thickness of the fifth layer [m] (if no fifth layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the fifth layer [m] (if no fifth layer, set to -999.)
Tair
Description:

Air temperature [°C]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt MU Air temperature [°C]
tau_a
Description:

Time constant for snow albedo aging in cold snow [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Time constant for snow albedo aging in cold snow [-]
tau_f
Description:

Time constant for snow albedo aging in melting snow [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Time constant for snow albedo aging in melting snow [-]
tau_r
Description:

Time constant for snow density ageing [-]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MD Time constant for snow density ageing [-]
TCritic_Heating_WD
Description:

Critical heating temperature on weekdays [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
TCritic_Heating_WE
Description:

Critical heating temperature on weekends [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
TCritic_Cooling_WD
Description:

Critical cooling temperature on weekdays [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
TCritic_Cooling_WE
Description:

Critical cooling temperature on weekends [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_AnthropogenicHeat.txt MU O Use with EmissionsMethod = 1
TempMeltFactor
Description:

Hourly temperature melt factor of snow [mm K-1 h-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_Snow.txt MU Hourly temperature melt factor of snow [mm K-1 h-1] (In previous model version, this parameter was 0.12)
TH
Description:

Upper air temperature limit [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Upper air temperature limit [°C]
Theta+_K
Description:

potential temperature at the top of CBL [K]

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU potential temperature at the top of CBL (K)
Theta_K
Description:

potential temperature in CBL [K]

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU potential temperature in CBL (K)
Tiair
Description:

Indoor air temperature [˚C]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Indoor air temperature [˚C]
Timezone
Description:

Time zone [h] for site relative to UTC (east is positive). This should be set according to the times given in the meteorological forcing file(s).

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Time zone [h] for site relative to UTC (east is positive). This should be set according to the times given in the meteorological forcing file(s).
TL
Description:

Lower air temperature limit [°C]

Configuration:
Referencing Table Requirement Comment
SUEWS_Conductance.txt MD Lower air temperature limit [°C]
ToBldgs
Description:

Fraction of water going to Bldgs

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to Bldgs
ToBSoil
Description:

Fraction of water going to BSoil

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to BSoil
ToDecTr
Description:

Fraction of water going to DecTr

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to DecTr
ToEveTr
Description:

Fraction of water going to EveTr

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to EveTr
ToGrass
Description:

Fraction of water going to Grass

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to Grass
ToPaved
Description:

Fraction of water going to Paved

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to Paved
ToRunoff
Description:

Fraction of water going to Runoff

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to Runoff
ToSoilStore
Description:

Fraction of water going to SoilStore

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to SoilStore
ToWater
Description:

Fraction of water going to Water

Configuration:
Referencing Table Requirement Comment
SUEWS_WithinGridWaterDist.txt MU Fraction of water going to Water
TraffProfWD
Description:

Code for traffic activity profile (weekdays) linking to Code of SUEWS_Profiles.txt. Not used in v2018a.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
TraffProfWE
Description:

Code for traffic activity profile (weekends) linking to Code of SUEWS_Profiles.txt. Not used in v2018a.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
TrafficUnits
Description:

Units for the traffic rate for the study area. Not used in v2018a.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
TrafficRate_WD
Description:

Weekday traffic rate [veh km m-2 s-1] Can be used for CO2 flux calculation - not used in v2018a.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekday traffic rate [veh km m-2 s-1] Can be used for CO2 flux calculation.
TrafficRate_WE
Description:

Weekend traffic rate [veh km m-2 s-1] Can be used for CO2 flux calculation - not used in v2018a.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Weekend traffic rate [veh km m-2 s-1] Can be used for CO2 flux calculation.
Troad
Description:

Ground surface temperature [˚C] (used when TsurfChoice = 1 or 2)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Ground surface temperature [˚C] (used when TsurfChoice = 1 or 2)
Troof
Description:

Roof surface temperature [˚C] (used when TsurfChoice = 1 or 2)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Roof surface temperature [˚C] (used when TsurfChoice = 1 or 2)
Tsurf
Description:

Bulk surface temperature [˚C] (used when TsurfChoice = 0)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Bulk surface temperature [˚C] (used when TsurfCoice = 0)
Twall
Description:

Wall surface temperature [˚C] (used when TsurfChoice = 1)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU Wall surface temperature [˚C] (used when TsurfChoice = 1)
Twall_e
Description:

East-facing wall surface temperature [˚C] (used when TsurfChoice = 2)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU East-facing wall surface temperature [˚C] (used when TsurfChoice = 2)
Twall_n
Description:

North-facing wall surface temperature [˚C] (used when TsurfChoice = 2)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU North-facing wall surface temperature [˚C] (used when TsurfChoice = 2)
Twall_s
Description:

South-facing wall surface temperature [˚C] (used when TsurfChoice = 2)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU South-facing wall surface temperature [˚C] (used when TsurfChoice = 2)
Twall_w
Description:

West-facing wall surface temperature [˚C] (used when TsurfChoice = 2)

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_ESTM_Ts_data_tt.txt MU West-facing wall surface temperature [˚C] (used when TsurfChoice = 2)
U
Description:

Wind speed. [m s-1. ]Height of the wind speed measurement (z) is needed in SUEWS_SiteSelect.txt .

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt MU Height of the wind speed measurement (z) is needed in SUEWS_SiteSelect.txt .
Wall_k1
Description:

Thermal conductivity of the first layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Thermal conductivity of the first layer [W m-1 K-1]
Wall_k2
Description:

Thermal conductivity of the second layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the second layer [W m-1 K-1]
Wall_k3
Description:

Thermal conductivity of the third layer [W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the third layer [W m-1 K-1]
Wall_k4
Description:

Thermal conductivity of the fourth layer[W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the fourth layer[W m-1 K-1]
Wall_k5
Description:

Thermal conductivity of the fifth layer[W m-1 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thermal conductivity of the fifth layer[W m-1 K-1]
Wall_rhoCp1
Description:

Volumetric heat capacity of the first layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Volumetric heat capacity of the first layer [J m-3 K-1]
Wall_rhoCp2
Description:

Volumetric heat capacity of the second layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the second layer [J m-3 K-1]
Wall_rhoCp3
Description:

Volumetric heat capacity of the third layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the third layer [J m-3 K-1]
Wall_rhoCp4
Description:

Volumetric heat capacity of the fourth layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the fourth layer [J m-3 K-1]
Wall_rhoCp5
Description:

Volumetric heat capacity of the fifth layer [J m-3 K-1]

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Volumetric heat capacity of the fifth layer [J m-3 K-1]
Wall_thick1
Description:

Thickness of the first layer [m] for building surfaces only; set to -999 for all other surfaces

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt MU Thickness of the first layer [m] for building surfaces only; set to -999 for all other surfaces
Wall_thick2
Description:

Thickness of the second layer [m] (if no second layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the second layer [m] (if no second layer, set to -999.)
Wall_thick3
Description:

Thickness of the third layer [m] (if no third layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the third layer [m] (if no third layer, set to -999.)
Wall_thick4
Description:

Thickness of the fourth layer [m] (if no fourth layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the fourth layer [m] (if no fourth layer, set to -999.)
Wall_thick5
Description:

Thickness of the fifth layer [m] (if no fifth layer, set to -999.)

Configuration:
Referencing Table Requirement Comment
SUEWS_ESTMCoefficients.txt O Thickness of the fifth layer [m] (if no fifth layer, set to -999.)
WaterDepth
Description:

Water depth [mm].

Configuration:
Referencing Table Requirement Comment
SUEWS_Water.txt MU Set to a large value (e.g. 20000 mm = 20 m) if the water body is substantial (lake, river, etc) or a small value (e.g. 10 mm) if water bodies are very shallow (e.g. fountains). This value must not exceed StateLimit (column 8).
WaterUseProfAutoWD
Description:

Code for water use profile (automatic irrigation, weekdays) linking to Code of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for water use profile (automatic irrigation, weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
WaterUseProfAutoWE
Description:

Code for water use profile (automatic irrigation, weekends) linking to Code of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for water use profile (automatic irrigation, weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
WaterUseProfManuWD
Description:

Code for water use profile (manual irrigation, weekdays) linking to Code of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for water use profile (manual irrigation, weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
WaterUseProfManuWE
Description:

Code for water use profile (manual irrigation, weekends) linking to Code of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_Profiles.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code for water use profile (manual irrigation, weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.
wdir
Description:

Wind direction [deg].

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Not available in this version.
WetThreshold
Description:

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

Configuration:
Referencing Table Requirement Comment
SUEWS_NonVeg.txt MD Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface. Example values [mm] 0.6 Paved 0.6 Bldgs 1. BSoil
SUEWS_Veg.txt 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
SUEWS_Water.txt MD Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface. Example values [mm] 0.5 Water
WithinGridBldgsCode
Description:

Code that links to the fraction of water that flows from Bldgs surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from Bldgs surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
WithinGridBSoilCode
Description:

Code that links to the fraction of water that flows from BSoil surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from BSoil surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
WithinGridDecTrCode
Description:

Code that links to the fraction of water that flows from DecTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from DecTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
WithinGridEveTrCode
Description:

Code that links to the fraction of water that flows from EveTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from EveTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
WithinGridGrassCode
Description:

Code that links to the fraction of water that flows from Grass surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from Grass surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
WithinGridPavedCode
Description:

Code that links to the fraction of water that flows from Paved surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt . Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from Paved surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
WithinGridWaterCode
Description:

Code that links to the fraction of water that flows from Water surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in Code of SUEWS_WithinGridWaterDist.txt.

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt L Code that links to the fraction of water that flows from Water surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_WithinGridWaterDist.txt.
Wuh
Description:

External water use [m3]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O External water use [ m3]
xsmd
Description:

Observed soil moisture [m3 m-3 or kg kg-1]

Configuration:
Referencing Table Requirement Comment
SSss_YYYY_data_tt.txt O Observed soil moisture [ m3 m-3 or kg kg-1]
Year
Description:

Year [YYYY]

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU Year [YYYY] Years must be continuous. If running multiple years, ensure the rows in SUEWS_SiteSelect.txt are arranged so that all grids for a particular year appear on consecutive lines (rather than grouping all years together for a particular grid).
z
Description:

Measurement height [m].

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt MU z must be greater than the displacement height. Forcing data should be representative of the local-scale, i.e. above the height of the roughness elements.
z0
Description:

Roughness length for momentum [m] Value supplied here is used if RoughLenMomMethod = 1 in RunControl.nml ; otherwise set to ‘-999’ and a value will be calculated by the model (RoughLenMomMethod = 2, 3).

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Value supplied here is used if RoughLenMomMethod = 1 in RunControl.nml ; otherwise set to ‘-999’ and a value will be calculated by the model (RoughLenMomMethod = 2, 3).
zd
Description:

Zero-plane displacement [m] Value supplied here is used if RoughLenMomMethod = 1 in RunControl.nml ; otherwise set to ‘-999’ and a value will be calculated by the model (RoughLenMomMethod = 2, 3).

Configuration:
Referencing Table Requirement Comment
SUEWS_SiteSelect.txt O Value supplied here is used if RoughLenMomMethod = 1 in RunControl.nml ; otherwise set to ‘-999’ and a value will be calculated by the model (RoughLenMomMethod = 2, 3).
zi0
Description:

initial convective boundary layer height (m)

Configuration:
Referencing Table Requirement Comment
CBL_initial_data.txt MU initial convective boundary layer height [m]