Note

Please report issues with the manual on the GitHub page.

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]

ActivityProfWD

Description

Code linking to ActivityProfWD in SUEWS_Profiles.txt.

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.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 this version.

ActivityProfWE

Description

Code linking to ActivityProfWE in SUEWS_Profiles.txt.

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.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 this version.

AHMin_WD

Description

Minimum QF on weekdays [W m^-2]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 1

AHMin_WE

Description

Minimum QF on weekends [W m^-2]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.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_AnthropogenicEmission.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_AnthropogenicEmission.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_AnthropogenicEmission.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_AnthropogenicEmission.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 [-] 0.1 EveTr Oke (1987) [Ok87] 0.18 DecTr Oke (1987) [Ok87] 0.21 Grass Oke (1987) [Ok87]
SUEWS_Water.txt	MU	Example values [-] 0.1 Water Oke (1987) [Ok87]
SUEWS_Snow.txt	MU	Example values [-] 0.85 Järvi et al. (2014) [Leena2014]

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 [-] 0.1 EveTr Oke (1987) [Ok87] 0.18 DecTr Oke (1987) [Ok87] 0.21 Grass Oke (1987) [Ok87]
SUEWS_Water.txt	MU	Not currently used for water surface - set same as AlbedoMax.
SUEWS_Snow.txt	MU	Example values [-] 0.18 Järvi et al. (2014) [Leena2014]

alpha

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example values: EmissionsMethod = 11, 12, 13, 14, 15 or 16: 0.044 Ruimy et al (1995) [R95], 0.0593 Schmid et al. (2000) [S2000], 0.0205 Flanagan et al. (2002) [FWC2002]. EmissionsMethod = 21, 22, 23, 24, 25, or 26: 0.031 Bellucco et al. (2017) [B2017] EmissionsMethod = 31, 32, 33, 34, 35, 36: 0.005 Bellucco et al. (2017) [B2017]

Alt

Description

Altitude of grids [m].

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_AnthropogenicEmission.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	Value of integer is arbitrary but must match code specified in column 1 of SUEWS_AnthropogenicEmission.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]

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: 5 for EveTr Järvi et al. (2011) [J11]

BaseTe

Description

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

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: 10 EveTr Järvi et al. (2011) [J11]

BaseT_HC

Description

Base temperature for heating degree days [°C]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.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 ]

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example values: EmissionsMethod = 11, 12, 13, 14, 15, 16: 43.35 Ruimy et al. (1995) [R95], 35 Schmid et al. (2000) [S2000], 16.3 Flanagan et al. (2002) [FWC2002] EmissionsMethod = 21, 22, 23, 24, 25, 26: 17.793 Bellucco et al. (2017) [B2017] EmissionsMethod = 31, 32, 33, 34, 35, 36: 8.474 Bellucco et al. (2017) [B2017]

theta

Description

The convexity of the curve at light saturation.

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example value: EmissionsMethod = 21, 22, 23, 24, 25, 26: 0.723 Bellucco et al. (2017) [B2017] EmissionsMethod = 31, 32, 33, 34, 35, 36: 0.96 Bellucco et al. (2017) [B2017]

alpha_enh

Description

Part of the alpha coefficient related to the fraction of vegetation.

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example value: 0.016 Bellucco et al. (2017) [B2017]

beta_enh

Description

Part of the beta coefficient related to the fraction of vegetation.

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example values: 33.454 Bellucco et al. (2017) [B2017]

resp_a

Description

Respiration coefficient a.

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example values: 1.08 Schmid et al. (2000) [S2000], 3.229 Järvi et al. (2012) [J12]

resp_b

Description

Respiration coefficient b - related to air temperature dependency.

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example values: 0.0064 Schmid et al. (2000) [S2000], 0.0329 Järvi et al. (2012) [J12].

min_respi

Description

Minimum soil respiration rate (for cold-temperature limit) [umol m^-2 s^-1].

