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 EmissionMethod = 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	`MD`	`1` [Järvi et al., 2011] `2` [Ward et al., 2016] Recommended in this version.
`3` as in [Järvi et al., 2011]	but using 2 meter air temperature
`4` as in [Ward et al., 2016] Recommended in this version.”	but using 2 meter air temperature

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

OBS_SMCap#

Description

The maximum observed soil moisture. [m³ m^-3 or kg kg^-1]

Configuration

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

OBS_SMDepth#

Description

The depth of soil moisture measurements. [mm]

Configuration

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

OBS_SoilNotRocks#

Description

Fraction of soil without rocks. [-]

Configuration

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

OHMCode_SummerDry#

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_NonVeg.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Veg.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Water.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Snow.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMCode_SummerWet#

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_NonVeg.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Veg.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Water.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Snow.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMCode_WinterDry#

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_NonVeg.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Veg.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Water.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Snow.txt	`L`	Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMCode_WinterWet#

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_NonVeg.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Veg.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Water.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.
SUEWS_Snow.txt	`L`	Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMThresh_SW#

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_NonVeg.txt	`MD`	Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.
SUEWS_Veg.txt	`MD`	Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.
SUEWS_Water.txt	`MD`	Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.
SUEWS_Snow.txt	`MD`	Not actually used for Snow surface as winter wet conditions always assumed.

OHMThresh_WD#

Description

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

Configuration

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

PipeCapacity#

Description

Storage capacity of pipes [mm]

Configuration

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

PopDensDay#

Description

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

Configuration

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

PopDensNight#

Description

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

Configuration

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

PopProfWD#

Description

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

Configuration

Referencing Table	Requirement	Comment
SUEWS_AnthropogenicEmission.txt	`O`	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 EmissionMethod=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 EmissionMethod=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 EmissionMethod=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 EmissionMethod=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 EmissionMethod=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