uwg.building module

Class of specified building characteristics.

class uwg.building.Building(floor_height, int_heat_night, int_heat_day, int_heat_frad, int_heat_flat, infil, vent, glazing_ratio, u_value, shgc, condtype, cop, coolcap, heateff, initial_temp)[source]

Bases: object

Specified building characteristics.

Parameters:

  • floor_height – Floor height in meters.

  • int_heat_night – Nighttime internal sensible heat gain [W/m2].

  • int_heat_day – Daytime internal sensible heat gain [W/m2].

  • int_heat_frad – Value between 0 and 1 for radiant fraction of internal gains.

  • int_heat_flat – Value between 0 and 1 for latent fraction of internal gains.

  • infil – Infiltration rate (ACH).

  • vent – Ventilation rate (ACH).

  • glazing_ratio – Value between 0 and 1 for glazing ratio.

  • u_value – Window U-value including film coefficent [W/(m2-K)].

  • shgc – Value between 0 and 1 for window Solar Heat Gain Coefficient (SHGC).

  • condtype – Text string for cooling condensation system type. Choose from AIR or WATER.

  • cop – Coefficient of Performance (COP) of cooling system (nominal).

  • coolcap – Rated cooling system capacity [W/m2].

  • heateff – Heating system capacity.

  • initial_temp – Initial indoor air temperature [K].

Properties:

  • floor_height – floor height (m)

  • int_heat – timestep internal heat gains (W m-2 bld) (sensible only)

  • int_heat_night – nighttime internal heat gains (W m-2 floor)

  • int_heat_day – daytime internal heat gains (W m-2 floor)

  • int_heat_frad – radiant fraction of internal gains

  • int_heat_flat – latent fraction of internal gains

  • infil – Infiltration (ACH)

  • vent – Ventilation (m^3/s/m^2)

  • glazing_ratio – glazing ratio

  • u_value – window U-value (W m-2 K-1) (including film coeff)

  • shgc – window SHGC

  • condtype – cooling condensation system type {‘AIR’, ‘WATER’}

  • cop – COP of the cooling system (nominal)

  • cop_adj – adjusted COP per temperature

  • cool_setpoint_day – daytime indoor cooling set-point (K)

  • cool_setpoint_night – nighttime indoor cooling set-point (K)

  • heat_setpoint_day – daytime indoor heating set-point (K)

  • heat_setpoint_night – nighttime indoor heating set-point (K)

  • heat_cap – rated heating system capacity (W m-2)

  • heateff – heating system efficiency (-)

  • canyon_fraction – fraction of waste heat released to canyon, default = 1

  • msys – HVAC supply mass flowrate (kg s-1 m-2)

  • indoor_temp – indoor air temperature (K)

  • indoor_hum – indoor specific humidity (kg / kg)

  • Twb – wetbulb temperature

  • Tdp – dew point

  • indoorRhum – indoor relative humidity

  • area_floor – total floor space of the BEM

  • FanMax – max fan flow rate (m^3/s) per DOE

  • nFloor – number of floors

  • RadFOcc – Radiant fraction of occupant

  • LatFOcc – Latent fraction of occupant

  • RadFEquip – Radiant fraction of equipment

  • RadFLight – Radiant fraction of light

  • sensCoolDemand – building sensible cooling demand (W m-2)

  • sensHeatDemand – building sensible heating demand (W m-2)

  • copAdj – adjusted COP per temperature

  • dehumDemand – dehumidification energy (W m-2)

  • coolConsump – cooling energy consumption (W m-2)

  • heatConsump – heating energy consumption (W m-2)

  • sensWaste – sensible waste heat (W m-2)

  • latWaste – lat waste heat (W m-2)

  • fluxMass – mass surface heat flux (W m-2) (mass to indoor air)

  • fluxWall – wall surface heat flux (W m-2) (wall to inside)

  • fluxRoof – roof surface heat flux (W m-2) (roof to inside)

  • fluxSolar – solar heat gain (W m-2) through window (SHGC)

  • fluxWindow – heat gain/loss from window (U-value)

  • fluxInterior – internal heat gain adjusted for latent/LW heat (W m-2)

  • fluxInfil – heat flux from infiltration (W m-2)

  • fluxVent – heat flux from ventilation (W m-2)

  • ElecTotal – total electricity consumption - (W/m^2) of floor

  • GasTotal – total gas consumption - (W/m^2) of floor

  • Qhvac – total heat removed (sensible + latent)

  • Qheat – total heat added (sensible only)

BEMCalc(UCM, BEM, forc, parameter, simTime)[source]

Update BEM by a single timestep.

classmethod from_dict(data)[source]

Create a Building object from a dictionary.

Parameters:

data – A Building dictionary following the format below.

to_dict()[source]

Building dictionary representation.

TEMP_COEF_CONFLICT_MSG = 'FATAL ERROR! Try running a shorter simulation (for a fraction of the year)\nor try increasing the simulation timesteps per hour'
property condtype

Get or set text string for cooling condensation system type.

Choose from:

  • “AIR”

  • “WATER”.

property coolcap

Get or set rated cooling system capacity [W/m2].

property cop

Get or set the nominal Coefficient of Performance (COP) of cooling system.

property floor_height

Get or set floor height in meters.

property glazing_ratio

Get or set value between 0 and 1 for glazing ratio.

property heateff

Get or set heating system capacity.

property infil

Get or set infiltration rate (ACH).

property initial_temp

Get or set initial indoor air temperature [K].

property int_heat_flat

Get or set value between 0 and 1 for latent fraction of internal gains.

property int_heat_frad

Get or set value between 0 and 1 radiant fraction of internal gains.

property int_heat_night

Get or set nighttime internal sensible heat gain [W/m2].

property shgc

Get or set building glazing Solar Heat Gain Coefficient.

property u_value

Get or set window U-value including film coefficent [W/(m2-K)].

property vent

Get or set ventilation rate (ACH).