Configuration

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	MU O	Example values: 0.6 estimate from Hyytiälä forest site.

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	Can be used for CO2 flux calculation. set to -999 Not used in this version.

CO2PointSource

Description

CO2 emission factor [kg km^-1]

Configuration

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	O	CO2 emission factor [kg km-1]

Code

Description

Code linking to a corresponding look-up table.

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_AnthropogenicEmission.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) [Ja76] 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 = 3, 10 for Paved and Bldgs; DrainageEq = 2, 0.013 for BSoil
SUEWS_Veg.txt	MD	Example values: DrainageEq = 3, 10 for Grass (irrigated); DrainageEq = 2, 0.013 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, 3 for Paved and Bldgs DrainageEq = 2, 1.71 for BSoil
SUEWS_Veg.txt	MD	Example values: DrainageEq = 3, 3 for Grass (irrigated) DrainageEq = 2, 1.71 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]) 3: for BSoil Falk and Niemczynowicz (1978) [FN78]; for Paved and Bldgs Coefficients are specified in the following two columns. Recommended in this version.
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] ) 3: for EveTr, DecTr, Grass (unirrigated) Falk and Niemczynowicz (1978) [FN78] Coefficients are specified in the following two columns. Recommended in this version.
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 [-] 0.98 EveTr Oke (1987) [Ok87] 0.98 DecTr Oke (1987) [Ok87] 0.93 Grass Oke (1987) [Ok87]
SUEWS_Water.txt	MU	Example values [-] 0.95 Water Oke (1987) [Ok87]
SUEWS_Snow.txt	MU	Example values [-] 0.99 Järvi et al. (2014) [Leena2014]

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

Emission factor for heat [J k|m^-1|].

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	O	Emission factor for heat [J k|m^-1|]. Example values: 3.97e6 Sailor and Lu (2004) [SL04]

EnergyUseProfWD

Description

Code linking to EnergyUseProfWD in SUEWS_Profiles.txt.

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.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_AnthropogenicEmission.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_kgkmWD

Description

CO2 emission factor for weekdays [kg km^-1]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	O	CO2 emission factor for weekdays [kg km-1] Can be used for CO2 flux calculation.

FcEF_v_kgkmWE

Description

CO2 emission factor for weekends [kg km^-1]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	O	CO2 emission factor for weekdays [kg km-1] Can be used for CO2 flux calculation.

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 EveTr: 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.

FrPDDwe

Description

Fraction of weekend population to weekday population. [-]

Configuration

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 [mm-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].

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: 300 for EveTr 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]

H_maintain

Description

water depth to maintain used in automatic irrigation (e.g., ponding water due to flooding irrigation in rice crop-field) [mm].

Note

1. H_maintain can be positive (e.g., ponding water due to flooding irrigation in rice crop-field) or negative (e.g., soil water store level to maintain: SoilStoreCap + H_maintain ) or zero (e.g., to maintain a maximum soil store level, i.e., SoilStoreCap).

2. Disable this feature by setting this parameter to -999: then no restrictions will be applied to maintain available water level.

Configuration

Referencing Table	Requirement	Comment
SUEWS_Irrigation.txt	MU	water depth to maintain used in automatic irrigation.

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_Paved

Description

Fraction of Paved that is irrigated [-]

Configuration

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	MU	Fraction of paved surfaces that are irrigated [-]

IrrFr_Bldgs

Description

Fraction of Bldgs that is irrigated [-]

Configuration

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	MU	Fraction of rooftop of buildings (e.g., green roofs) that are irrigated [-]

IrrFr_DecTr

Description

Fraction of DecTr that is irrigated [-]

Configuration

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

IrrFr_EveTr

Description

Fraction of EveTr that is 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 [-]

IrrFr_BSoil

Description

Fraction of BSoil that is irrigated [-]

Configuration

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	MU	Fraction of bare soil that are irrigated [-]

IrrFr_Water

