uwg.UCMDef module

Class for Urban Canopy Model.

class uwg.UCMDef.UCMDef(bldHeight, bldDensity, verToHor, treeCoverage, sensAnthrop, latAnthrop, initialTemp, initialHum, initialWind, parameter, r_glaze, SHGC, alb_wall, road)[source]

Bases: object

Definition of Urban Canopy - Building Energy Model Class

Parameters:
  • bldHeight – Average building height (m).

  • bldDensity – Horizontal building density (footprint/total_area).

  • verToHor – Vertical-to-horizontal urban area ratio (facade area/urban area).

  • treeCoverage – Horizontal tree density (footprint).

  • sensAnthrop – Sensible anthropogenic heat (other than from buildings) (W m-2).

  • latAnthrop – Latent anthropogenic heat (other than from buildings) (W m-2).

  • initialTemp – Canyon air temperature (db) (K).

  • initialHum – Canyon specific humidity (kg kg-1).

  • initialWind – Urban canyon wind velocity (m s-1).

  • parameter – Param object.

  • r_glaze – Area-weighted average of glazing ratio from urban building stock.

  • SHGC – Area-weighted average of SHGC from urban building stock.

  • alb_wall – Area-weighted average of wall albedo from urban building stock.

  • road – Road element class (moved from BEM).

Properties
  • road – Road element class (moved from BEM)

  • # Urban Canyon Parameters

  • bldHeight – average building height (m)

  • bldDensity – horizontal building density (footprint)

  • verToHor – vertical-to-horizontal urban area ratio (facade area/urban area)

  • treeCoverage – horizontal tree density (footprint)

  • sensAnthrop – sensible anthropogenic heat (other than from buildings) (W m-2)

  • latAnthrop – latent anthropogenic heat (other than from buildings) (W m-2)

  • z0u – urban roughness length (m)

  • l_disp – urban displacement length (m)

  • roadShad – shadowing of roads

  • canWidth – canyon width (m)

  • bldWidth – bld width (m)

  • canAspect – canyon aspect ratio

  • roadConf – road-sky configuration factors (sky view factor)

  • alb_wall – average wall albedo

  • wallConf – wall-sky configuration factors (sky view factor)

  • VFwallroad – wall-road view factor

  • VFroadwall – road-wall view factor

  • facArea – facade area (m2)

  • roadArea – road area (m2)

  • roofArea – roof area (m2) (also building area)

  • facAbsor – average facade absortivity

  • roadAbsor – average road absortivity

  • h_mix – waste heat mix into canyon ratio

  • # Urban Canyon Variables

  • canTemp – canyon air temperature (db) (K)

  • Tdp – dew point temperature

  • Twb – wetbulb temperature

  • canHum – canyon specific humidity (kg kg-1)

  • canRHum – canyon relative humidity ()

  • canWind – urban canyon wind velocity (m s-1)

  • turbU – canyon turbulent velocities (m s-1)

  • turbV – canyon turbulent velocities (m s-1)

  • turbW – canyon turbulent velocities (m s-1)

  • ublTemp – urban boundary layer temperature (K)

  • ublTempdx – urban boundary layer temperature discretization (K)

  • ublWind – urban boundary layer wind velocity (m s-1)

  • ustar – friction velocity (m s-1)

  • ustarMod – modified friction velocity (m s-1)

  • uExch – exchange velocity (m s-1)

  • treeLatHeat – latent heat from trees (W m-2)

  • treeSensHeat – sensible heat from trees (W m-2)

  • sensHeat – urban sensible heat (W m-2)

  • latHeat – urban latent heat (W m-2)

  • windProf – urban wind profile

  • Q_roof – sensible heat flux from building roof (convective)

  • Q_wall – sensible heat flux from building wall (convective)

  • Q_window – sensible heat flux from building window (via U-factor)

  • Q_road – sensible heat flux from road (convective)

  • Q_hvac – sensible heat flux from HVAC waste

  • Q_traffic – sensible heat flux from traffic (net)

  • Q_ubl – Convective heat exchange with UBL layer

  • Q_vent – Convective heat exchange from ventilation/infiltration

  • SolRecWall – Solar received by wall

  • SolRecRoof – Solar received by roof

  • SolRecRoad – Solar received by road

  • roadTemp – average road temperature (K)

  • roofTemp – average roof temperature (K)

  • wallTemp – average wall temperature (K)

  • ElecTotal – Total Electricity consumption of urban area

  • GasTotal – Total Gas consumption of the urban area

UCModel(BEM, T_ubl, forc, parameter)[source]

Calculate the urban canyon temperature per The uwg (2012) Eq. 10.