192 lines
9.0 KiB
Python
192 lines
9.0 KiB
Python
"""
|
|
NrcanUsageParameters extracts the usage properties from NRCAN catalog and assigns to each building
|
|
SPDX - License - Identifier: LGPL - 3.0 - or -later
|
|
Copyright © 2022 Concordia CERC group
|
|
Project Coder Pilar Monsalvete Alvarez de Uribarri pilar.monsalvete@concordia.ca
|
|
"""
|
|
import copy
|
|
import sys
|
|
import numpy
|
|
|
|
import helpers.constants as cte
|
|
from imports.usage.helpers.usage_helper import UsageHelper
|
|
from city_model_structure.building_demand.usage import Usage
|
|
from city_model_structure.building_demand.lighting import Lighting
|
|
from city_model_structure.building_demand.occupancy import Occupancy
|
|
from city_model_structure.building_demand.appliances import Appliances
|
|
from city_model_structure.building_demand.thermal_control import ThermalControl
|
|
from city_model_structure.attributes.schedule import Schedule
|
|
from city_model_structure.building_demand.internal_gain import InternalGain
|
|
from catalog_factories.usage_catalog_factory import UsageCatalogFactory
|
|
|
|
|
|
class NrcanUsageParameters:
|
|
"""
|
|
NrcanUsageParameters class
|
|
"""
|
|
def __init__(self, city, base_path):
|
|
self._city = city
|
|
self._path = base_path
|
|
|
|
def enrich_buildings(self):
|
|
"""
|
|
Returns the city with the usage parameters assigned to the buildings
|
|
:return:
|
|
"""
|
|
city = self._city
|
|
nrcan_catalog = UsageCatalogFactory('nrcan').catalog
|
|
|
|
for building in city.buildings:
|
|
usage_name = UsageHelper.nrcan_from_hub_usage(building.function)
|
|
try:
|
|
archetype_usage = self._search_archetypes(nrcan_catalog, usage_name)
|
|
except KeyError:
|
|
sys.stderr.write(f'Building {building.name} has unknown usage archetype for building function:'
|
|
f' {building.function}')
|
|
return
|
|
|
|
for internal_zone in building.internal_zones:
|
|
if internal_zone.area is None:
|
|
raise Exception('Internal zone area not defined, ACH cannot be calculated')
|
|
if internal_zone.volume is None:
|
|
raise Exception('Internal zone volume not defined, ACH cannot be calculated')
|
|
if internal_zone.area <= 0:
|
|
raise Exception('Internal zone area is zero, ACH cannot be calculated')
|
|
volume_per_area = internal_zone.volume / internal_zone.area
|
|
usage_zone = Usage()
|
|
usage_zone.name = usage_name
|
|
self._assign_values(usage_zone, archetype_usage, volume_per_area)
|
|
usage_zone.percentage = 1
|
|
self._calculate_reduced_values_from_extended_library(usage_zone, archetype_usage)
|
|
|
|
internal_zone.usages = [usage_zone]
|
|
|
|
@staticmethod
|
|
def _search_archetypes(comnet_catalog, usage_name):
|
|
comnet_archetypes = comnet_catalog.entries('archetypes').usages
|
|
for building_archetype in comnet_archetypes:
|
|
if str(usage_name) == str(building_archetype.name):
|
|
return building_archetype
|
|
raise KeyError('archetype not found')
|
|
|
|
@staticmethod
|
|
def _assign_values(usage_zone, archetype, volume_per_area):
|
|
# Due to the fact that python is not a typed language, the wrong object type is assigned to
|
|
# usage_zone.occupancy when writing usage_zone.occupancy = archetype.occupancy.
|
|
# Same happens for lighting and appliances. Therefore, this walk around has been done.
|
|
if archetype.mechanical_air_change > 0:
|
|
usage_zone.mechanical_air_change = archetype.mechanical_air_change
|
|
elif archetype.ventilation_rate > 0:
|
|
usage_zone.mechanical_air_change = archetype.ventilation_rate / volume_per_area \
|
|
* cte.HOUR_TO_MINUTES * cte.MINUTES_TO_SECONDS
|
|
else:
|
|
usage_zone.mechanical_air_change = 0
|
|
_occupancy = Occupancy()
|
|
_occupancy.occupancy_density = archetype.occupancy.occupancy_density
|
|
_occupancy.sensible_radiative_internal_gain = archetype.occupancy.sensible_radiative_internal_gain
|
|
_occupancy.latent_internal_gain = archetype.occupancy.latent_internal_gain
|
|
_occupancy.sensible_convective_internal_gain = archetype.occupancy.sensible_convective_internal_gain
|
|
_occupancy.occupancy_schedules = archetype.occupancy.occupancy_schedules
|
|
usage_zone.occupancy = _occupancy
|
|
_lighting = Lighting()
|
|
_lighting.density = archetype.lighting.density
|
|
_lighting.convective_fraction = archetype.lighting.convective_fraction
|
|
_lighting.radiative_fraction = archetype.lighting.radiative_fraction
|
|
_lighting.latent_fraction = archetype.lighting.latent_fraction
|
|
_lighting.schedules = archetype.lighting.schedules
|
|
usage_zone.lighting = _lighting
|
|
_appliances = Appliances()
|
|
_appliances.density = archetype.appliances.density
|
|
_appliances.convective_fraction = archetype.appliances.convective_fraction
|
|
_appliances.radiative_fraction = archetype.appliances.radiative_fraction
|
|
_appliances.latent_fraction = archetype.appliances.latent_fraction
|
|
_appliances.schedules = archetype.appliances.schedules
|
|
usage_zone.appliances = _appliances
|
|
_control = ThermalControl()
|
|
_control.cooling_set_point_schedules = archetype.thermal_control.cooling_set_point_schedules
|
|
_control.heating_set_point_schedules = archetype.thermal_control.heating_set_point_schedules
|
|
_control.hvac_availability_schedules = archetype.thermal_control.hvac_availability_schedules
|
|
usage_zone.thermal_control = _control
|
|
|
|
@staticmethod
|
|
def _calculate_reduced_values_from_extended_library(usage_zone, archetype):
|
|
number_of_days_per_type = {'WD': 251, 'Sat': 52, 'Sun': 62}
|
|
total = 0
|
|
for schedule in archetype.thermal_control.hvac_availability_schedules:
|
|
if schedule.day_types[0] == cte.SATURDAY:
|
|
for value in schedule.values:
|
|
total += value * number_of_days_per_type['Sat']
|
|
elif schedule.day_types[0] == cte.SUNDAY:
|
|
for value in schedule.values:
|
|
total += value * number_of_days_per_type['Sun']
|
|
else:
|
|
for value in schedule.values:
|
|
total += value * number_of_days_per_type['WD']
|
|
|
|
usage_zone.hours_day = total / 365
|
|
usage_zone.days_year = 365
|
|
|
|
@staticmethod
|
|
def _calculate_internal_gains(archetype):
|
|
|
|
_DAYS = [cte.MONDAY, cte.TUESDAY, cte.WEDNESDAY, cte.THURSDAY, cte.FRIDAY, cte.SATURDAY, cte.SUNDAY, cte.HOLIDAY]
|
|
_number_of_days_per_type = [51, 50, 50, 50, 50, 52, 52, 10]
|
|
|
|
_mean_internal_gain = InternalGain()
|
|
_mean_internal_gain.type = 'mean_value_of_internal_gains'
|
|
_base_schedule = Schedule()
|
|
_base_schedule.type = cte.INTERNAL_GAINS
|
|
_base_schedule.time_range = cte.DAY
|
|
_base_schedule.time_step = cte.HOUR
|
|
_base_schedule.data_type = cte.FRACTION
|
|
|
|
_latent_heat_gain = archetype.occupancy.latent_internal_gain
|
|
_convective_heat_gain = archetype.occupancy.sensible_convective_internal_gain
|
|
_radiative_heat_gain = archetype.occupancy.sensible_radiative_internal_gain
|
|
_total_heat_gain = (_latent_heat_gain + _convective_heat_gain + _radiative_heat_gain)
|
|
|
|
_schedule_values = numpy.zeros([24, 8])
|
|
_sum = 0
|
|
for day, _schedule in enumerate(archetype.occupancy.schedules):
|
|
for v, value in enumerate(_schedule.values):
|
|
_schedule_values[v, day] = value * _total_heat_gain
|
|
_sum += value * _total_heat_gain * _number_of_days_per_type[day]
|
|
|
|
_total_heat_gain += archetype.lighting.density + archetype.appliances.density
|
|
_latent_heat_gain += archetype.lighting.latent_fraction * archetype.lighting.density\
|
|
+ archetype.appliances.latent_fraction * archetype.appliances.density
|
|
_radiative_heat_gain = archetype.lighting.radiative_fraction * archetype.lighting.density \
|
|
+ archetype.appliances.radiative_fraction * archetype.appliances.density
|
|
_convective_heat_gain = archetype.lighting.convective_fraction * archetype.lighting.density \
|
|
+ archetype.appliances.convective_fraction * archetype.appliances.density
|
|
|
|
for day, _schedule in enumerate(archetype.lighting.schedules):
|
|
for v, value in enumerate(_schedule.values):
|
|
_schedule_values[v, day] += value * archetype.lighting.density
|
|
_sum += value * archetype.lighting.density * _number_of_days_per_type[day]
|
|
|
|
for day, _schedule in enumerate(archetype.appliances.schedules):
|
|
for v, value in enumerate(_schedule.values):
|
|
_schedule_values[v, day] += value * archetype.appliances.density
|
|
_sum += value * archetype.appliances.density * _number_of_days_per_type[day]
|
|
|
|
_latent_fraction = _latent_heat_gain / _total_heat_gain
|
|
_radiative_fraction = _radiative_heat_gain / _total_heat_gain
|
|
_convective_fraction = _convective_heat_gain / _total_heat_gain
|
|
_average_internal_gain = _sum / _total_heat_gain
|
|
|
|
_schedules = []
|
|
for day in range(0, len(_DAYS)):
|
|
_schedule = copy.deepcopy(_base_schedule)
|
|
_schedule.day_types = [_DAYS[day]]
|
|
_schedule.values = _schedule_values[:day]
|
|
_schedules.append(_schedule)
|
|
|
|
_mean_internal_gain.average_internal_gain = _average_internal_gain
|
|
_mean_internal_gain.latent_fraction = _latent_fraction
|
|
_mean_internal_gain.convective_fraction = _convective_fraction
|
|
_mean_internal_gain.radiative_fraction = _radiative_fraction
|
|
_mean_internal_gain.schedules = _schedules
|
|
|
|
return [_mean_internal_gain]
|