Note

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

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

4.2.1. SUEWS_AnthropogenicEmission.txt

Note

this file used to be named as SUEWS_AnthropogenicHeat.txt and is changed to this name in v2019a.

SUEWS_AnthropogenicEmission.txt provides the parameters needed to model the anthropogenic heat flux using either the method of Järvi et al. (2011) based on heating and cooling degree days (EmissionsMethod = 2 in RunControl.nml) or the method of Loridan et al. (2011) based on air temperature (EmissionsMethod = 1 in RunControl.nml).

The sub-daily variation in anthropogenic heat flux is modelled according to the daily cycles specified in SUEWS_Profiles.txt.

Alternatively, if available, the anthropogenic heat flux can be provided in the met forcing file (and set EmissionsMethod = 0 in RunControl.nml) by filling the qf column with valid values.

No.

Column Name

Use

Description

1

Code

L

Code linking to a corresponding look-up table.

2

BaseT_HC

MU

Base temperature for heating degree days [°C]

3

QF_A_WD

MU O

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

4

QF_B_WD

MU O

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

5

QF_C_WD

MU O

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

6

QF_A_WE

MU O

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

7

QF_B_WE

MU O

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

8

QF_C_WE

MU O

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

9

AHMin_WD

MU O

Minimum QF on weekdays [W m-2]

10

AHMin_WE

MU O

Minimum QF on weekends [W m-2]

11

AHSlope_Heating_WD

MU O

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

12

AHSlope_Heating_WE

MU O

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

13

AHSlope_Cooling_WD

MU O

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

14

AHSlope_Cooling_WE

MU O

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

15

TCritic_Heating_WD

MU O

Critical heating temperature on weekdays [°C]

16

TCritic_Heating_WE

MU O

Critical heating temperature on weekends [°C]

17

TCritic_Cooling_WD

MU O

Critical cooling temperature on weekdays [°C]

18

TCritic_Cooling_WE

MU O

Critical cooling temperature on weekends [°C]

19

EnergyUseProfWD

MU O

Code linking to EnergyUseProfWD in SUEWS_Profiles.txt.

20

EnergyUseProfWE

MU O

Code linking to EnergyUseProfWE in SUEWS_Profiles.txt.

21

ActivityProfWD

MU O

Code linking to ActivityProfWD in SUEWS_Profiles.txt.

22

ActivityProfWE

MU O

Code linking to ActivityProfWE in SUEWS_Profiles.txt.

23

TraffProfWD

MU O

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

24

TraffProfWE

MU O

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

25

PopProfWD

MU O

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

26

PopProfWE

MU O

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

27

MinQFMetab

MU O

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

28

MaxQFMetab

MU O

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

29

MinFCMetab

MU O

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

30

MaxFCMetab

MU O

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

31

FrPDDwe

MU O

Fraction of weekend population to weekday population. [-]

32

FrFossilFuel_Heat

MU O

Fraction of fossil fuels used for building heating [-]

33

FrFossilFuel_NonHeat

MU O

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

34

EF_umolCO2perJ

MU O

Emission factor for fuels used for building heating.

35

EnEF_v_Jkm

MU O

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

36

FcEF_v_kgkmWD

MU O

CO2 emission factor for weekdays [kg km-1]

37

FcEF_v_kgkmWE

MU O

CO2 emission factor for weekends [kg km-1]

38

CO2PointSource

MU O

CO2 emission factor [kg km-1]

39

TrafficUnits

MU O

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

An example SUEWS_AnthropogenicEmission.txt can be found below:

1           2                 3                4                5                6                7                8              9               10                11                 12                 13                 14                 15                 16                 17                 18                 19              20              21             22              23             24             25             26               27            28             29             30                 31               32                33                   34             35                    36               37            38             39
Code        BaseTHDD          QF_A_WD          QF_B_WD          QF_C_WD          QF_A_WE          QF_B_WE          QF_C_WE        AHMin_WD        AHMin_WE          AHSlope_Heating_WD AHSlope_Heating_WE AHSlope_Cooling_WD AHSlope_Cooling_WE TCritic_Heating_WD TCritic_Heating_WE TCritic_Cooling_WD TCritic_Cooling_WE EnergyUseProfWD EnergyUseProfWE ActivityProfWD ActivityProfWE  TraffProfWD    TraffProfWE    PopProfWD      PopProfWE        MinQFMetab    MaxQFMetab     MinFCMetab     MaxFCMetab         FrPDDwe          FrFossilFuel_Heat FrFossilFuel_NonHeat EF_umolCO2perJ EnEF_v_Jkm            FcEF_v_kgkmWD    FcEF_v_kgkmWE CO2PointSource TrafficUnits
10          18.2000           0.1000           0.0099           0.0102           0.1000           0.0099           0.0102         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         3970000.0000          0.2850           0.2850        0              1.0000
11          18.2000           0.3081           0.0099           0.0102           0.3081           0.0099           0.0102         -999.0000       -999.0000         -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
551         18.2000           0.1446           0.0000           0.0037           0.1329           0.0000           0.0038         -999.0000       -999.0000         -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          42.0000         43.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.7000            0.7000               1.1590         3970000.0000          0.2850           0.2850        0              1.0000
5512        18.2000           0.3081           0.0099           0.0102           0.3081           0.0099           0.0102         -999.0000       -999.0000         -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          -999.0000          42.0000         43.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.7000            0.7000               1.1590         3970000.0000          0.2850           0.2850        0              1.0000
661         18.2000           0.3081           0.0099           0.0102           0.3081           0.0099           0.0102         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             42.0000         43.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.7000            0.7000               1.1590         3970000.0000          0.2850           0.2850        0              1.0000
2           18.2000           0.1000           0.0099           0.0200           0.1000           0.0099           0.0200         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
3           18.2000           0.1000           0.0099           0.0300           0.1000           0.0099           0.0300         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
4           18.2000           0.1000           0.0099           0.0400           0.1000           0.0099           0.0400         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
51          18.2000           0.1217           0.0099           0.0400           0.1156           0.0099           0.0400         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
52          18.2000           0.1702           0.0099           0.0400           0.1446           0.0099           0.0400         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
53          18.2000           0.0772           0.0099           0.0400           0.0754           0.0099           0.0400         15.0000         15.0000           2.7000             2.7000             2.7000             2.7000             7.0000             7.0000             7.0000             7.0000             44.0000         45.0000         55663.0000     55664.0000      701.0000       702.0000       801.0000       802.0000         75.0000       175.0000       120.0000       280.0000           1.0000           0.0500            0.0000               1.1590         4110000.0000          0.2850           0.2850        0              1.0000
-9
-9