Description

Fraction of Water that is irrigated [-]

Configuration

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	MU	Fraction of water that are 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 0 Järvi et al. (2011) [J11] 1 Järvi et al. (2014) [Leena2014]

LAIMax

Description

full leaf-on summertime value

Configuration

Referencing Table	Requirement	Comment
SUEWS_Veg.txt	MD	full leaf-on summertime value Example values: - 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: - 4. EveTr Järvi et al. (2011) [J11] - 1. DecTr Järvi et al. (2011) [J11] - 1.6 Grass Grimmond and Oke (1991) [G91]

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 LAIEq = 0: 0.03 Järvi et al. (2011) [J11] LAIEq = 1: 0.04 Järvi et al. (2014) [Leena2014]

LeafGrowthPower2

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_Veg.txt	MD	Example values LAIEq = 0: 0.0005 Järvi et al. (2011) [J11] LAIEq = 1: 0.001 Järvi et al. (2014) [Leena2014]

LeafOffPower1

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_Veg.txt	MD	Example values LAIEq = 0: 0.03 Järvi et al. (2011) [J11] LAIEq = 1: -1.5 Järvi et al. (2014) [Leena2014]

LeafOffPower2

Description

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

Configuration

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

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_AnthropogenicEmission.txt	O	Maximum value for human heat emission. [W m-2]

MaxFCMetab

Description

Maximum (day) CO2 from human metabolism. [W m^-2]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	O	Maximum (day) CO2 from human metabolism. [W m-2]

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]

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_AnthropogenicEmission.txt	O	Minimum value for human heat emission. [W m-2].

MinFCMetab

Description

Minimum (night) CO2 from human metabolism. [W m^-2]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	O	Minimum (night) CO2 from human metabolism. [W m-2]

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. [m³ m^-3 or kg kg^-1]

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]

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. [-]

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_AnthropogenicEmission.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_AnthropogenicEmission.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)

PrecipLimAlb

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

Temperature limit when precipitation falls as snow [°C]

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_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 2 Example values: 0.3081 Järvi et al. (2011) [J11] 0.1 Järvi et al. (2014) [Leena2014]

QF_A_WE

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 2 Example values: 0.3081 Järvi et al. (2011) [J11] 0.1 Järvi et al. (2014) [Leena2014]

QF_B_WD

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 2 Example values: 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_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 2 Example values: 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_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 2 Example values: 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_AnthropogenicEmission.txt	MU O	Example values: 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: -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

SnowDensMin

Description

Fresh snow density [kg m^-3]

Configuration

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	Limit of snow water equivalent when the surface is fully covered with snow. Not needed if SnowUse = 0 in RunControl.nml . Example values: 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 is fully covered with snow. Not needed if SnowUse = 0 in RunControl.nml . Example values: 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] 40: Paved Järvi et al. (2014) [Leena2014] 100: Bldgs Järvi et al. (2014) [Leena2014]

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)

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: 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: 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).

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: 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: 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: -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_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 1

TCritic_Heating_WE

Description

Critical heating temperature on weekends [°C]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 1

TCritic_Cooling_WD

Description

Critical cooling temperature on weekdays [°C]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	MU O	Use with EmissionsMethod = 1

TCritic_Cooling_WE

Description

Critical cooling temperature on weekends [°C]

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.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_AnthropogenicEmission.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_AnthropogenicEmission.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_AnthropogenicEmission.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.

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.

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: 0.6 Paved 0.6 Bldgs BSoil
SUEWS_Veg.txt	MD	Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface. Example values: 1.8 EveTr DecTr Grass
SUEWS_Water.txt	MD	Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface. Example values: 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

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.

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.

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.

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.

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.

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.

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 [m³]

Configuration

Referencing Table	Requirement	Comment
SSss_YYYY_data_tt.txt	O	External water use [ m3]

xsmd

Description

Observed soil moisture [m³ 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]

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]

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]