Tip
Need help? Please let us know in the UMEP Community.
Please report issues with the manual on the GitHub Issues.
Please cite SUEWS with proper information from our Zenodo page.
3.2.14. Input Options#
- a1#
- Description
Coefficient for Q* term [-]
- Configuration
Referencing Table
Requirement
Comment
Coefficient for Q* term [-]
- a2#
- Description
Coefficient for
dQ*/dt
term [h]- Configuration
Referencing Table
Requirement
Comment
Coefficient for dQ*/dt term [h]
- a3#
- Description
Constant term [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Constant term [W m-2]
- ActivityProfWD#
- Description
Code linking to
ActivityProfWD
in SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
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.
- ActivityProfWE#
- Description
Code linking to
ActivityProfWE
in SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
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.
- AHMin_WD#
- Description
Minimum QF on weekdays [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- AHMin_WE#
- Description
Minimum QF on weekends [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- AHSlope_Heating_WD#
- Description
Heating slope of QF on weekdays [W m-2 K-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- AHSlope_Heating_WE#
- Description
Heating slope of QF on weekends [W m-2 K-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- AHSlope_Cooling_WD#
- Description
Cooling slope of QF on weekdays [W m-2 K-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- AHSlope_Cooling_WE#
- Description
Cooling slope of QF on weekends [W m-2 K-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- AlbedoMax#
- Description
Effective surface albedo (middle of the day value) for summertime.
- Configuration
Referencing Table
Requirement
Comment
Effective surface albedo (middle of the day value) for summertime. View factors should be taken into account.
Example values [-]
Example values [-]
0.1 Water [Oke, 2002]
Example values [-]
0.85 [Järvi et al., 2014]
- AlbedoMin#
- Description
Effective surface albedo (middle of the day value) for wintertime (not including snow).
- Configuration
Referencing Table
Requirement
Comment
Not currently used for non-vegetated surfaces – set the same as AlbedoMax.
Example values [-]
Not currently used for water surface - set same as AlbedoMax.
Example values [-]
0.18 [Järvi et al., 2014]
- 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
Example values:
EmissionsMethod
= 11, 12, 13, 14, 15 or 16:0.044 [Ruimy et al., 1995]
0.0593 [Schmid, 2000]
0.0205 [Flanagan et al., 2002]
EmissionsMethod
= 21, 22, 23, 24, 25, or 26: 0.031 [Bellucco et al., 2017]EmissionsMethod
= 31, 32, 33, 34, 35, 36: 0.005 [Bellucco et al., 2017]
- Alt#
- Description
Altitude of grids [m].
- Configuration
Referencing Table
Requirement
Comment
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
Bulk transfer coefficient for this surface to use in AnOHM [-]
Bulk transfer coefficient for this surface to use in AnOHM [-]
Bulk transfer coefficient for this surface to use in AnOHM [-]
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
Volumetric heat capacity for this surface to use in AnOHM [J m-3]
Volumetric heat capacity for this surface to use in AnOHM [J m-3]
Volumetric heat capacity for this surface to use in AnOHM [J m-3]
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
Thermal conductivity for this surface to use in AnOHM [W m K-1]
Thermal conductivity for this surface to use in AnOHM [W m K-1]
Thermal conductivity for this surface to use in AnOHM [W m K-1]
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 ifEmissionsMethod
= 1, 2 in RunControl.nml).- Configuration
Referencing Table
Requirement
Comment
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) [ m2 ].
- Configuration
Referencing Table
Requirement
Comment
Area of wall within grid (needed for ESTM calculation). [ m2 ]
- BaseT#
- Description
Base Temperature for initiating growing degree days (GDD) for leaf growth. [°C]
- Configuration
Referencing Table
Requirement
Comment
See section 2.2 Järvi et al. (2011); Appendix A of Järvi et al. [2014]. Example values: 5 for EveTr [Järvi et al., 2011]
- BaseTe#
- BaseT_HC#
- Description
Base temperature for heating degree days [°C]
- Configuration
Referencing Table
Requirement
Comment
Base temperature for heating degree days [°C] e.g. Sailor and Vasireddy [2006]
- beta#
- Description
The light-saturated gross photosynthesis of the canopy. [umol m-2 s-1 ]
- Configuration
Referencing Table
Requirement
Comment
Example values:
EmissionsMethod
= 11, 12, 13, 14, 15, 16:43.35 [Ruimy et al., 1995]
35 [Schmid, 2000]
16.3 [Flanagan et al., 2002]
EmissionsMethod
= 21, 22, 23, 24, 25, 26: 17.793 [Bellucco et al., 2017]EmissionsMethod
= 31, 32, 33, 34, 35, 36: 8.474 [Bellucco et al., 2017]
- theta#
- Description
The convexity of the curve at light saturation.
- Configuration
Referencing Table
Requirement
Comment
Example value:
EmissionsMethod
= 21, 22, 23, 24, 25, 26: 0.723 [Bellucco et al., 2017]EmissionsMethod
= 31, 32, 33, 34, 35, 36: 0.96 [Bellucco et al., 2017]
- alpha_enh#
- Description
Part of the
alpha
coefficient related to the fraction of vegetation.- Configuration
Referencing Table
Requirement
Comment
Example value: 0.016 [Bellucco et al., 2017]
- beta_enh#
- Description
Part of the
beta
coefficient related to the fraction of vegetation.- Configuration
Referencing Table
Requirement
Comment
Example values: 33.454 [Bellucco et al., 2017]
- resp_a#
- Description
Respiration coefficient a.
- Configuration
Referencing Table
Requirement
Comment
Example values:
1.08 [Schmid, 2000]
3.229 [Järvi et al., 2012]
- resp_b#
- Description
Respiration coefficient b - related to air temperature dependency.
- Configuration
Referencing Table
Requirement
Comment
Example values:
0.0064 [Schmid, 2000]
0.0329 [Järvi et al., 2012]
- min_respi#
- Description
Minimum soil respiration rate (for cold-temperature limit) [umol m-2 s-1].
- Configuration
Referencing Table
Requirement
Comment
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
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
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
Can be used for CO2 flux calculation.
- CO2PointSource#
- Description
CO2 emission factor [kg km-1]
- Configuration
Referencing Table
Requirement
Comment
CO2 emission factor [kg km-1]
- Code#
- Description
Code linking to a corresponding look-up table.
- Configuration
Referencing Table
Requirement
Comment
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.
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.
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.
Code linking to SUEWS_SiteSelect.txt for snow surfaces (SnowCode). Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
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.
Code linking to the CondCode column in SUEWS_SiteSelect.txt . Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
Code linking to the AnthropogenicCode column in SUEWS_SiteSelect.txt . Value of integer is arbitrary but must match code specified in SUEWS_SiteSelect.txt.
Code linking to SUEWS_SiteSelect.txt for irrigation modelling (IrrigationCode). Value of integer is arbitrary but must match codes specified in SUEWS_SiteSelect.txt.
Code linking to the
OHMCode_SummerWet
,OHMCode_SummerDry
,OHMCode_WinterWet
andOHMCode_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.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.
Code linking to the
BiogenCO2Code
column in SUEWS_Veg.txt.
- Code_Bldgs#
- Description
Code for
Bldgs
surface characteristics linking toCode
of SUEWS_NonVeg.txt- Configuration
Referencing Table
Requirement
Comment
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 toCode
of SUEWS_NonVeg.txt- Configuration
Referencing Table
Requirement
Comment
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 toCode
of SUEWS_Veg.txt- Configuration
Referencing Table
Requirement
Comment
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
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Bldgs2#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Bldgs3#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Bldgs4#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Bldgs5#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Paved1#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Paved2#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_ESTMClass_Paved3#
- Description
Code linking to SUEWS_ESTMCoefficients.txt
- Configuration
Referencing Table
Requirement
Comment
Code linking to SUEWS_ESTMCoefficients.txt
- Code_EveTr#
- Description
Code for
EveTr
surface characteristics linking toCode
of SUEWS_Veg.txt- Configuration
Referencing Table
Requirement
Comment
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 toCode
of SUEWS_Veg.txt- Configuration
Referencing Table
Requirement
Comment
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 toCode
of SUEWS_NonVeg.txt- Configuration
Referencing Table
Requirement
Comment
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 toCode
of SUEWS_Water.txt- Configuration
Referencing Table
Requirement
Comment
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
Code for surface conductance parameters Provides the link to column 1 of SUEWS_Conductance.txt, which contains the parameters for the Jarvis [1976] parameterisation of surface conductance. Value of integer is arbitrary but must match code specified in column 1 of SUEWS_Conductance.txt. e.g. 33 means use the characteristics specified in the row of input file SUEWS_Conductance.txt which has 33 in column 1 (Code).
- CRWMax#
- Description
Maximum water holding capacity of snow [mm]
- Configuration
Referencing Table
Requirement
Comment
Maximum water holding capacity of snow [mm]
- CRWMin#
- Description
Minimum water holding capacity of snow [mm]
- Configuration
Referencing Table
Requirement
Comment
Minimum water holding capacity of snow [mm]
- DayWat(1)#
- Description
Irrigation allowed on Sundays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
Irrigation allowed on Sundays [1], if not [0]
- DayWat(2)#
- Description
Irrigation allowed on Mondays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
Irrigation allowed on Mondays [1], if not [0]
- DayWat(3)#
- Description
Irrigation allowed on Tuesdays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
Irrigation allowed on Tuesdays [1], if not [0]
- DayWat(4)#
- Description
Irrigation allowed on Wednesdays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
Irrigation allowed on Wednesdays [1], if not [0]
- DayWat(5)#
- Description
Irrigation allowed on Thursdays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
Irrigation allowed on Thursdays [1], if not [0]
- DayWat(6)#
- Description
Irrigation allowed on Fridays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
Irrigation allowed on Fridays [1], if not [0]
- DayWat(7)#
- Description
Irrigation allowed on Saturdays [1], if not [0]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
Fraction of properties using irrigation on Saturdays [0-1]
- DrainageCoef1#
- Description
Coefficient D0 [mm h-1] used in
DrainageEq
- Configuration
Referencing Table
Requirement
Comment
Example values:
DrainageEq
= 3, 10 forPaved
andBldgs
;DrainageEq
= 2, 0.013 forBSoil
Example values:
DrainageEq
= 3, 10 forGrass
(irrigated);DrainageEq
= 2, 0.013 forEveTr
,DecTr
,Grass
(unirrigated)
Not currently used for water surface
- DrainageCoef2#
- Description
Coefficient b [-] used in
DrainageEq
- Configuration
Referencing Table
Requirement
Comment
Example values:
DrainageEq
= 3, 3 forPaved
andBldgs
DrainageEq
= 2, 1.71 forBSoil
Example values:
DrainageEq
= 3, 3 forGrass
(irrigated)DrainageEq
= 2, 1.71 forEveTr
,DecTr
,Grass
(unirrigated)
Not currently used for water surface
- DrainageEq#
- Description
Calculation choice for Drainage equation
- Configuration
Referencing Table
Requirement
Comment
Options:
1: Falk and Niemczynowicz [1978]
2: Halldin et al. [1979] (Rutter eqn corrected for c=0, see Calder & Wright (1986) [Calder and Wright, 1986] )
3: for
EveTr
,DecTr
,Grass
(unirrigated) see Falk and Niemczynowicz [1978]. Coefficients are specified in the following two columns. Recommended in this version.
Not currently used for water surface.
- EF_umolCO2perJ#
- Description
Emission factor for fuels used for building heating. [umol CO2 |J^-1|]
- Configuration
Referencing Table
Requirement
Comment
Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
- Emissivity#
- Description
Effective surface emissivity.
- Configuration
Referencing Table
Requirement
Comment
Effective surface emissivity. View factors should be taken into account.
Example values [-]
Example values [-]
0.95 Water [Oke, 2002]
Example values [-]
0.99 [Järvi et al., 2014]
- EndDLS#
- Description
End of the day light savings [DOY]
- Configuration
Referencing Table
Requirement
Comment
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
Emission factor for heat [J k m-1]. Example values: 3.97e6 Sailor and Lu (2004) [Sailor and Lu, 2004]
- EnergyUseProfWD#
- Description
Code linking to
EnergyUseProfWD
in SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
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
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
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.
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.
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.
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
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
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
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
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
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
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
Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
- fcld#
- Description
Cloud fraction [tenths]
- Configuration
Referencing Table
Requirement
Comment
Cloud fraction [tenths]
- FlowChange#
- Description
Difference in input and output flows for water surface [mm h-1]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
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
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
Surface cover fraction of buildings [-]
- Fr_Bsoil#
- Description
Surface cover fraction of bare soil or unmanaged land [-]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
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
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
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
Surface cover fraction of evergreen trees and shrubs [-]
- Fr_Grass#
- Description
Surface cover fraction of
Grass
[-]- Configuration
Referencing Table
Requirement
Comment
Surface cover fraction of grass [-]
- Fr_Paved#
- Description
Surface cover fraction of
Paved
surfaces [-]- Configuration
Referencing Table
Requirement
Comment
Columns 14 to 20 must sum to 1 .
- Fr_Water#
- Description
Surface cover fraction of open water [-]
- Configuration
Referencing Table
Requirement
Comment
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
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
Weekday building energy use [W m-2] Can be used for CO2 flux calculation.
- FrPDDwe#
- Description
Fraction of weekend population to weekday population. [-]
- Configuration
Referencing Table
Requirement
Comment
Fraction of weekend population to weekday population. [-]
- G1#
- Description
Related to maximum surface conductance [mm s-1]
- Configuration
Referencing Table
Requirement
Comment
Related to maximum surface conductance [mm s-1]
- G2#
- Description
Related to Kdown dependence [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Related to Kdown dependence [W m-2]
- G3#
- Description
Related to VPD dependence [units depend on
gsModel
]- Configuration
Referencing Table
Requirement
Comment
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
Related to VPD dependence [units depend on gsChoice in RunControl.nml ]
- G5#
- Description
Related to temperature dependence [°C]
- Configuration
Referencing Table
Requirement
Comment
Related to temperature dependence [°C]
- G6#
- Description
Related to soil moisture dependence [mm-1]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
This should be checked carefully for your study area using modelled LAI from the DailyState output file compared to known behaviour in the study area. See section 2.2 Järvi et al. [2011] ; Appendix A Järvi et al. [2014] for more details. Example values: 300 for
EveTr
Järvi et al. [2011]
- Grid#
- Description
a unique number to represent grid
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
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
Number of the grid where water can flow to
- gsModel#
- Description
Formulation choice for conductance calculation.
- Configuration
Referencing Table
Requirement
Comment
2
[Ward et al., 2016] Recommended in this version.
3
as in [Järvi et al., 2011]
but using 2 meter air temperature
4
as in [Ward et al., 2016] Recommended in this version.”
but using 2 meter air temperature
- H_Bldgs#
- Description
Mean building height [m]
- Configuration
Referencing Table
Requirement
Comment
Mean building height [m]
- H_DecTr#
- Description
Mean height of deciduous trees [m]
- Configuration
Referencing Table
Requirement
Comment
Mean height of deciduous trees [m]
- H_EveTr#
- Description
Mean height of evergreen trees [m]
- Configuration
Referencing Table
Requirement
Comment
Mean height of evergreen trees [m]
- H_maintain#
- Description
water depth to maintain used in automatic irrigation (e.g., ponding water due to flooding irrigation in rice crop-field) [mm].
Note
H_maintain
can be positive (e.g., ponding water due to flooding irrigation in rice crop-field) or negative (e.g., soil water store level to maintain:SoilStoreCap
+H_maintain
) or zero (e.g., to maintain a maximum soil store level, i.e.,SoilStoreCap
).Disable this feature by setting this parameter to
-999
: then no restrictions will be applied to maintain available water level.
- Configuration
Referencing Table
Requirement
Comment
water depth to maintain used in automatic irrigation.
- id#
- Description
Day of year [DOY]
- Configuration
Referencing Table
Requirement
Comment
Not used: set to 1 in this version.
Day of year [DOY]
Day of year [DOY]
Day of year [DOY]
- Ie_a1#
- Description
Coefficient for automatic irrigation model [mm d-1 ]
- Configuration
Referencing Table
Requirement
Comment
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
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
Coefficient for automatic irrigation model [mm d -2 ]
- Ie_end#
- Description
Day when irrigation ends [DOY]
- Configuration
Referencing Table
Requirement
Comment
Day when irrigation ends [DOY]
- Ie_m1#
- Description
Coefficient for manual irrigation model [mm d-1 ]
- Configuration
Referencing Table
Requirement
Comment
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
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
Coefficient for manual irrigation model [mm d -2 ]
- Ie_start#
- Description
Day when irrigation starts [DOY]
- Configuration
Referencing Table
Requirement
Comment
Day when irrigation starts [DOY]
- ih#
- Description
Hour [H]
- Configuration
Referencing Table
Requirement
Comment
Hour [H] Not used: set to 0 in this version.
- imin#
- Description
Minute [M]
- Configuration
Referencing Table
Requirement
Comment
Minute [M] Not used: set to 0 in this version.
Minute [M]
Minute [M]
- InfiltrationRate#
- Description
Infiltration rate.
- Configuration
Referencing Table
Requirement
Comment
Not currently used
- Internal_albedo#
- Description
Albedo of all internal elements for building surfaces only
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Internal water use [mm h-1]
- IrrFr_Paved#
- Description
Fraction of
Paved
that is irrigated [-]- Configuration
Referencing Table
Requirement
Comment
Fraction of paved surfaces that are irrigated [-]
- IrrFr_Bldgs#
- Description
Fraction of
Bldgs
that is irrigated [-]- Configuration
Referencing Table
Requirement
Comment
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
Fraction of deciduous trees that are irrigated [-]
- IrrFr_EveTr#
- Description
Fraction of
EveTr
that is irrigated [-]- Configuration
Referencing Table
Requirement
Comment
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
Fraction of grass that is irrigated [-]
- IrrFr_BSoil#
- Description
Fraction of
BSoil
that is irrigated [-]- Configuration
Referencing Table
Requirement
Comment
Fraction of bare soil that are irrigated [-]
- IrrFr_Water#
- Description
Fraction of
Water
that is irrigated [-]- Configuration
Referencing Table
Requirement
Comment
Fraction of water that are irrigated [-]
- IrrigationCode#
- Description
Code for modelling irrigation linking to
Code
of SUEWS_Irrigation.txt- Configuration
Referencing Table
Requirement
Comment
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
Hour [H]
Hour [H]
- iy#
- Description
Year [YYYY]
- Configuration
Referencing Table
Requirement
Comment
Year [YYYY]
Year [YYYY]
- kdiff#
- Description
Diffuse radiation [W m-2].
- Configuration
Referencing Table
Requirement
Comment
Recommended if SOLWEIGUse = 1
- kdir#
- Description
Direct radiation [W m-2].
- Configuration
Referencing Table
Requirement
Comment
Recommended if SOLWEIGUse = 1
- kdown#
- Description
Incoming shortwave radiation [W m-2].
- Configuration
Referencing Table
Requirement
Comment
Must be > 0 W m-2 .
- Kmax#
- Description
Maximum incoming shortwave radiation [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Maximum incoming shortwave radiation [W m-2]
- lai#
- Description
Observed leaf area index [m-2 m-2]
- Configuration
Referencing Table
Requirement
Comment
Observed leaf area index [m-2 m-2]
- LAIEq#
- Description
LAI calculation choice.
Note
North and South hemispheres are treated slightly differently.
- Configuration
Referencing Table
Requirement
Comment
Coefficients are specified in the following parameters:
LeafGrowthPower1
,LeafGrowthPower2
,LeafOffPower1
andLeafOffPower2
.Options
- LAIMax#
- Description
full leaf-on summertime value
- Configuration
Referencing Table
Requirement
Comment
full leaf-on summertime value Example values: - 5.1 EveTr Breuer et al. (2003) [Breuer et al., 2003] - 5.5 DecTr Breuer et al. (2003) [Breuer et al., 2003] - 5.9 Grass Breuer et al. (2003) [Breuer et al., 2003]
- LAIMin#
- Description
leaf-off wintertime value
- Configuration
Referencing Table
Requirement
Comment
leaf-off wintertime value Example values: - 4. EveTr [Järvi et al., 2011] - 1. DecTr [Järvi et al., 2011] - 1.6 Grass [Grimmond and Oke, 1991]
- lat#
- Description
Latitude [deg].
- Configuration
Referencing Table
Requirement
Comment
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
Incoming longwave radiation [W m-2]
- LeafGrowthPower1#
- Description
a parameter required by LAI calculation in
LAIEq
- Configuration
Referencing Table
Requirement
Comment
Example values
LAIEq
= 0: 0.03 [Järvi et al., 2011]LAIEq
= 1: 0.04 [Järvi et al., 2014]
- LeafGrowthPower2#
- Description
a parameter required by LAI calculation [K-1] in
LAIEq
- Configuration
Referencing Table
Requirement
Comment
Example values
LAIEq
= 0: 0.0005 [Järvi et al., 2011]LAIEq
= 1: 0.001 [Järvi et al., 2014]
- LeafOffPower1#
- Description
a parameter required by LAI calculation [K-1] in
LAIEq
- Configuration
Referencing Table
Requirement
Comment
Example values
LAIEq
= 0: 0.03 [Järvi et al., 2011]LAIEq
= 1: -1.5 [Järvi et al., 2014]
- LeafOffPower2#
- Description
a parameter required by LAI calculation [K-1] in
LAIEq
- Configuration
Referencing Table
Requirement
Comment
Example values
LAIEq
= 0: 0.0005 [Järvi et al., 2011]LAIEq
= 1: 0.0015 [Järvi et al., 2014]
- lng#
- Description
longitude [deg]
- Configuration
Referencing Table
Requirement
Comment
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
Limit when surface totally covered with water [mm] Used for LUMPS surface wetness control. Default recommended value of 1 mm from Loridan et al. [2011] .
- LUMPS_DrRate#
- Description
Drainage rate of bucket for LUMPS [mm h-1]
- Configuration
Referencing Table
Requirement
Comment
Drainage rate of bucket for LUMPS [mm h-1] Used for LUMPS surface wetness control. Default recommended value of 0.25 mm h-1 from Loridan et al. [2011] .
- LUMPS_MaxRes#
- Description
Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control.
- Configuration
Referencing Table
Requirement
Comment
Maximum water bucket reservoir [mm] Used for LUMPS surface wetness control. Default recommended value of 10 mm from Loridan et al. [2011] .
- MaxQFMetab#
- Description
Maximum value for human heat emission. [W m-2]
Example values: 175 Sailor and Lu (2004) [Sailor and Lu, 2004]
- Configuration
Referencing Table
Requirement
Comment
Maximum value for human heat emission. [W m-2]
- MaxFCMetab#
- Description
Maximum (day) CO2 from human metabolism. [umol s-1 |cap^-1|]
- Configuration
Referencing Table
Requirement
Comment
Maximum (day) CO2 from human metabolism. [W m-2]
- MaxConductance#
- Description
The maximum conductance of each vegetation or surface type. [mm s-1]
- Configuration
Referencing Table
Requirement
Comment
Example values [mm s-1]
7.4: EveTr [Järvi et al., 2011]
11.7: DecTr [Järvi et al., 2011]
33.1: Grass (unirrigated) [Järvi et al., 2011]
40.: Grass (irrigated) [Järvi et al., 2011]
- MinQFMetab#
- Description
Minimum value for human heat emission. [W m-2]
Example values: 75 Sailor and Lu (2004) [Sailor and Lu, 2004]
- Configuration
Referencing Table
Requirement
Comment
Minimum value for human heat emission. [W m-2].
- MinFCMetab#
- Description
Minimum (night) CO2 from human metabolism. [umol s-1 |cap^-1|]
- Configuration
Referencing Table
Requirement
Comment
Minimum (night) CO2 from human metabolism. [W m-2]
- NARP_Trans#
- Description
Atmospheric transmissivity for NARP [-]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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.
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.
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.
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
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.
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.
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.
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
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.
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.
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.
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
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.
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.
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.
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
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.
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.
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.
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
Not actually used for building and paved surfaces (as impervious).
Note that OHM coefficients for wet conditions are applied if the surface is wet.
Not actually used for water surface (as no soil surface beneath).
Not actually used for Snow surface as winter wet conditions always assumed.
- PipeCapacity#
- Description
Storage capacity of pipes [mm]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
Code for population density profile (weekdays).
- PopProfWE#
- Description
Code for population density profile (weekends) linking to
Code
of SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
Code for population density profile (weekends)
- PorosityMax#
- Description
full leaf-on summertime value Used only for
DecTr
(can affect roughness calculation)- Configuration
Referencing Table
Requirement
Comment
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
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
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
Auer [1974]
- pres#
- Description
Barometric pressure [kPa]
- Configuration
Referencing Table
Requirement
Comment
Barometric pressure [kPa]
- qe#
- Description
Latent heat flux [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Latent heat flux [W m-2]
- qf#
- Description
Anthropogenic heat flux [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Anthropogenic heat flux [W m-2]
- QF_A_WD#
- Description
Base value for QF on weekdays [W m-2 (Cap ha-1 )-1 ]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 2Example values:
0.3081 [Järvi et al., 2011]
0.1 [Järvi et al., 2014]
- QF_A_WE#
- Description
Base value for QF on weekends [W m-2 (Cap ha-1 )-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 2Example values:
0.3081 [Järvi et al., 2011]
0.1 [Järvi et al., 2014]
- QF_B_WD#
- Description
Parameter related to cooling degree days on weekdays [W m-2 K-1 (Cap ha-1 )-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 2Example values:
0.0099 [Järvi et al., 2011]
0.0099 [Järvi et al., 2014]
- QF_B_WE#
- Description
Parameter related to cooling degree days on weekends [W m-2 K-1 (Cap ha-1 )-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 2Example values:
0.0099 [Järvi et al., 2011]
0.0099 [Järvi et al., 2014]
- QF_C_WD#
- Description
Parameter related to heating degree days on weekdays [W m-2 K-1 (Cap ha-1 )-1]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 2Example values:
0.0102 [Järvi et al., 2011]
0.0102 [Järvi et al., 2014]
- QF_C_WE#
- Description
Parameter related to heating degree days on weekends [W m-2 K-1 (Cap ha-1 )-1]
- Configuration
Referencing Table
Requirement
Comment
Example values:
0.0102 [Järvi et al., 2011]
0.0102 [Järvi et al., 2014]
- q+_gkg#
- Description
specific humidity at the top of CBL [g kg-1]
- Configuration
Referencing Table
Requirement
Comment
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
specific humidiy in CBL (g kg-1 )
- qh#
- Description
Sensible heat flux [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Sensible heat flux [W m-2]
- qn#
- Description
Net all-wave radiation [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Required if
NetRadiationMethod
= 1.
- qs#
- Description
Storage heat flux [W m-2]
- Configuration
Referencing Table
Requirement
Comment
Storage heat flux [W m-2]
- RadMeltFactor#
- Description
Hourly radiation melt factor of snow [mm W-1 h-1]
- Configuration
Referencing Table
Requirement
Comment
Hourly radiation melt factor of snow [mm W-1 h-1]
- rain#
- Description
Rainfall [mm]
- Configuration
Referencing Table
Requirement
Comment
Rainfall [mm]
- RH#
- Description
Relative Humidity [%]
- Configuration
Referencing Table
Requirement
Comment
Relative Humidity [%]
- RunoffToWater#
- Description
Fraction of above-ground runoff flowing to water surface during flooding [-]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
This should be checked carefully for your study area using modelled LAI from the DailyState output file compared to known behaviour in the study area. See section 2.2 of Järvi et al. [2011] and Appendix A of Järvi et al. [2014] for more details.
Example values:
-450:
EveTr
[Järvi et al., 2011]-450:
DecTr
[Järvi et al., 2011]-450:
Grass
[Järvi et al., 2011]
- snow#
- Description
Snowfall [mm]
- Configuration
Referencing Table
Requirement
Comment
Required if
SnowUse
= 1
- SnowClearingProfWD#
- Description
Code for snow clearing profile (weekdays) linking to
Code
of SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
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
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
andSnowClearingProfWE
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
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
Limit of snow water equivalent when the surface is fully covered with snow. Not needed if
SnowUse
= 0 in RunControl.nml .Example values:
190: Paved [Järvi et al., 2014]
190: Bldgs [Järvi et al., 2014]
190: BSoil [Järvi et al., 2014]
Limit of snow water equivalent when the surface is fully covered with snow. Not needed if
SnowUse
= 0 in RunControl.nml .Example values:
190: EveTr [Järvi et al., 2014]
190: DecTr [Järvi et al., 2014]
190: Grass [Järvi et al., 2014]
- SnowLimRemove#
- Description
Limit of the snow water equivalent for snow removal from roads and roofs [mm]
- Configuration
Referencing Table
Requirement
Comment
Not needed if
SnowUse
= 0 in RunControl.nml . Not available in this version.Example values [mm]
40:
Paved
[Järvi et al., 2014]100:
Bldgs
[Järvi et al., 2014]
- SoilDensity#
- Description
Soil density [kg m-3]
- Configuration
Referencing Table
Requirement
Comment
Soil density [kg m-3]
- SoilDepth#
- Description
Depth of soil beneath the surface [mm]
- Configuration
Referencing Table
Requirement
Comment
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
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
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.
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
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
Currently only used for the water surface
Currently only used for the water surface
Surface state cannot exceed this value. Set to a large value (e.g. 20000 mm = 20 m) if the water body is substantial (lake, river, etc) or a small value (e.g. 10 mm) if water bodies are very shallow (e.g. fountains). WaterDepth (column 9) must not exceed this value.
- StorageMax#
- Description
Maximum water storage capacity for upper surfaces (i.e. canopy)
- Configuration
Referencing Table
Requirement
Comment
Maximum water storage capacity for upper surfaces (i.e. canopy) Min and max values are to account for seasonal variation (e.g. leaf-on/leaf-off differences for vegetated surfaces). Not currently used for non-vegetated surfaces - set the same as
StorageMin
.Example values:
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 - setEveTr
andGrass
values the same asStorageMin
.Example values:
1.3:
EveTr
[Breuer et al., 2003]0.8:
DecTr
[Breuer et al., 2003]1.9:
Grass
[Breuer et al., 2003]
Maximum water storage capacity for upper surfaces (i.e. canopy) Min and max values are to account for seasonal variation - not used for water surfaces so set same as
StorageMin
.
- StorageMin#
- Description
Minimum water storage capacity for upper surfaces (i.e. canopy).
- Configuration
Referencing Table
Requirement
Comment
Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation (e.g. leaf-on/leaf-off differences for vegetated surfaces). Not currently used for non-vegetated surfaces - set the same as
StorageMax
.Example values:
Minimum water storage capacity for upper surfaces (i.e. canopy). Min/max values are to account for seasonal variation (e.g. leaf-off/leaf-on differences for vegetated surfaces).
Example values:
1.3
EveTr
[Breuer et al., 2003]0.3
DecTr
[Breuer et al., 2003]1.9
Grass
[Breuer et al., 2003]
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
Area of the grid [ha].
- Surf_k1#
- Description
Thermal conductivity of the first layer [W m-1 K-1]
- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Thickness of the fifth layer [m] (if no fifth layer, set to -999.)
- Tair#
- Description
Air temperature [°C]
- Configuration
Referencing Table
Requirement
Comment
Air temperature [°C]
- tau_a#
- Description
Time constant for snow albedo aging in cold snow [-]
- Configuration
Referencing Table
Requirement
Comment
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
Time constant for snow albedo aging in melting snow [-]
- tau_r#
- Description
Time constant for snow density ageing [-]
- Configuration
Referencing Table
Requirement
Comment
Time constant for snow density ageing [-]
- TCritic_Heating_WD#
- Description
Critical heating temperature on weekdays [°C]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- TCritic_Heating_WE#
- Description
Critical heating temperature on weekends [°C]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- TCritic_Cooling_WD#
- Description
Critical cooling temperature on weekdays [°C]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- TCritic_Cooling_WE#
- Description
Critical cooling temperature on weekends [°C]
- Configuration
Referencing Table
Requirement
Comment
Use with
EmissionsMethod
= 1
- TempMeltFactor#
- Description
Hourly temperature melt factor of snow [mm K-1 h-1]
- Configuration
Referencing Table
Requirement
Comment
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
Upper air temperature limit [°C]
- Theta+_K#
- Description
potential temperature at the top of CBL [K]
- Configuration
Referencing Table
Requirement
Comment
potential temperature at the top of CBL (K)
- Theta_K#
- Description
potential temperature in CBL [K]
- Configuration
Referencing Table
Requirement
Comment
potential temperature in CBL (K)
- Tiair#
- Description
Indoor air temperature [˚C]
- Configuration
Referencing Table
Requirement
Comment
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
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
Lower air temperature limit [°C]
- ToBldgs#
- Description
Fraction of water going to
Bldgs
- Configuration
Referencing Table
Requirement
Comment
Fraction of water going to
Bldgs
- ToBSoil#
- Description
Fraction of water going to
BSoil
- Configuration
Referencing Table
Requirement
Comment
Fraction of water going to
BSoil
- ToDecTr#
- Description
Fraction of water going to
DecTr
- Configuration
Referencing Table
Requirement
Comment
Fraction of water going to
DecTr
- ToEveTr#
- ToGrass#
- ToPaved#
- ToRunoff#
- ToSoilStore#
- ToWater#
- TraffProfWD#
- Description
Code for traffic activity profile (weekdays) linking to
Code
of SUEWS_Profiles.txt. Not used in v2018a.- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
Bulk surface temperature [˚C] (used when TsurfCoice = 0)
- Twall#
- Description
Wall surface temperature [˚C] (used when
TsurfChoice
= 1)- Configuration
Referencing Table
Requirement
Comment
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Thickness of the fifth layer [m] (if no fifth layer, set to -999.)
- WaterDepth#
- Description
Water depth [mm].
- Configuration
Referencing Table
Requirement
Comment
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 inCode
of SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
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 inCode
of SUEWS_Profiles.txt.- Configuration
Referencing Table
Requirement
Comment
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
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
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
Not available in this version.
- WetThreshold#
- Description
Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface [mm].
- Configuration
Referencing Table
Requirement
Comment
Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface.
Example values:
0.6 Paved
0.6 Bldgs
BSoil
Depth of water which determines whether evaporation occurs from a partially wet or completely wet surface.
Example values:
1.8 EveTr
DecTr
Grass
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
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
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
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
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
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
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
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
External water use [ m3]
- xsmd#
- Description
Observed soil moisture; can be provided either as volumetric ([m3 m-3] when
SMDMethod
= 1) or gravimetric quantity ([kg kg-1] whenSMDMethod
= 2). This should be used in conjunction with other soil properties in SUEWS_Soil.txt.- Configuration
Referencing Table
Requirement
Comment
Observed soil moisture [ m3 m-3 or kg kg-1]
- Year#
- Description
Year [YYYY]
- Configuration
Referencing Table
Requirement
Comment
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] for all atmospheric forcing variables set in SSss_YYYY_data_tt.txt.
- Configuration
Referencing Table
Requirement
Comment
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
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
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
initial convective boundary layer height [m]