""" CityObject module SPDX - License - Identifier: LGPL - 3.0 - or -later Copyright © 2022 Concordia CERC group Project Coder Guille Gutierrez guillermo.gutierrezmorote@concordia.ca """ from __future__ import annotations from typing import List, Union from hub.city_model_structure.iot.sensor import Sensor from hub.city_model_structure.building_demand.surface import Surface from hub.city_model_structure.attributes.polyhedron import Polyhedron from hub.helpers.configuration_helper import ConfigurationHelper class CityObject: """ class CityObject """ def __init__(self, name, surfaces): self._name = name self._surfaces = surfaces self._type = None self._city_object_lower_corner = None self._city_object_upper_corner = None self._detailed_polyhedron = None self._simplified_polyhedron = None self._min_x = ConfigurationHelper().max_coordinate self._min_y = ConfigurationHelper().max_coordinate self._min_z = ConfigurationHelper().max_coordinate self._max_x = ConfigurationHelper().min_coordinate self._max_y = ConfigurationHelper().min_coordinate self._max_z = ConfigurationHelper().min_coordinate self._centroid = None self._volume = None self._external_temperature = dict() self._global_horizontal = dict() self._diffuse = dict() self._beam = dict() self._sensors = [] self._neighbours = None @property def name(self): """ Get city object name :return: str """ return self._name @property def type(self) -> str: """ Get city object type :return: str """ return self._type @property def volume(self) -> float: """ Get city object volume in cubic meters :return: float """ if self._volume is None: self._volume = self.simplified_polyhedron.volume return self._volume @volume.setter def volume(self, value): self._volume = value @property def detailed_polyhedron(self) -> Polyhedron: """ Get city object polyhedron including details such as holes :return: Polyhedron """ if self._detailed_polyhedron is None: polygons = [] for surface in self.surfaces: polygons.append(surface.solid_polygon) if surface.holes_polygons is not None: for hole_polygon in surface.holes_polygons: polygons.append(hole_polygon) self._detailed_polyhedron = Polyhedron(polygons) return self._detailed_polyhedron @property def simplified_polyhedron(self) -> Polyhedron: """ Get city object polyhedron, just the simple lod2 representation :return: Polyhedron """ if self._simplified_polyhedron is None: polygons = [] for surface in self.surfaces: polygons.append(surface.perimeter_polygon) self._simplified_polyhedron = Polyhedron(polygons) return self._simplified_polyhedron @property def surfaces(self) -> List[Surface]: """ Get city object surfaces :return: [Surface] """ return self._surfaces def surface(self, name) -> Union[Surface, None]: """ Get the city object surface with a given name :param name: str :return: None or Surface """ for s in self.surfaces: if s.name == name: return s return None def surface_by_id(self, identification_number) -> Union[Surface, None]: """ Get the city object surface with a given name :param identification_number: str :return: None or Surface """ for s in self.surfaces: if str(s.id) == str(identification_number): return s return None @property def centroid(self) -> List[float]: """ Get city object centroid :return: [x,y,z] """ if self._centroid is None: self._centroid = self.simplified_polyhedron.centroid return self._centroid @property def max_height(self) -> float: """ Get city object maximal height in meters :return: float """ return self.simplified_polyhedron.max_z @property def external_temperature(self) -> {float}: """ Get external temperature surrounding the city object in Celsius :return: dict{DataFrame(float)} """ return self._external_temperature @external_temperature.setter def external_temperature(self, value): """ Set external temperature surrounding the city object in Celsius :param value: dict{DataFrame(float)} """ self._external_temperature = value @property def global_horizontal(self) -> dict: """ Get global horizontal radiation surrounding the city object in W/m2 :return: dict{DataFrame(float)} """ return self._global_horizontal @global_horizontal.setter def global_horizontal(self, value): """ Set global horizontal radiation surrounding the city object in W/m2 :param value: dict{DataFrame(float)} """ self._global_horizontal = value @property def diffuse(self) -> dict: """ Get diffuse radiation surrounding the city object in W/m2 :return: dict{DataFrame(float)} """ return self._diffuse @diffuse.setter def diffuse(self, value): """ Set diffuse radiation surrounding the city object in W/m2 :param value: dict{DataFrame(float)} """ self._diffuse = value @property def beam(self) -> dict: """ Get beam radiation surrounding the city object in W/m2 :return: dict{DataFrame(float)} """ return self._beam @beam.setter def beam(self, value): """ Set beam radiation surrounding the city object in W/m2 :param value: dict{DataFrame(float)} """ self._beam = value @property def lower_corner(self): """ Get city object lower corner coordinates [x, y, z] :return: [x,y,z] """ if self._city_object_lower_corner is None: self._city_object_lower_corner = [self._min_x, self._min_y, self._min_z] return self._city_object_lower_corner @property def upper_corner(self): """ Get city object upper corner coordinates [x, y, z] :return: [x,y,z] """ if self._city_object_upper_corner is None: self._city_object_upper_corner = [self._max_x, self._max_y, self._max_z] return self._city_object_upper_corner @property def sensors(self) -> List[Sensor]: """ Get sensors belonging to the city object :return: [Sensor] """ return self._sensors @sensors.setter def sensors(self, value): """ Set sensors belonging to the city object :param value: [Sensor] """ self._sensors = value @property def neighbours(self) -> Union[None, List[CityObject]]: """ Get the list of neighbour_objects and their properties associated to the current city_object """ return self._neighbours @neighbours.setter def neighbours(self, value): """ Set the list of neighbour_objects and their properties associated to the current city_object """ self._neighbours = value