""" Building module SPDX - License - Identifier: LGPL - 3.0 - or -later Copyright © 2020 Project Author Guille Gutierrez guillermo.gutierrezmorote@concordia.ca contributors: Pilar Monsalvete Alvarez de Uribarri pilar.monsalvete@concordia.ca """ from typing import List, Union, TypeVar import numpy as np from city_model_structure.building_demand.surface import Surface from city_model_structure.building_demand.usage_zone import UsageZone from city_model_structure.building_demand.storey import Storey from city_model_structure.city_object import CityObject from city_model_structure.building_demand.household import Household from city_model_structure.attributes.polyhedron import Polyhedron ThermalZone = TypeVar('ThermalZone') class Building(CityObject): """ Building(CityObject) class """ def __init__(self, name, lod, surfaces, year_of_construction, function, city_lower_corner, terrains=None): super().__init__(name, lod, surfaces, city_lower_corner) self._households = None self._basement_heated = None self._attic_heated = None self._terrains = terrains self._year_of_construction = year_of_construction self._function = function self._average_storey_height = None self._storeys_above_ground = None self._floor_area = None self._roof_type = None self._storeys = None self._geometrical_zones = None self._thermal_zones = None self._usage_zones = None self._type = 'building' self._heating = dict() self._cooling = dict() self._eave_height = None self._grounds = [] self._roofs = [] self._walls = [] self._internal_walls = [] for surface_id, surface in enumerate(self.surfaces): self._min_x = min(self._min_x, surface.lower_corner[0]) self._min_y = min(self._min_y, surface.lower_corner[1]) self._min_z = min(self._min_z, surface.lower_corner[2]) surface.id = surface_id # todo: consider all type of surfaces, not only these four if surface.type == 'Ground': self._grounds.append(surface) elif surface.type == 'Wall': self._walls.append(surface) elif surface.type == 'Roof': self._roofs.append(surface) else: self._internal_walls.append(surface) @property def geometrical_zones(self) -> List[Polyhedron]: if self._geometrical_zones is None: polygons = [] for surface in self.surfaces: polygons.append(surface.perimeter_polygon) self._geometrical_zones = [Polyhedron(polygons)] return self._geometrical_zones @property def grounds(self) -> List[Surface]: """ Get building ground surfaces :return: [Surface] """ return self._grounds @property def roofs(self) -> List[Surface]: """ Get building roof surfaces :return: [Surface] """ return self._roofs @property def walls(self) -> List[Surface]: """ Get building wall surfaces :return: [Surface] """ return self._walls @property def usage_zones(self) -> Union[None, List[UsageZone]]: """ Get city object usage zones :return: [UsageZone] """ return self._usage_zones @usage_zones.setter def usage_zones(self, value): """ Set city object usage zones :param value: [UsageZone] """ self._usage_zones = value @property def terrains(self) -> Union[None, List[Surface]]: """ Get city object terrain surfaces :return: [Surface] """ return self._terrains @property def attic_heated(self) -> Union[None, int]: """ Get if the city object attic is heated :return: None or int """ return self._attic_heated @attic_heated.setter def attic_heated(self, value): """ Set if the city object attic is heated :param value: int """ if value is not None: self._attic_heated = int(value) @property def basement_heated(self) -> Union[None, int]: """ Get if the city object basement is heated :return: None or int """ return self._basement_heated @basement_heated.setter def basement_heated(self, value): """ Set if the city object basement is heated :param value: int """ if value is not None: self._basement_heated = int(value) @property def thermal_zones(self) -> Union[None, List[ThermalZone]]: """ Get building thermal zones :return: [ThermalZone] """ return self._thermal_zones @thermal_zones.setter def thermal_zones(self, value): """ Set city object thermal zones :param value: [ThermalZone] """ self._thermal_zones = value @property def heated_volume(self): """ Raises not implemented error """ # ToDo: this need to be calculated based on the basement and attic heated values raise NotImplementedError @property def year_of_construction(self): """ Get building year of construction :return: int """ return self._year_of_construction @year_of_construction.setter def year_of_construction(self, value): """ Set building year of construction :param value: int """ if value is not None: self._year_of_construction = int(value) @property def function(self) -> Union[None, str]: """ Get building function :return: None or str """ return self._function @function.setter def function(self, value): """ Set building function :param value: str """ if value is not None: self._function = str(value) @property def average_storey_height(self) -> Union[None, float]: """ Get building average storey height in meters :return: None or float """ return self._average_storey_height @average_storey_height.setter def average_storey_height(self, value): """ Set building average storey height in meters :param value: float """ if value is not None: self._average_storey_height = float(value) @property def storeys_above_ground(self) -> Union[None, int]: """ Get building storeys number above ground :return: None or int """ return self._storeys_above_ground @storeys_above_ground.setter def storeys_above_ground(self, value): """ Set building storeys number above ground :param value: int """ if value is not None: self._storeys_above_ground = int(value) @property def heating(self) -> dict: """ Get heating demand in Wh :return: dict{DataFrame(float)} """ return self._heating @heating.setter def heating(self, value): """ Set heating demand in Wh :param value: dict{DataFrame(float)} """ self._heating = value @property def cooling(self) -> dict: """ Get cooling demand in Wh :return: dict{DataFrame(float)} """ return self._cooling @cooling.setter def cooling(self, value): """ Set cooling demand in Wh :param value: dict{DataFrame(float)} """ self._cooling = value @property def eave_height(self): """ Get building eave height in meters :return: float """ if self._eave_height is None: self._eave_height = 0 for wall in self.walls: self._eave_height = max(self._eave_height, wall.upper_corner[2]) return self._eave_height @property def storeys(self) -> List[Storey]: """ Get building storeys :return: [Storey] """ return self._storeys @storeys.setter def storeys(self, value): """ Set building storeys :param value: [Storey] """ self._storeys = value @property def roof_type(self): """ Get roof type for the building flat or pitch :return: str """ if self._roof_type is None: self._roof_type = 'flat' for roof in self.roofs: grads = np.rad2deg(roof.inclination) if 355 > grads > 5: self._roof_type = 'pitch' break return self._roof_type @roof_type.setter def roof_type(self, value): """ Set roof type for the building flat or pitch :return: str """ self._roof_type = value @property def floor_area(self): """ Get building floor area in square meters :return: float """ if self._floor_area is None: self._floor_area = 0 for surface in self.surfaces: if surface.type == 'Ground': self._floor_area += surface.perimeter_polygon.area return self._floor_area @property def households(self) -> List[Household]: """ Get the list of households inside the building :return: List[Household] """ return self._households @property def is_conditioned(self): """ Get building heated flag :return: Boolean """ if self.thermal_zones is None: return False for thermal_zone in self.thermal_zones: if thermal_zone.hvac_system is not None: return True return False