dragonfly_uwg.traffic module

class dragonfly_uwg.traffic.TrafficParameter(watts_per_area=Autocalculate, weekday_schedule=None, saturday_schedule=None, sunday_schedule=None)[source]

Bases: object

Object representing the traffic within an urban area.

Note

[1] Sailor, David J. (2011). A review of methods for estimating anthropogenic heat and moisture emissions in the urban environment. Royal Meteorological Society, Volume 31, Issue 2, Pages 189-199. https://doi.org/10.1002/joc.2106

Parameters

  • watts_per_area –

    A number representing the maximum sensible anthropogenic heat flux of the urban area in watts per square meter. This is specifically the heat that DOES NOT originate from buildings and mostly includes heat from automobiles, street lighting, and human metabolism. If autocalculate, it will be estimated frm the average building story count of the model hosting the traffic parameters (Default: autocalculate). Values for different cities can be found in (Sailor, 2011)[1]. Typical values include:

    • 20 W/m2 = A typical downtown area

    • 10 W/m2 = A commercial area in Singapore

    • 8 W/m2 = A typical mixed use part of Toulouse, France

    • 4 W/m2 = A residential area in Singapore

  • weekday_schedule – A list of 24 fractional values that will be multiplied by the watts_per_area to produce hourly values for heat on the weekday of the simulation. (Default: a typical schedule for a commercial area).

  • saturday_schedule – A list of 24 fractional values that will be multiplied by the watts_per_area to produce hourly values for heat on the Saturday of the simulation. (Default: a typical schedule for a commercial area).

  • sunday_schedule – A list of 24 fractional values that will be multiplied by the watts_per_area to produce hourly values for heat on the Sunday of the simulation. (Default: a typical schedule for a commercial area).

ToString()[source]

Overwrite .NET ToString method.

duplicate()[source]

Get a copy of this object.

classmethod from_dict(data)[source]

Initialize an TrafficParameter from a dictionary.

Parameters

data – A dictionary representation of an TrafficParameter object in the format below.

{
"type": 'TrafficParameter',
"watts_per_area": 10,  # number for heat in W/m2
"weekday_schedule": [],  # list of 24 fractional values for a schedule
"saturday_schedule": [],  # list of 24 fractional values for a schedule
"sunday_schedule": []  # list of 24 fractional values for a schedule
}
to_dict()[source]

Get TrafficParameter as a dictionary.

SATURDAY_DEFAULT = (0.2, 0.2, 0.2, 0.2, 0.2, 0.3, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.5, 0.6, 0.7, 0.7, 0.7, 0.7, 0.5, 0.4, 0.3, 0.2, 0.2)
SUNDAY_DEFAULT = (0.2, 0.2, 0.2, 0.2, 0.2, 0.3, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.4, 0.3, 0.3, 0.2, 0.2)
WEEKDAY_DEFAULT = (0.2, 0.2, 0.2, 0.2, 0.2, 0.4, 0.7, 0.9, 0.9, 0.6, 0.6, 0.6, 0.6, 0.6, 0.7, 0.8, 0.9, 0.9, 0.8, 0.8, 0.7, 0.3, 0.2, 0.2)
property saturday_schedule

Get or set the Saturday traffic schedule as a list of 24 fractional values.

property sunday_schedule

Get or set the Sunday traffic schedule as a list of 24 fractional values.

property watts_per_area

Get or set a number for the max sensible heat flux of the traffic.

property weekday_schedule

Get or set the Weekday traffic schedule as a list of 24 fractional values.