Note

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

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

4.1.1. Scheme options

CBLuse

Warning

Not available in this version.

Requirement

Required

Description

Determines whether a CBL slab model is used to calculate temperature and humidity.

Configuration

Value

Comments

0

CBL model not used. SUEWS and LUMPS use temperature and humidity provided in the meteorological forcing file.

1

CBL model is used to calculate temperature and humidity used in SUEWS and LUMPS.

SnowUse
Requirement

Required

Description

Determines whether the snow part of the model runs.

Configuration

Value

Comments

0

Snow calculations are not performed.

1

Snow calculations are performed.

NetRadiationMethod
Requirement

Required

Description

Determines method for calculation of radiation fluxes.

Configuration

Value

Comments

0

Uses observed values of Q* supplied in meteorological forcing file.

1

Q* modelled with L↓ observations supplied in meteorological forcing file. Zenith angle not accounted for in albedo calculation.

2

Q* modelled with L↓ modelled using cloud cover fraction supplied in meteorological forcing file (Loridan et al. 2011 [L2011]). Zenith angle not accounted for in albedo calculation.

3

Q* modelled with L↓ modelled using air temperature and relative humidity supplied in meteorological forcing file (Loridan et al. 2011 [L2011]). Zenith angle not accounted for in albedo calculation.

100

Q* modelled with L↓ observations supplied in meteorological forcing file. Zenith angle accounted for in albedo calculation. SSss_YYYY_NARPOut.txt file produced. Not recommended in this version.

200

Q* modelled with L↓ modelled using cloud cover fraction supplied in meteorological forcing file (Loridan et al. 2011 [L2011]). Zenith angle accounted for in albedo calculation. SSss_YYYY_NARPOut.txt file produced. Not recommended in this version.

300

Q* modelled with L↓ modelled using air temperature and relative humidity supplied in meteorological forcing file (Loridan et al. 2011 [L2011]). Zenith angle accounted for in albedo calculation. SSss_YYYY_NARPOut.txt file produced. Not recommended in this version.

BaseTMethod
Requirement

Required

Description

Determines method for base temperature used in HDD/CDD calculations.

Configuration

Value

Comments

1

V-shape approach: a single BaseT_HC is used

2

U-shape approach: TCritic_Heating_WD (TCritic_Heating_WE) and TCritic_Cooling_WD (TCritic_Cooling_WE) are used for HDD and CDD calculations in weekdays (weekends), respectively.

EmissionsMethod
Requirement

Required

Description

Determines method for QF calculation.

Configuration

Value

Comments

0

Uses values provided in the meteorological forcing file (SSss_YYYY_data_tt.txt). If you do not want to include QF to the calculation of surface energy balance, you should set values in the meteorological forcing file to zero to prevent calculation of QF. UMEP provides two methods to calculate QF LQF which is simpler GQF which is more complete but requires more data inputs

1

Not recommended in this version. Calculated according to Loridan et al. (2011) [L2011] using coefficients specified in SUEWS_AnthropogenicEmission.txt. Modelled values will be used even if QF is provided in the meteorological forcing file.

2

Recommended in this version. Calculated according to Järvi et al. (2011) [J11] using coefficients specified in SUEWS_AnthropogenicEmission.txt and diurnal patterns specified in SUEWS_Profiles.txt. Modelled values will be used even if QF is provided in the meteorological forcing file.

3

Updated Loridan et al. (2011) [L2011] method using daily (not instantaneous) air temperature (HDD(id-1,3)) using coefficients specified in SUEWS_AnthropogenicEmission.txt. Modelled values will be used even if QF is provided in the meteorological forcing file.

StorageHeatMethod
Requirement

Required

Description

Determines method for calculating storage heat flux ΔQS.

Configuration

Value

Comments

0

Uses observed values of ΔQS supplied in meteorological forcing file.

1

ΔQS modelled using the objective hysteresis model (OHM) [G91OHM] using parameters specified for each surface type.

3

ΔQS modelled using AnOHM. Not recommended in this version.

4

ΔQS modelled using the Element Surface Temperature Method (ESTM) (Offerle et al. 2005 [OGF2005] ). Not recommended in this version.

OHMIncQF
Requirement

Required

Description

Determines whether the storage heat flux calculation uses Q* or ( Q* +QF).

Configuration

Value

Comments

0

ΔQS modelled Q* only.

1

ΔQS modelled using Q*+QF.

StabilityMethod
Requirement

Required

Description

Defines which atmospheric stability functions are used.

Configuration

Value

Comments

0

Not used.

1

Not used.

2

  • Momentum:

    • unstable: Dyer (1974) [D74] modified by Högstrom (1988) [H1988]

    • stable: Van Ulden and Holtslag (1985) [VUH85]

  • Heat: Dyer (1974) [D74] modified by Högstrom (1988) [H1988]

Not recommended in this version.

3

  • Momentum: Campbell and Norman (Eq 7.27, Pg97) [CN1988]

  • Heat

Recommended in this version.

4

  • Momentum: Businger et al. (1971) [B71] modified by Högstrom (1988) [H1988]

  • Heat: Businger et al. (1971) [B71] modified by Högstrom (1988) [H1988]

Not recommended in this version.

RoughLenHeatMethod
Requirement

Required

Description

Determines method for calculating roughness length for heat.

Configuration

Value

Comments

1

Uses value of 0.1*z0m.

2

Calculated according to Kawai et al. (2009) [Ka09].

3

Calculated according to Voogt and Grimmond (2000) [VG00].

4

Calculated according to Kanda et al. (2007) [Ka07].

5

Adaptively using z0m based on pervious coverage: if fully pervious, use method 1; otherwise, use method 2.

Recommended in this version.

RoughLenMomMethod
Requirement

Required

Description

Determines how aerodynamic roughness length (z0m) and zero displacement height (zdm) are calculated.

Configuration

Value

Comments

1

Values specified in SUEWS_SiteSelect.txt are used.

Tip

Note that UMEP provides tools to calculate these. See Kent et al. (2017a) [Kent2017a] for recommendations on methods. Kent et al. (2017b) [Kent2017b] have developed a method to include vegetation which is also avaialble within UMEP.

2

z0m and zd are calculated using ‘rule of thumb’ (Grimmond and Oke 1999 [GO99]) using mean building and tree height specified in SUEWS_SiteSelect.txt. z0m and zd are adjusted with time to account for seasonal variation in porosity of deciduous trees.

3

z0m and zd are calculated based on the MacDonald et al. (1998) [Mc98] method using mean building and tree heights, plan area fraction and frontal areal index specified in SUEWS_SiteSelect.txt. z0m and zd are adjusted with time to account for seasonal variation in porosity of deciduous trees.

SMDMethod
Requirement

Required

Description

Determines method for calculating soil moisture deficit (SMD).

Configuration

Value

Comments

0

SMD modelled using parameters specified in SUEWS_Soil.txt. Recommended in this version.

1

Observed SM provided in the meteorological forcing file is used. Data are provided as volumetric soil moisture content. Metadata must be provided in SUEWS_Soil.txt.

2

Observed SM provided in the meteorological forcing file is used. Data are provided as gravimetric soil moisture content. Metadata must be provided in SUEWS_Soil.txt.

WaterUseMethod
Requirement

Required

Description

Defines how external water use is calculated.

Configuration

Value

Comments

0

External water use modelled using parameters specified in SUEWS_Irrigation.txt.

1

Observations of external water use provided in the meteorological forcing file are used.