""" 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 sys import helpers.constants as cte from helpers.dictionaries import Dictionaries 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 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 comnet_catalog = UsageCatalogFactory('comnet').catalog for building in city.buildings: usage_name = Dictionaries().hub_usage_to_nrcan_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 usage_name = Dictionaries().hub_usage_to_comnet_usage[building.function] try: comnet_archetype_usage = self._search_archetypes(comnet_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) self._assign_comnet_extra_values(usage_zone, comnet_archetype_usage) usage_zone.percentage = 1 self._calculate_reduced_values_from_extended_library(usage_zone, archetype_usage) internal_zone.usages = [usage_zone] @staticmethod def _search_archetypes(catalog, usage_name): archetypes = catalog.entries('archetypes').usages for building_archetype in 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): 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.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 _assign_comnet_extra_values(usage_zone, archetype): _occupancy = usage_zone.occupancy _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 @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 max_heating_setpoint = cte.MIN_FLOAT min_heating_setpoint = cte.MAX_FLOAT for schedule in archetype.thermal_control.heating_set_point_schedules: if schedule.values is None: max_heating_setpoint = None min_heating_setpoint = None break if max(schedule.values) > max_heating_setpoint: max_heating_setpoint = max(schedule.values) if min(schedule.values) < min_heating_setpoint: min_heating_setpoint = min(schedule.values) min_cooling_setpoint = cte.MAX_FLOAT for schedule in archetype.thermal_control.cooling_set_point_schedules: if schedule.values is None: min_cooling_setpoint = None break if min(schedule.values) < min_cooling_setpoint: min_cooling_setpoint = min(schedule.values) usage_zone.thermal_control.mean_heating_set_point = max_heating_setpoint usage_zone.thermal_control.heating_set_back = min_heating_setpoint usage_zone.thermal_control.mean_cooling_set_point = min_cooling_setpoint