Input Options

Example values: EmissionsMethod = 11, 12, 13, 14, 15 or 16:

EmissionsMethod = 21, 22, 23, 24, 25, or 26: 0.031 [Bellucco et al., 2017] EmissionsMethod = 31, 32, 33, 34, 35, 36: 0.005 [Bellucco et al., 2017]

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) [ m² ].

Configuration:

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	`MU`	Area of wall within grid (needed for ESTM calculation). [ m² ]

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 of Järvi et al. [2014]. Example values: 5 for EveTr [Järvi et al., 2011]

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] ; Appendix A Järvi et al. [2014] . Example values: 10 EveTr Järvi et al. [2011]

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]

beta#

Description:

The light-saturated gross photosynthesis of the canopy describing the maximum photosynthesis the certain vegetation can have. [umol m^-2 s^-1 ]

Configuration:

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

Example values: EmissionsMethod = 45 (Recommended): - 8.35 (Street tree Tilia) [Havu et al., 2022] - 13.18 (Street tree Alnus) [Havu et al., 2022] - 5.5 (Lawn): [Zheng et al., 2023]

Not recommended: EmissionsMethod = 11 - 16:

EmissionsMethod = 21 - 26: 17.793 [Bellucco et al., 2017] EmissionsMethod = 31 - 36: 8.474 [Bellucco et al., 2017]

theta#

Description:

The convexity of the curve at light saturation. Not in use.

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] `EmissionsMethod` = 31, 32, 33, 34, 35, 36: 0.96 [Bellucco et al., 2017]

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]

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]

resp_a#

Description:

Soil and vegetation respiration coefficient a.

Configuration:

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	`MU` `O`	Example values: 1.08 (broadleaf forest, US) [Schmid, 2000] 2.1 (lawn, Helsinki) [Järvi et al., 2019]
0.78 (Tilia street tree	no soil	Helsinki) [Havu et al., 2022]”
1.11 (Alnus street tree	no soil	Helsinki) [Havu et al., 2022]”

resp_b#

Description:

Soil and vegetation respiration coefficient b - related to air temperature dependency.

Configuration:

Referencing Table	Requirement	Comment
SUEWS_BiogenCO2.txt	`MU` `O`	Example values: 0.0064 (deciduous forest, US) [Schmid, 2000] 0.06 (lawn, Helsinki) [Järvi et al., 2019]
0.08 (Tilia street tree	no soil	Helsinki) [Havu et al., 2022]”
0.08 (Alnus street tree	no soil	Helsinki) [Havu et al., 2022]”

min_respi#

Description:

Minimum soil and vegetation 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.

CO2PointSource#

Description:

CO2 emission point source within the grid [kgC day^-1]

Configuration:

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	`O`	CO2 emission point source within the grid [kgC day^-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] 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] 2: Halldin et al. [1979] (Rutter eqn corrected for c=0, see Calder and Wright [1986]) 3: for `BSoil` [Falk and Niemczynowicz, 1978] ; 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] 2: Halldin et al. [1979] (Rutter eqn corrected for c=0, see Calder & Wright (1986) [Calder and Wright, 1986] ) 3: for `EveTr`, `DecTr`, Grass (unirrigated) see Falk and Niemczynowicz [1978]. 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. [umol CO2 J^-1]

Configuration:

Referencing Table	Requirement	Comment
SUEWS_SiteSelect.txt	`O`	Used with EmissionsMethod = 4 to calculate building CO2 emissions.

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, 2002] 0.98 DecTr [Oke, 2002] 0.93 Grass [Oke, 2002]
SUEWS_Water.txt	`MU`	Example values [-] 0.95 Water [Oke, 2002]
SUEWS_Snow.txt	`MU`	Example values [-] 0.99 [Järvi et al., 2014]

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 from traffic [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) [Sailor and Lu, 2004]

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 traffic on 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 traffic on 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:

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	`MU` `O`	Fraction of weekend population to weekday population. [-]

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] ; Appendix A Järvi et al. [2014] for more details. Example values: 300 for `EveTr` Järvi et al. [2011]

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

Surface conductance model selection: - 1 Järvi et al. (2011) model using measurement height air temperature [Järvi et al., 2011] - 2 Ward et al. (2016) model using measurement height air temperature [Ward et al., 2016] Recommended in this version. - 3 Järvi et al. (2011) model using 2-meter air temperature (standardized height) - 4 Ward et al. (2016) model using 2-meter air temperature (standardized height) Recommended in this version.

