SUEWS_AnthropogenicEmission.txt
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. note::

    .. versionchanged:: v2019a
        this file is renamed from ``SUEWS_AnthropogenicHeat.txt`` (prior to v2019a) to include more emission related settings.


`SUEWS_AnthropogenicEmission.txt` provides the parameters needed to model the anthropogenic heat flux using either the method of :cite:t:`L11` based on air temperature (`EmissionsMethod` = 1 in `RunControl.nml`) or the method of :cite:t:`J11` based on heating and cooling degree days (`EmissionsMethod` = 2 in `RunControl.nml`).

For the method of :cite:t:`J11` (`EmissionsMethod` = 2 in `RunControl.nml`), one can further configure the scheme for calculting :term:`HDD`/ :term:`CDD` via `BaseTMethod` in `RunControl.nml`:

- `BaseTMethod` = 1 ("V-shape" approach): a single `BaseT_HC` is used by omitting the comfort range where neither heating nor cooling is activated.

- `BaseTMethod` = 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, which allows a comfort range between `TCritic_Heating_WD` (`TCritic_Heating_WE`) and `TCritic_Cooling_WD` (`TCritic_Cooling_WE`).


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 :option:`qf` column with valid values.

**Method-specific required parameters**

For ``EmissionsMethod`` = 0, :option:`qf` from the forcing file is used, so values in this table can be set to ``-999`` when they are not needed.

For ``EmissionsMethod`` = 1, 3, or 4 (and related extended options), provide ``BaseTHDD``, ``AHMin_*``, ``AHSlope_*``, and ``TCritic_*``; ``QF_A_*``, ``QF_B_*``, and ``QF_C_*`` can be set to ``-999``.

For ``EmissionsMethod`` = 2 (and related extended options), provide ``BaseTHDD``, ``QF_A_*``, ``QF_B_*``, and ``QF_C_*``; ``AHMin_*``, ``AHSlope_*``, and ``TCritic_*`` can be set to ``-999``.

**Default profile codes**

The following profile code pairs are used in the distributed sample tables (``benchmark1`` and ``sample-table``):

- Energy use: ``44`` (weekday) and ``45`` (weekend)
- Activity: ``55663`` (weekday) and ``55664`` (weekend)
- Traffic: ``701`` (weekday) and ``702`` (weekend)
- Population: ``801`` (weekday) and ``802`` (weekend)

**Recommended starting values**

The values below are sample benchmark settings (including :cite:t:`W16`, central London). They are not universal defaults and should be calibrated case by case for each location:

- ``BaseTHDD``: ``18.2``
- ``MinQFMetab``: ``75.0``; ``MaxQFMetab``: ``175.0``
- ``MinFCMetab``: ``120.0``; ``MaxFCMetab``: ``280.0``
- ``FrFossilFuel_Heat``: ``0.05`` (up to ``0.7`` in fossil-dependent systems)
- ``FrFossilFuel_NonHeat``: ``0.0`` (up to ``0.7`` in fossil-dependent systems)
- ``EF_umolCO2perJ``: ``1.159``
- ``EnEF_v_Jkm``: ``3.97e6-4.11e6``
- ``FcEF_v_kgkmWD`` / ``FcEF_v_kgkmWE``: ``0.285``

.. note::
   In this table format, ``-999`` indicates "not used" for optional or method-inactive parameters.

.. DON'T manually modify the csv file below
.. as it is always automatically regenerated by each build:
.. edit the item descriptions in file `Input_Options.rst`

.. csv-table::
  :file: csv-table/SUEWS_AnthropogenicEmission.csv
  :header-rows: 1
  :widths: 5 25 5 65

.. only:: html

    An example `SUEWS_AnthropogenicEmission.txt` can be found below:

    .. literalinclude:: sample-table/SUEWS_AnthropogenicEmission.txt

.. only:: latex

    An example `SUEWS_AnthropogenicEmission.txt` can be found in the online version.