Note

  1. Please report issues with the manual on the GitHub page.

  2. Please cite SUEWS with proper information from our Zenodo page.

4.2.14. Input Options

a1
Description

Coefficient for Q* term [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_OHMCoefficients.txt

MU

Coefficient for Q* term [-]

a2
Description

Coefficient for dQ*/dt term [h]

Configuration

Referencing Table

Requirement

Comment

SUEWS_OHMCoefficients.txt

MU

Coefficient for dQ*/dt term [h]

a3
Description

Constant term [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_OHMCoefficients.txt

MU

Constant term [W m-2]

ActivityProfWD
Description

Code linking to ActivityProfWD in SUEWS_Profiles.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

L

Code for human activity profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. Used for CO2 flux calculation.

Not used in this version.

ActivityProfWE
Description

Code linking to ActivityProfWE in SUEWS_Profiles.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

L

Code for human activity profile (weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Look the codes Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. Used for CO2 flux calculation.

Not used in this version.

AHMin_WD
Description

Minimum QF on weekdays [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

AHMin_WE
Description

Minimum QF on weekends [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

AHSlope_Heating_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

AHSlope_Heating_WE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

AHSlope_Cooling_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

AHSlope_Cooling_WE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

AlbedoMax
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MU

Effective surface albedo (middle of the day value) for summertime. View factors should be taken into account.

SUEWS_Veg.txt

MU

Example values [-]

SUEWS_Water.txt

MU

Example values [-]

SUEWS_Snow.txt

MU

Example values [-]

AlbedoMin
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MU

Not currently used for non-vegetated surfaces – set the same as AlbedoMax.

SUEWS_Veg.txt

MU

Example values [-]

SUEWS_Water.txt

MU

Not currently used for water surface - set same as AlbedoMax.

SUEWS_Snow.txt

MU

Example values [-]

alpha
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

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

Alt
Description

Altitude of grids [m].

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Used for both the radiation and water flow between grids. Not available in this version.

AnOHM_Ch
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MU

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

SUEWS_Veg.txt

MU

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

SUEWS_Water.txt

MU

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

SUEWS_Snow.txt

MU

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

AnOHM_Cp
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MU

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

SUEWS_Veg.txt

MU

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

SUEWS_Water.txt

MU

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

SUEWS_Snow.txt

MU

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

AnOHM_Kk
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MU

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

SUEWS_Veg.txt

MU

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

SUEWS_Water.txt

MU

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

SUEWS_Snow.txt

MU

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

AnthropogenicCode
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Value of integer is arbitrary but must match code specified in column 1 of SUEWS_AnthropogenicEmission.txt.

AreaWall
Description

Area of wall within grid (needed for ESTM calculation) [ |m^2| ].

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Area of wall within grid (needed for ESTM calculation). [ |m^2| ]

BaseT
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MU

See section 2.2 Järvi et al. (2011); Appendix A Järvi et al. (2014). Example values: 5 for EveTr Järvi et al. (2011) [J11]

BaseTe
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MU

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

BaseT_HC
Description

Base temperature for heating degree days [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU

Base temperature for heating degree days [°C] e.g. Sailor and Vasireddy (2006) [SV06]

beta
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

Example values:

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

theta
Description

The convexity of the curve at light saturation.

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

Example value: EmissionsMethod = 21, 22, 23, 24, 25, 26: 0.723 Bellucco et al. (2017) [B2017] EmissionsMethod = 31, 32, 33, 34, 35, 36: 0.96 Bellucco et al. (2017) [B2017]

alpha_enh
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

Example value: 0.016 Bellucco et al. (2017) [B2017]

beta_enh
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

Example values: 33.454 Bellucco et al. (2017) [B2017]

resp_a
Description

Respiration coefficient a.

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

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

resp_b
Description

Respiration coefficient b - related to air temperature dependency.

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

Example values: 0.0064 Schmid et al. (2000) [S2000], 0.0329 Järvi et al. (2012) [J12].

min_respi
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_BiogenCO2.txt

MU O

Example values: 0.6 estimate from Hyytiälä forest site.

BiogenCO2Code
Description

Code linking to the Code column in SUEWS_BiogenCO2.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

L

Code linking to the Code column in SUEWS_BiogenCO2.txt.

QF0_BEU_WD
Description

Building energy use [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

QF0_BEU_WE
Description

Building energy use [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Can be used for CO2 flux calculation. set to -999 Not used in this version.

CO2PointSource
Description

CO2 emission factor [kg km-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

CO2 emission factor [kg km-1]

Code
Description

Code linking to a corresponding look-up table.

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

Code linking to SUEWS_SiteSelect.txt for paved surfaces (Code_Paved), buildings (Code_Bldgs) and bare soil surfaces (Code_BSoil). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.

SUEWS_Veg.txt

L

Code linking to SUEWS_SiteSelect.txt for evergreen trees and shrubs (Code_EveTr), deciduous trees and shrubs (Code_DecTr) and grass surfaces (Code_Grass). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.

SUEWS_Water.txt

L

Code linking to SUEWS_SiteSelect.txt for water surfaces (Code_Water). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.

SUEWS_Snow.txt

L

Code linking to SUEWS_SiteSelect.txt for snow surfaces (SnowCode). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.

SUEWS_Soil.txt

L

Code linking to the SoilTypeCode column in SUEWS_NonVeg.txt (for Paved, Bldgs and BSoil surfaces) and SUEWS_Veg.txt (for EveTr, DecTr and Grass surfaces). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.

SUEWS_Conductance.txt

L

Code linking to the CondCode column in SUEWS_SiteSelect.txt . Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.

SUEWS_AnthropogenicEmission.txt

L

Code linking to the AnthropogenicCode column in SUEWS_SiteSelect.txt . Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.

SUEWS_Irrigation.txt

L

Code linking to SUEWS_SiteSelect.txt for irrigation modelling (IrrigationCode). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.

SUEWS_OHMCoefficients.txt

L

Code linking to the OHMCode_SummerWet, OHMCode_SummerDry, OHMCode_WinterWet and OHMCode_WinterDry columns in SUEWS_NonVeg.txt, SUEWS_Veg.txt, SUEWS_Water.txt and SUEWS_Snow.txt files. Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.

SUEWS_ESTMCoefficients.txt

L

For buildings and paved surfaces, set to zero if there is more than one ESTM class per grid and the codes and surface fractions specified in SUEWS_SiteSelect.txt will be used instead.

SUEWS_BiogenCO2.txt

L

Code linking to the BiogenCO2Code column in SUEWS_Veg.txt.

Code_Bldgs
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for Bldgs surface characteristics Provides the link to column 1 of SUEWS_NonVeg.txt, which contains the attributes describing buildings in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt.

Code_BSoil
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Value of integer is arbitrary but must match code specified in column 1 of SUEWS_NonVeg.txt.

Code_DecTr
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for DecTr surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing deciduous trees and shrubs in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.

Code_ESTMClass_Bldgs1
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Bldgs2
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Bldgs3
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Bldgs4
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Bldgs5
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Paved1
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Paved2
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_ESTMClass_Paved3
Description

Code linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code linking to SUEWS_ESTMCoefficients.txt

Code_EveTr
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for EveTr surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing evergreen trees and shrubs in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.

Code_Grass
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for Grass surface characteristics Provides the link to column 1 of SUEWS_Veg.txt, which contains the attributes describing grass surfaces in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Veg.txt.

Code_Paved
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

Code_Water
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for Water surface characteristics Provides the link to column 1 of SUEWS_Water.txt, which contains the attributes describing open water in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Water.txt.

CondCode
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for surface conductance parameters Provides the link to column 1 of SUEWS_Conductance.txt, which contains the parameters for the Jarvis (1976) [Ja76] parameterisation of surface conductance. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Conductance.txt. e.g. 33 means use the characteristics specified in the row of input file SUEWS_Conductance.txt which has 33 in column 1 (Code).

CRWMax
Description

Maximum water holding capacity of snow [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

Maximum water holding capacity of snow [mm]

CRWMin
Description

Minimum water holding capacity of snow [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

Minimum water holding capacity of snow [mm]

DayWat(1)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWat(2)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWat(3)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWat(4)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWat(5)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWat(6)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWat(7)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(1)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(2)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(3)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(4)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(5)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(6)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DayWatPer(7)
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

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

DrainageCoef1
Description

Coefficient D0 [mm h-1] used in DrainageEq

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

SUEWS_Veg.txt

MD

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

SUEWS_Veg.txt

MD

SUEWS_Water.txt

MD

Not currently used for water surface

DrainageEq
Description

Calculation choice for Drainage equation

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

  • Options:

    • 1: Falk and Niemczynowicz (1978) [FN78]

    • 2: Halldin et al. (1979) [Ha79] (Rutter eqn corrected for c=0, see Calder & Wright (1986) [CW86])

    • 3: for BSoil Falk and Niemczynowicz (1978) [FN78]; for Paved and Bldgs Coefficients are specified in the following two columns. Recommended in this version.

SUEWS_Veg.txt

MD

  • Options:

    • 1: Falk and Niemczynowicz (1978) [FN78]

    • 2: Halldin et al. (1979) [Ha79] (Rutter eqn corrected for c=0, see Calder & Wright (1986) [CW86] )

    • 3: for EveTr, DecTr, Grass (unirrigated) Falk and Niemczynowicz (1978) [FN78] Coefficients are specified in the following two columns. Recommended in this version.

SUEWS_Water.txt

MD

Not currently used for water surface.

EF_umolCO2perJ
Description

Emission factor for fuels used for building heating.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

Emissivity
Description

Effective surface emissivity.

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MU

Effective surface emissivity. View factors should be taken into account.

SUEWS_Veg.txt

MU

Example values [-]

SUEWS_Water.txt

MU

Example values [-]

  • 0.95 Water Oke (1987) [Ok87]

SUEWS_Snow.txt

MU

Example values [-]

EndDLS
Description

End of the day light savings [DOY]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

End of the day light savings [DOY] See Day Light Savings (DLS).

EnEF_v_Jkm
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

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

EnergyUseProfWD
Description

Code linking to EnergyUseProfWD in SUEWS_Profiles.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

L

Code for energy use profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Look the codes Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.

EnergyUseProfWE
Description

Code linking to EnergyUseProfWE in SUEWS_Profiles.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

L

Code for energy use profile (weekends) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt.

ESTMCode
Description

Code for ESTM coefficients linking to SUEWS_ESTMCoefficients.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

For paved and building surfaces, it is possible to specify multiple codes per grid (3 for paved, 5 for buildings) using SUEWS_SiteSelect.txt . In this case, set ESTMCode here to zero.

SUEWS_Veg.txt

L

Code for ESTM coefficients to use for this surface. Links to SUEWS_ESTMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_ESTMCoefficients.txt.

SUEWS_Water.txt

L

Code for ESTM coefficients to use for this surface. Links to SUEWS_ESTMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_ESTMCoefficients.txt.

SUEWS_Snow.txt

L

For paved and building surfaces, it is possible to specify multiple codes per grid (3 for paved, 5 for buildings) using SUEWS_SiteSelect.txt . In this case, set ESTM code here to zero.

FAI_Bldgs
Description

Frontal area index for buildings [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Frontal area index for buildings [-] Required if RoughLenMomMethod = 3 in RunControl.nml .

FAI_DecTr
Description

Frontal area index for deciduous trees [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Frontal area index for deciduous trees [-] Required if RoughLenMomMethod = 3 in RunControl.nml .

FAI_EveTr
Description

Frontal area index for evergreen trees [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Frontal area index for evergreen trees [-] Required if RoughLenMomMethod = 3 in RunControl.nml .

Faut
Description

Fraction of irrigated area that is irrigated using automated systems

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

Fraction of irrigated area that is irrigated using automated systems (e.g. sprinklers).

FcEF_v_kgkmWD
Description

CO2 emission factor for weekdays [kg km-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

CO2 emission factor for weekdays [kg km-1] Can be used for CO2 flux calculation.

FcEF_v_kgkmWE
Description

CO2 emission factor for weekends [kg km-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

CO2 emission factor for weekdays [kg km-1] Can be used for CO2 flux calculation.

FcEF_v_Jkm
Description

Traffic emission factor for CO2.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

fcld
Description

Cloud fraction [tenths]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Cloud fraction [tenths]

FlowChange
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Difference in input and output flows for water surface [mm h-1] Used to indicate river or stream flow through the grid. Currently not fully tested!

Fraction1of8
Description

Fraction of water that can flow to GridConnection1of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction2of8
Description

Fraction of water that can flow to GridConnection2of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction3of8
Description

Fraction of water that can flow to GridConnection3of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction4of8
Description

Fraction of water that can flow to GridConnection4of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction5of8
Description

Fraction of water that can flow to GridConnection5of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction6of8
Description

Fraction of water that can flow to GridConnection6of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction7of8
Description

Fraction of water that can flow to GridConnection7of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fraction8of8
Description

Fraction of water that can flow to GridConnection8of8 [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of water that can flow to the grid specified in previous column [-]

Fr_Bldgs
Description

Surface cover fraction of buildings [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Surface cover fraction of buildings [-]

Fr_Bsoil
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

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

Fr_DecTr
Description

Surface cover fraction of deciduous trees and shrubs [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Surface cover fraction of deciduous trees and shrubs [-]

Fr_ESTMClass_Bldgs1
Description

Surface cover fraction of building class 1 used in ESTM calculations

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 94-98 must add up to 1

Fr_ESTMClass_Bldgs2
Description

Surface cover fraction of building class 2 used in ESTM calculations

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 94-98 must add up to 1

Fr_ESTMClass_Bldgs3
Description

Surface cover fraction of building class 3 used in ESTM calculations

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 94-98 must add up to 1

Fr_ESTMClass_Bldgs4
Description

Surface cover fraction of building class 4 used in ESTM calculations

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 94-98 must add up to 1

Fr_ESTMClass_Bldgs5
Description

Surface cover fraction of building class 5 used in ESTM calculations

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 94-98 must add up to 1

Fr_ESTMClass_Paved1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 88-90 must add up to 1

Fr_ESTMClass_Paved2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 88-90 must add up to 1

Fr_ESTMClass_Paved3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 88-90 must add up to 1

Fr_EveTr
Description

Surface cover fraction of EveTr: evergreen trees and shrubs [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Surface cover fraction of evergreen trees and shrubs [-]

Fr_Grass
Description

Surface cover fraction of Grass [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Surface cover fraction of grass [-]

Fr_Paved
Description

Surface cover fraction of Paved surfaces [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Columns 14 to 20 must sum to 1 .

Fr_Water
Description

Surface cover fraction of open water [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Surface cover fraction of open water [-] (e.g. river, lakes, ponds, swimming pools)

FrFossilFuel_Heat
Description

Fraction of fossil fuels used for building heating [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

FrFossilFuel_NonHeat
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

FrPDDwe
Description

Fraction of weekend population to weekday population. [-]

Configuration

G1
Description

Related to maximum surface conductance [mm s-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to maximum surface conductance [mm s-1]

G2
Description

Related to Kdown dependence [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to Kdown dependence [W m-2]

G3
Description

Related to VPD dependence [units depend on gsModel]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to VPD dependence [units depend on gsChoice in RunControl.nml ]

G4
Description

Related to VPD dependence [units depend on gsModel]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to VPD dependence [units depend on gsChoice in RunControl.nml ]

G5
Description

Related to temperature dependence [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to temperature dependence [°C]

G6
Description

Related to soil moisture dependence [mm-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to soil moisture dependence [mm-1]

gamq_gkgm
Description

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

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

vertical gradient of specific humidity (g kg-1 m-1 )

gamt_Km
Description

vertical gradient of potential temperature [K m-1]

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

vertical gradient of potential temperature (K m-1 ) strength of the inversion

GDDFull
Description

The growing degree days (GDD) needed for full capacity of the leaf area index (LAI) [°C].

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MU

This should be checked carefully for your study area using modelled LAI from the DailyState output file compared to known behaviour in the study area. See section 2.2 Järvi et al. (2011) [J11] ; Appendix A Järvi et al. (2014) [Leena2014] for more details. Example values: 300 for EveTr Järvi et al. (2011) [J11]

Grid
Description

a unique number to represent grid

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

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

GridConnection1of8
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

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

GridConnection2of8
Description

Number of the 2nd grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

GridConnection3of8
Description

Number of the 3rd grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

GridConnection4of8
Description

Number of the 4th grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

GridConnection5of8
Description

Number of the 5th grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

GridConnection6of8
Description

Number of the 6th grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

GridConnection7of8
Description

Number of the 7th grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

GridConnection8of8
Description

Number of the 8th grid where water can flow to

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Number of the grid where water can flow to

gsModel
Description

Formulation choice for conductance calculation.

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

  • 1 Järvi et al. (2011) [J11]

  • 2 (Recommended) Ward et al. (2016) [W16]

H_Bldgs
Description

Mean building height [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Mean building height [m]

H_DecTr
Description

Mean height of deciduous trees [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Mean height of deciduous trees [m]

H_EveTr
Description

Mean height of evergreen trees [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Mean height of evergreen trees [m]

H_maintain
Description

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

Note

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

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

water depth to maintain used in automatic irrigation.

id
Description

Day of year [DOY]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Not used: set to 1 in this version.

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

Day of year [DOY]

SSss_YYYY_data_tt.txt

MU

Day of year [DOY]

CBL_initial_data.txt

MU

Day of year [DOY]

Ie_a1
Description

Coefficient for automatic irrigation model [mm d-1 ]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MD

Coefficient for automatic irrigation model [mm d -1 ]

Ie_a2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MD

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

Ie_a3
Description

Coefficient for automatic irrigation model [mm d-2 ]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MD

Coefficient for automatic irrigation model [mm d -2 ]

Ie_end
Description

Day when irrigation ends [DOY]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

Day when irrigation ends [DOY]

Ie_m1
Description

Coefficient for manual irrigation model [mm d-1 ]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MD

Coefficient for manual irrigation model [mm d -1 ]

Ie_m2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MD

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

Ie_m3
Description

Coefficient for manual irrigation model [mm d-2 ]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MD

Coefficient for manual irrigation model [mm d -2 ]

Ie_start
Description

Day when irrigation starts [DOY]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

Day when irrigation starts [DOY]

ih
Description

Hour [H]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Hour [H] Not used: set to 0 in this version.

imin
Description

Minute [M]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Minute [M] Not used: set to 0 in this version.

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

Minute [M]

SSss_YYYY_data_tt.txt

MU

Minute [M]

InfiltrationRate
Description

Infiltration rate.

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

O

Not currently used

Internal_albedo
Description

Albedo of all internal elements for building surfaces only

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

Albedo of all internal elements for building surfaces only

Internal_CHbld
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

Bulk transfer coefficient of internal building elements [W m-2 K-1] (for building surfaces only and if IbldCHmod == 0 in ESTMinput.nml

Internal_CHroof
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

Bulk transfer coefficient of internal roof [W m-2 K-1] (for building surfaces only and if IbldCHmod == 0 in ESTMinput.nml

Internal_CHwall
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

Bulk transfer coefficient of internal wall [W m-2 K-1] (for building surfaces only and if IbldCHmod == 0 in ESTMinput.nml

Internal_emissivity
Description

Emissivity of all internal elements for building surfaces only

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

Emissivity of all internal elements for building surfaces only

Internal_k1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Internal_k2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_k3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_k4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_k5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_rhoCp1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Internal_rhoCp2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_rhoCp3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_rhoCp4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_rhoCp5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_thick1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Internal_thick2
Description

Thickness of the second layer [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_thick3
Description

Thickness of the third layer [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_thick4
Description

Thickness of the fourth layer [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Internal_thick5
Description

Thickness of the fifth layer [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

InternalWaterUse
Description

Internal water use [mm h-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Irrigation.txt

MU

Internal water use [mm h-1]

IrrFr_Paved
Description

Fraction of Paved that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of paved surfaces that are irrigated [-]

IrrFr_Bldgs
Description

Fraction of Bldgs that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of rooftop of buildings (e.g., green roofs) that are irrigated [-]

IrrFr_DecTr
Description

Fraction of DecTr that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of deciduous trees that are irrigated [-]

IrrFr_EveTr
Description

Fraction of EveTr that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of evergreen trees that are irrigated [-] e.g. 50% of the evergreen trees/shrubs are irrigated

IrrFr_Grass
Description

Fraction of Grass that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of grass that is irrigated [-]

IrrFr_BSoil
Description

Fraction of BSoil that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of bare soil that are irrigated [-]

IrrFr_Water
Description

Fraction of Water that is irrigated [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Fraction of water that are irrigated [-]

IrrigationCode
Description

Code for modelling irrigation linking to Code of SUEWS_Irrigation.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

it
Description

Hour [H]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

Hour [H]

SSss_YYYY_data_tt.txt

MU

Hour [H]

iy
Description

Year [YYYY]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

Year [YYYY]

SSss_YYYY_data_tt.txt

MU

Year [YYYY]

kdiff
Description

Diffuse radiation [W m-2].

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Recommended if SOLWEIGUse = 1

kdir
Description

Direct radiation [W m-2].

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Recommended if SOLWEIGUse = 1

kdown
Description

Incoming shortwave radiation [W m-2].

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

MU

Must be > 0 W m-2 .

Kmax
Description

Maximum incoming shortwave radiation [W m-2]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Maximum incoming shortwave radiation [W m-2]

lai
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

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

LAIEq
Description

LAI calculation choice.

Note

North and South hemispheres are treated slightly differently.

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

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

Options

LAIMax
Description

full leaf-on summertime value

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

full leaf-on summertime value Example values: - 5.1 EveTr Breuer et al. (2003) [Br03] - 5.5 DecTr Breuer et al. (2003) [Br03] - 5.9 Grass Breuer et al. (2003) [Br03]

LAIMin
Description

leaf-off wintertime value

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

leaf-off wintertime value Example values: - 4. EveTr Järvi et al. (2011) [J11] - 1. DecTr Järvi et al. (2011) [J11] - 1.6 Grass Grimmond and Oke (1991) [G91]

lat
Description

Latitude [deg].

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

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

ldown
Description

Incoming longwave radiation [W m-2]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Incoming longwave radiation [W m-2]

LeafGrowthPower1
Description

a parameter required by LAI calculation in LAIEq

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

Example values

LeafGrowthPower2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

Example values

LeafOffPower1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

Example values

LeafOffPower2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

Example values

lng
Description

longitude [deg]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

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

LUMPS_Cover
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Limit when surface totally covered with water [mm] Used for LUMPS surface wetness control. Default recommended value of 1 mm from Loridan et al. (2011) [L2011] .

LUMPS_DrRate
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Drainage rate of bucket for LUMPS [mm h-1] Used for LUMPS surface wetness control. Default recommended value of 0.25 mm h-1 from Loridan et al. (2011) [L2011] .

LUMPS_MaxRes
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control. Default recommended value of 10 mm from Loridan et al. (2011) [L2011] .

MaxQFMetab
Description

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

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

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

MaxFCMetab
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

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

MaxConductance
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

Example values [mm s-1]

  • 7.4: EveTr Järvi et al. (2011) [J11]

  • 11.7: DecTr Järvi et al. (2011) [J11]

  • 33.1: Grass (unirrigated) Järvi et al. (2011) [J11]

  • 40.: Grass (irrigated) Järvi et al. (2011) [J11]

MinQFMetab
Description

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

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

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

MinFCMetab
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

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

NARP_Trans
Description

Atmospheric transmissivity for NARP [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD

Atmospheric transmissivity for NARP [-] Value must in the range 0-1. Default recommended value of 1.

nroom
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

Number of rooms per floor for building surfaces only

OBS_SMCap
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

O

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

OBS_SMDepth
Description

The depth of soil moisture measurements. [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

O

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

OBS_SoilNotRocks
Description

Fraction of soil without rocks. [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

O

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

OHMCode_SummerDry
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Veg.txt

L

Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Water.txt

L

Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Snow.txt

L

Code for OHM coefficients to use for this surface during dry conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMCode_SummerWet
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Veg.txt

L

Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Water.txt

L

Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Snow.txt

L

Code for OHM coefficients to use for this surface during wet conditions in summer. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMCode_WinterDry
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Veg.txt

L

Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Water.txt

L

Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Snow.txt

L

Code for OHM coefficients to use for this surface during dry conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMCode_WinterWet
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Veg.txt

L

Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Water.txt

L

Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

SUEWS_Snow.txt

L

Code for OHM coefficients to use for this surface during wet conditions in winter. Links to SUEWS_OHMCoefficients.txt . Value of integer is arbitrary but must match code specified in column 1 of SUEWS_OHMCoefficients.txt.

OHMThresh_SW
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.

SUEWS_Veg.txt

MD

Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.

SUEWS_Water.txt

MD

Temperature threshold determining whether summer/winter OHM coefficients are applied [°C] If 5-day running mean air temperature is greater than or equal to this threshold, OHM coefficients for summertime are applied; otherwise coefficients for wintertime are applied.

SUEWS_Snow.txt

MD

Not actually used for Snow surface as winter wet conditions always assumed.

OHMThresh_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

Not actually used for building and paved surfaces (as impervious).

SUEWS_Veg.txt

MD

Note that OHM coefficients for wet conditions are applied if the surface is wet.

SUEWS_Water.txt

MD

Not actually used for water surface (as no soil surface beneath).

SUEWS_Snow.txt

MD

Not actually used for Snow surface as winter wet conditions always assumed.

PipeCapacity
Description

Storage capacity of pipes [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Storage capacity of pipes [mm] Runoff amounting to less than the value specified here is assumed to be removed by pipes.

PopDensDay
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

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

PopDensNight
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

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

PopProfWD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

PopProfWE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

PorosityMax
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

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

PorosityMin
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MD

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

PrecipLimAlb
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

Limit for hourly precipitation when the ground is fully covered with snow. Then snow albedo is reset to AlbedoMax [mm]

PrecipLimSnow
Description

Temperature limit when precipitation falls as snow [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

Auer (1974) [Au74]

pres
Description

Barometric pressure [kPa]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

MU

Barometric pressure [kPa]

qe
Description

Latent heat flux [W m-2]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Latent heat flux [W m-2]

qf
Description

Anthropogenic heat flux [W m-2]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Anthropogenic heat flux [W m-2]

QF_A_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 2

Example values:

QF_A_WE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 2

Example values:

QF_B_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 2

Example values:

QF_B_WE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 2

Example values:

QF_C_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 2

Example values:

QF_C_WE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Example values:

q+_gkg
Description

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

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

specific humidity at the top of CBL (g kg-1 )

q_gkg
Description

specific humidiy in CBL [g kg-1]

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

specific humidiy in CBL (g kg-1 )

qh
Description

Sensible heat flux [W m-2]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Sensible heat flux [W m-2]

qn
Description

Net all-wave radiation [W m-2]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Required if NetRadiationMethod = 1.

qs
Description

Storage heat flux [W m-2]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Storage heat flux [W m-2]

RadMeltFactor
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MU

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

rain
Description

Rainfall [mm]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

MU

Rainfall [mm]

RH
Description

Relative Humidity [%]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

MU

Relative Humidity [%]

RunoffToWater
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MD MU

Fraction of above-ground runoff flowing to water surface during flooding [-] Value must be in the range 0-1. Fraction of above-ground runoff that can flow to the water surface in the case of flooding.

S1
Description

A parameter related to soil moisture dependence [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to soil moisture dependence [-] These will change in the future to ensure consistency with soil behaviour

S2
Description

A parameter related to soil moisture dependence [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Related to soil moisture dependence [mm] These will change in the future to ensure consistency with soil behaviour

SatHydraulicCond
Description

Hydraulic conductivity for saturated soil [mm s-1]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

MD

Hydraulic conductivity for saturated soil [mm s-1]

SDDFull
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Veg.txt

MU

This should be checked carefully for your study area using modelled LAI from the DailyState output file compared to known behaviour in the study area. See section 2.2 Järvi et al. (2011) [J11] ; Appendix A Järvi et al. (2014) [Leena2014] for more details.

Example values:

snow
Description

Snowfall [mm]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Required if SnowUse = 1

SnowClearingProfWD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for snow clearing profile (weekdays) Provides the link to column 1 of SUEWS_Profiles.txt. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Profiles.txt. e.g. 1 means use the characteristics specified in the row of input file SUEWS_Profiles.txt which has 1 in column 1 (Code).

SnowClearingProfWE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

SnowCode
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

Code for snow surface characteristics Provides the link to column 1 of SUEWS_Snow.txt, which contains the attributes describing snow surfaces in this grid for this year. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Snow.txt.

SnowDensMax
Description

Maximum snow density [kg m-3]

Configuration

SnowDensMin
Description

Fresh snow density [kg m-3]

Configuration

SnowLimPatch
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

O

Limit of snow water equivalent when the surface is fully covered with snow. Not needed if SnowUse = 0 in RunControl.nml .

Example values:

SUEWS_Veg.txt

O

Limit of snow water equivalent when the surface is fully covered with snow. Not needed if SnowUse = 0 in RunControl.nml .

Example values:

SnowLimRemove
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

O

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

Example values [mm]

SoilDensity
Description

Soil density [kg m-3]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

MD

Soil density [kg m-3]

SoilDepth
Description

Depth of soil beneath the surface [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

MD

Depth of sub-surface soil store [mm] i.e. the depth of soil beneath the surface

SoilStoreCap
Description

Limit value for SoilDepth [mm]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Soil.txt

MD

SoilStoreCap must not be greater than SoilDepth.

SoilTypeCode
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

L

Code for soil characteristics below this surface Provides the link to column 1 of SUEWS_Soil.txt, which contains the attributes describing sub-surface soil for this surface type. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Soil.txt.

SUEWS_Veg.txt

L

Code for soil characteristics below this surface Provides the link to column 1 of SUEWS_Soil.txt, which contains the attributes describing sub-surface soil for this surface type. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Soil.txt.

StartDLS
Description

Start of the day light savings [DOY]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Start of the day light savings [DOY] See Day Light Savings (DLS).

StateLimit
Description

Upper limit to the surface state. [mm]

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

Currently only used for the water surface

SUEWS_Veg.txt

MD

Currently only used for the water surface

SUEWS_Water.txt

MU

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

StorageMax
Description

Maximum water storage capacity for upper surfaces (i.e. canopy)

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

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

Example values:

SUEWS_Veg.txt

MD

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

Example values:

SUEWS_Water.txt

MD

Maximum water storage capacity for upper surfaces (i.e. canopy) Min and max values are to account for seasonal variation - not used for water surfaces so set same as StorageMin.

StorageMin
Description

Minimum water storage capacity for upper surfaces (i.e. canopy).

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

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

Example values:

SUEWS_Veg.txt

MD

Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation (e.g. leaf-off/leaf-on differences for vegetated surfaces).

Example values:

SUEWS_Water.txt

MD

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

Example values:

-0.5 Water

SurfaceArea
Description

Area of the grid [ha].

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

Area of the grid [ha].

Surf_k1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Surf_k2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_k3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_k4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_k5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_rhoCp1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Surf_rhoCp2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_rhoCp3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_rhoCp4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_rhoCp5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_thick1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Surf_thick2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_thick3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_thick4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Surf_thick5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Tair
Description

Air temperature [°C]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

MU

Air temperature [°C]

tau_a
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

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

tau_f
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

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

tau_r
Description

Time constant for snow density ageing [-]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MD

Time constant for snow density ageing [-]

TCritic_Heating_WD
Description

Critical heating temperature on weekdays [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

TCritic_Heating_WE
Description

Critical heating temperature on weekends [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

TCritic_Cooling_WD
Description

Critical cooling temperature on weekdays [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

TCritic_Cooling_WE
Description

Critical cooling temperature on weekends [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

MU O

Use with EmissionsMethod = 1

TempMeltFactor
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_Snow.txt

MU

Hourly temperature melt factor of snow [mm K-1 h-1] (In previous model version, this parameter was 0.12)

TH
Description

Upper air temperature limit [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Upper air temperature limit [°C]

Theta+_K
Description

potential temperature at the top of CBL [K]

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

potential temperature at the top of CBL (K)

Theta_K
Description

potential temperature in CBL [K]

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

potential temperature in CBL (K)

Tiair
Description

Indoor air temperature [˚C]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

Indoor air temperature [˚C]

Timezone
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

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

TL
Description

Lower air temperature limit [°C]

Configuration

Referencing Table

Requirement

Comment

SUEWS_Conductance.txt

MD

Lower air temperature limit [°C]

ToBldgs
Description

Fraction of water going to Bldgs

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to Bldgs

ToBSoil
Description

Fraction of water going to BSoil

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to BSoil

ToDecTr
Description

Fraction of water going to DecTr

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to DecTr

ToEveTr
Description

Fraction of water going to EveTr

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to EveTr

ToGrass
Description

Fraction of water going to Grass

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to Grass

ToPaved
Description

Fraction of water going to Paved

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to Paved

ToRunoff
Description

Fraction of water going to Runoff

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to Runoff

ToSoilStore
Description

Fraction of water going to SoilStore

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to SoilStore

ToWater
Description

Fraction of water going to Water

Configuration

Referencing Table

Requirement

Comment

SUEWS_WithinGridWaterDist.txt

MU

Fraction of water going to Water

TraffProfWD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

TraffProfWE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

TrafficUnits
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_AnthropogenicEmission.txt

O

Weekday building energy use [W m-2] Can be used for CO2 flux calculation.

TrafficRate_WD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

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

TrafficRate_WE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

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

Troad
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Troof
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Tsurf
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Twall
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Twall_e
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Twall_n
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Twall_s
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

Twall_w
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_ESTM_Ts_data_tt.txt

MU

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

U
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

MU

Height of the wind speed measurement (z) is needed in SUEWS_SiteSelect.txt.

Wall_k1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Wall_k2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_k3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_k4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_k5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_rhoCp1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Wall_rhoCp2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_rhoCp3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_rhoCp4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_rhoCp5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_thick1
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

MU

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

Wall_thick2
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_thick3
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_thick4
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

Wall_thick5
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_ESTMCoefficients.txt

O

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

WaterDepth
Description

Water depth [mm].

Configuration

Referencing Table

Requirement

Comment

SUEWS_Water.txt

MU

Set to a large value (e.g. 20000 mm = 20 m) if the water body is substantial (lake, river, etc) or a small value (e.g. 10 mm) if water bodies are very shallow (e.g. fountains). This value must not exceed StateLimit (column 8).

WaterUseProfAutoWD
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WaterUseProfAutoWE
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WaterUseProfManuWD
Description

Code for water use profile (manual irrigation, weekdays) linking to Code of SUEWS_Profiles.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WaterUseProfManuWE
Description

Code for water use profile (manual irrigation, weekends) linking to Code of SUEWS_Profiles.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

wdir
Description

Wind direction [deg].

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

Not available in this version.

WetThreshold
Description

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

Configuration

Referencing Table

Requirement

Comment

SUEWS_NonVeg.txt

MD

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

Example values:

  • 0.6 Paved

  • 0.6 Bldgs

    1. BSoil

SUEWS_Veg.txt

MD

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

Example values:

  • 1.8 EveTr

    1. DecTr

    1. Grass

SUEWS_Water.txt

MD

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

Example values:

  • 0.5 Water

WithinGridBldgsCode
Description

Code that links to the fraction of water that flows from Bldgs surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WithinGridBSoilCode
Description

Code that links to the fraction of water that flows from BSoil surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WithinGridDecTrCode
Description

Code that links to the fraction of water that flows from DecTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WithinGridEveTrCode
Description

Code that links to the fraction of water that flows from EveTr surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WithinGridGrassCode
Description

Code that links to the fraction of water that flows from Grass surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WithinGridPavedCode
Description

Code that links to the fraction of water that flows from Paved surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

WithinGridWaterCode
Description

Code that links to the fraction of water that flows from Water surfaces to surfaces in columns 2-10 of SUEWS_WithinGridWaterDist.txt.

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

L

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

Wuh
Description

External water use [m3]

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

External water use [ m3]

xsmd
Description

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

Configuration

Referencing Table

Requirement

Comment

SSss_YYYY_data_tt.txt

O

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

Year
Description

Year [YYYY]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

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

z
Description

Measurement height [m].

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

MU

z must be greater than the displacement height. Forcing data should be representative of the local-scale, i.e. above the height of the roughness elements.

z0
Description

Roughness length for momentum [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

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

zd
Description

Zero-plane displacement [m]

Configuration

Referencing Table

Requirement

Comment

SUEWS_SiteSelect.txt

O

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

zi0
Description

initial convective boundary layer height (m)

Configuration

Referencing Table

Requirement

Comment

CBL_initial_data.txt

MU

initial convective boundary layer height [m]