Models 2 and 4 are recommended as they provide better representation of stomatal responses to environmental controls. Models 3 and 4 use standardized 2-meter air temperature for improved consistency across different measurement heights.

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

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

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

Options

0 Järvi et al. [2011]
1 Järvi et al. [2014]

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) [Breuer et al., 2003] - 5.5 DecTr Breuer et al. (2003) [Breuer et al., 2003] - 5.9 Grass Breuer et al. (2003) [Breuer et al., 2003]

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] - 1. DecTr [Järvi et al., 2011] - 1.6 Grass [Grimmond and Oke, 1991]

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

Example values

LAIEq = 0: 0.03 [Järvi et al., 2011]
LAIEq = 1: 0.04 [Järvi et al., 2014]

LeafGrowthPower2#

Description:

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

Configuration:

Referencing Table

Requirement

Comment

Example values

LAIEq = 0: 0.0005 [Järvi et al., 2011]
LAIEq = 1: 0.001 [Järvi et al., 2014]

LeafOffPower1#

Description:

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

Configuration:

Referencing Table

Requirement

Comment

Example values

LAIEq = 0: 0.03 [Järvi et al., 2011]
LAIEq = 1: -1.5 [Järvi et al., 2014]

LeafOffPower2#

Description:

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

Configuration:

Referencing Table

Requirement

Comment

Example values

LAIEq = 0: 0.0005 [Järvi et al., 2011]
LAIEq = 1: 0.0015 [Järvi et al., 2014]

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

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

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

MaxQFMetab#

Description:

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

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

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. [umol s^-1 cap^-1]

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

Example values [mm s^-1]

7.4: EveTr [Järvi et al., 2011]
11.7: DecTr [Järvi et al., 2011]
33.1: Grass (unirrigated) [Järvi et al., 2011]
40.: Grass (irrigated) [Järvi et al., 2011]

MinQFMetab#

Description:

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

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

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. [umol s^-1 cap^-1]

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

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`	Code for population density profile (weekdays).

PopProfWE#

Description:

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

Configuration:

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	`O`	Code for population density profile (weekends)

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]

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

Use with EmissionsMethod = 2

Example values:

0.3081 [Järvi et al., 2011]
0.1 [Järvi et al., 2014]

QF_A_WE#

Description:

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

Configuration:

Referencing Table

Requirement

Comment

Use with EmissionsMethod = 2

Example values:

0.3081 [Järvi et al., 2011]
0.1 [Järvi et al., 2014]

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

Use with EmissionsMethod = 2

Example values:

0.0099 [Järvi et al., 2011]
0.0099 [Järvi et al., 2014]

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

Use with EmissionsMethod = 2

Example values:

0.0099 [Järvi et al., 2011]
0.0099 [Järvi et al., 2014]

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

Use with EmissionsMethod = 2

Example values:

0.0102 [Järvi et al., 2011]
0.0102 [Järvi et al., 2014]

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

Example values:

0.0102 [Järvi et al., 2011]
0.0102 [Järvi et al., 2014]

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

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 of Järvi et al. [2011] and Appendix A of Järvi et al. [2014] for more details.

Example values:

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

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]
190: Bldgs [Järvi et al., 2014]
190: BSoil [Järvi et al., 2014]

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]
190: DecTr [Järvi et al., 2014]
190: Grass [Järvi et al., 2014]

SnowLimRemove#

Description:

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

Configuration:

Referencing Table

Requirement

Comment

O

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

Example values [mm]

40: Paved [Järvi et al., 2014]
100: Bldgs [Järvi et al., 2014]

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

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

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:

SUEWS_Water.txt

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

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

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:

SUEWS_Water.txt

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`	Used with EmissionsMethod=4 to calculate CO2 and heat emissions.

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`	Used with EmissionsMethod=4 to calculate CO2 and heat emissions.

TrafficUnits#

Description:

Units for the traffic rate for the study area. 1 = [veh km m^-2 day^-1] 2 = [veh km cap^-1 day^-1]). Not used in v2018a.

Configuration:

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	`O`	Used with EmissionsMethod=4.

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]. Used with EmissionsMethod=4 to calculate CO2 and heat emissions.

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]. Used with EmissionsMethod=4 to calculate CO2 and heat emissions.

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

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

Example values:

0.6 Paved
0.6 Bldgs
1. BSoil

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

Example values:

1.8 EveTr
1. DecTr
1. Grass

SUEWS_Water.txt