""" ThermalBoundary module SPDX - License - Identifier: LGPL - 3.0 - or -later Copyright © 2020 Project Author Guille Gutierrez guillermo.gutierrezmorote@concordia.ca """ from city_model_structure.thermal_opening import ThermalOpening from city_model_structure.thermal_zone import ThermalZone from city_model_structure.layer import Layer from helpers.configuration import Configuration from typing import List class ThermalBoundary: def __init__(self, surface, delimits): self._surface = surface self._delimits = delimits # ToDo: up to at least LOD2 will be just one thermal opening per Thermal boundary, review for LOD3 and LOD4 self._thermal_openings = [ThermalOpening()] self._layers = None self._outside_solar_absorptance = Configuration().outside_solar_absorptance self._outside_thermal_absorptance = None self._outside_visible_absorptance = None self._window_ratio = None self._u_value = None self._window_area = None self._shortwave_reflectance = 1 - self._outside_solar_absorptance @property def delimits(self) -> List[ThermalZone]: return self._delimits @property def azimuth(self): return self._surface.azimuth @property def inclination(self): return self._surface.inclination @property def area(self): return self._surface.area @property def area_above_ground(self): return self._surface.area_above_ground @property def area_below_ground(self): return self._surface.area_below_ground @property def outside_solar_absorptance(self): return self._outside_solar_absorptance @outside_solar_absorptance.setter def outside_solar_absorptance(self, value): self._outside_solar_absorptance = value self._shortwave_reflectance = 1.0 - float(value) @property def outside_thermal_absorptance(self): return self._outside_thermal_absorptance @outside_thermal_absorptance.setter def outside_thermal_absorptance(self, value): self._outside_thermal_absorptance = value @property def outside_visible_absorptance(self): return self._outside_visible_absorptance @outside_visible_absorptance.setter def outside_visible_absorptance(self, value): self._outside_visible_absorptance = value @property def thermal_openings(self) -> List[ThermalOpening]: return self._thermal_openings @thermal_openings.setter def thermal_openings(self, value): self._thermal_openings = value @property def layers(self) -> List[Layer]: return self._layers @layers.setter def layers(self, value): self._layers = value @property def type(self): return self._surface.type @property def window_ratio(self): return self._window_ratio @window_ratio.setter def window_ratio(self, value): self._window_ratio = value @property def window_area(self): if self._window_area is None: try: self._window_area = float(self._surface.area) * float(self.window_ratio) except TypeError: raise Exception('Window ratio is not defined or invalid surface area') return self._window_area @property def u_value(self): if self._u_value is None: h_i = Configuration().h_i h_e = Configuration().h_e r_value = 1.0/h_i + 1.0/h_e try: for layer in self.layers: if layer.material.no_mass: r_value += float(layer.material.thermal_resistance) else: r_value = r_value + float(layer.material.conductivity) / float(layer.thickness) self._u_value = 1.0/r_value except TypeError: raise Exception('Constructions layers are not initialized') return self._u_value @property def shortwave_reflectance(self): return self._shortwave_reflectance @shortwave_reflectance.setter def shortwave_reflectance(self, value): self._shortwave_reflectance = value self._outside_solar_absorptance = 1.0 - float(value)