Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Feature/add thermal building model #985

Draft
wants to merge 13 commits into
base: dev
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8,761 changes: 8,761 additions & 0 deletions examples/thermal_building_model/DEU_BW_Mannheim_107290_TRY2010_12_Jahr_BBSR.csv

Large diffs are not rendered by default.

284 changes: 284 additions & 0 deletions examples/thermal_building_model/calculate_gain_by_Sun.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,284 @@
"""
copied from https://github.com/architecture-building-systems/RC_BuildingSimulator
Tool to Evaluate Radiation incident on a surface of a set angle
"""

import pandas as pd
import math
import datetime


__authors__ = "Prageeth Jayathissa"
__copyright__ = (
"Copyright 2016, Architecture and Building Systems - ETH Zurich"
)
__credits__ = ["pysolar, Quaschning Volker, Rolf Hanitsch, Linus Walker"]
__license__ = "MIT"
__version__ = "0.1"
__maintainer__ = "Prageeth Jayathissa"
__email__ = "[email protected]"
__status__ = "production"


def sunPositionReader(SunPosition_path):
sun_labels = ["altitude", "azimuth"] # 'HOY',
result = pd.read_csv(SunPosition_path, skiprows=1, names=sun_labels)
Fixed Show fixed Hide fixed
Fixed Show fixed Hide fixed
return result


class Location(
object,
):
"""Set the Location of the Simulation with an Energy Plus Weather File"""

def __init__(self, epwfile_path):
epw_labels = [
"year",
"month",
"day",
"hour",
"minute",
"datasource",
"drybulb_C",
"dewpoint_C",
"relhum_percent",
"atmos_Pa",
"exthorrad_Whm2",
"extdirrad_Whm2",
"horirsky_Whm2",
"glohorrad_Whm2",
"dirnorrad_Whm2",
"difhorrad_Whm2",
"glohorillum_lux",
"dirnorillum_lux",
"difhorillum_lux",
"zenlum_lux",
"winddir_deg",
"windspd_ms",
"totskycvr_tenths",
"opaqskycvr_tenths",
"visibility_km",
"ceiling_hgt_m",
"presweathobs",
"presweathcodes",
"precip_wtr_mm",
"aerosol_opt_thousandths",
"snowdepth_cm",
"days_last_snow",
"Albedo",
"liq_precip_depth_mm",
"liq_precip_rate_Hour",
]
self.weather_data = pd.read_csv(
epwfile_path, skiprows=8, header=None, names=epw_labels,
encoding='ISO-8859-1', engine='python').drop('datasource', axis=1)

def calc_sun_position(self, latitude_deg, longitude_deg, year, hoy):
"""
Calculates the Sun Position for a specific hour and location
:param latitude_deg: Geographical Latitude in Degrees
:type latitude_deg: float
:param longitude_deg: Geographical Longitude in Degrees
:type longitude_deg: float
:param year: year
:type year: int
:param hoy: Hour of the year from the start. The first hour of January is 1
:type hoy: int
:return: altitude, azimuth: Sun position in altitude and azimuth degrees [degrees]
:rtype: tuple
"""

# Convert to Radians
latitude_rad = math.radians(latitude_deg)
# longitude_rad = math.radians(longitude_deg) # Note: this is never used

# Set the date in UTC based off the hour of year and the year itself
start_of_year = datetime.datetime(year, 1, 1, 0, 0, 0, 0)
utc_datetime = start_of_year + datetime.timedelta(hours=hoy)

# Angular distance of the sun north or south of the earths equator
# Determine the day of the year.
day_of_year = utc_datetime.timetuple().tm_yday

# Calculate the declination angle: The variation due to the earths tilt
# http://www.pveducation.org/pvcdrom/properties-of-sunlight/declination-angle
declination_rad = math.radians(
23.45 * math.sin((2 * math.pi / 365.0) * (day_of_year - 81))
)

# Normalise the day to 2*pi
# There is some reason as to why it is 364 and not 365.26
angle_of_day = (day_of_year - 81) * (2 * math.pi / 364)

# The deviation between local standard time and true solar time
equation_of_time = (
(9.87 * math.sin(2 * angle_of_day))
- (7.53 * math.cos(angle_of_day))
- (1.5 * math.sin(angle_of_day))
)

# True Solar Time
solar_time = (
(utc_datetime.hour * 60)
+ utc_datetime.minute
+ (4 * longitude_deg)
+ equation_of_time
) / 60.0

# Angle between the local longitude and longitude where the sun is at
# higher altitude
hour_angle_rad = math.radians(15 * (12 - solar_time))

# Altitude Position of the Sun in Radians
altitude_rad = math.asin(
math.cos(latitude_rad)
* math.cos(declination_rad)
* math.cos(hour_angle_rad)
+ math.sin(latitude_rad) * math.sin(declination_rad)
)

# Azimuth Position fo the sun in radians
azimuth_rad = math.asin(
math.cos(declination_rad)
* math.sin(hour_angle_rad)
/ math.cos(altitude_rad)
)

# I don't really know what this code does, it has been imported from
# PySolar
if math.cos(hour_angle_rad) >= (
math.tan(declination_rad) / math.tan(latitude_rad)
):
return math.degrees(altitude_rad), math.degrees(azimuth_rad)
else:
return math.degrees(altitude_rad), (
180 - math.degrees(azimuth_rad)
)


class Window(object):
"""docstring for Window"""

def __init__(
self,
azimuth_tilt,
alititude_tilt=90,
glass_solar_transmittance=0.7,
glass_light_transmittance=0.8,
area=1,
):
self.alititude_tilt_rad = math.radians(alititude_tilt)
self.azimuth_tilt_rad = math.radians(azimuth_tilt)
self.glass_solar_transmittance = glass_solar_transmittance
self.glass_light_transmittance = glass_light_transmittance
self.area = area

def calc_solar_gains(
self,
sun_altitude,
sun_azimuth,
normal_direct_radiation,
horizontal_diffuse_radiation,
):
"""
Calculates the Solar Gains in the building zone through the set Window
:param sun_altitude: Altitude Angle of the Sun in Degrees
:type sun_altitude: float
:param sun_azimuth: Azimuth angle of the sun in degrees
:type sun_azimuth: float
:param normal_direct_radiation: Normal Direct Radiation from weather file
:type normal_direct_radiation: float
:param horizontal_diffuse_radiation: Horizontal Diffuse Radiation from weather file
:type horizontal_diffuse_radiation: float
:return: self.incident_solar, Incident Solar Radiation on window
:return: self.solar_gains - Solar gains in building after transmitting through the window
:rtype: float
"""

direct_factor = self.calc_direct_solar_factor(
sun_altitude,
sun_azimuth,
)
diffuse_factor = self.calc_diffuse_solar_factor()

direct_solar = direct_factor * normal_direct_radiation
diffuse_solar = horizontal_diffuse_radiation * diffuse_factor
self.incident_solar = (direct_solar + diffuse_solar) * self.area

self.solar_gains = self.incident_solar * self.glass_solar_transmittance

def calc_illuminance(
self,
sun_altitude,
sun_azimuth,
normal_direct_illuminance,
horizontal_diffuse_illuminance,
):
"""
Calculates the Illuminance in the building zone through the set Window
:param sun_altitude: Altitude Angle of the Sun in Degrees
:type sun_altitude: float
:param sun_azimuth: Azimuth angle of the sun in degrees
:type sun_azimuth: float
:param normal_direct_illuminance: Normal Direct Illuminance from weather file [Lx]
:type normal_direct_illuminance: float
:param horizontal_diffuse_illuminance: Horizontal Diffuse Illuminance from weather file [Lx]
:type horizontal_diffuse_illuminance: float
:return: self.incident_illuminance, Incident Illuminance on window [Lumens]
:return: self.transmitted_illuminance - Illuminance in building after transmitting through the window [Lumens]
:rtype: float
"""

direct_factor = self.calc_direct_solar_factor(
sun_altitude,
sun_azimuth,
)
diffuse_factor = self.calc_diffuse_solar_factor()

direct_illuminance = direct_factor * normal_direct_illuminance
diffuse_illuminance = diffuse_factor * horizontal_diffuse_illuminance

self.incident_illuminance = (
direct_illuminance + diffuse_illuminance
) * self.area
self.transmitted_illuminance = (
self.incident_illuminance * self.glass_light_transmittance
)

def calc_direct_solar_factor(self, sun_altitude, sun_azimuth):
"""
Calculates the cosine of the angle of incidence on the window
"""
sun_altitude_rad = math.radians(sun_altitude)
sun_azimuth_rad = math.radians(sun_azimuth)

"""
Proportion of the radiation incident on the window (cos of the incident ray)
ref:Quaschning, Volker, and Rolf Hanitsch. "Shade calculations in photovoltaic systems."
ISES Solar World Conference, Harare. 1995.
"""
direct_factor = math.cos(sun_altitude_rad) * math.sin(
self.alititude_tilt_rad
) * math.cos(sun_azimuth_rad - self.azimuth_tilt_rad) + math.sin(
sun_altitude_rad
) * math.cos(
self.alititude_tilt_rad
)

# If the sun is in front of the window surface
if math.degrees(math.acos(direct_factor)) > 90:
direct_factor = 0

else:
pass

return direct_factor

def calc_diffuse_solar_factor(self):
"""Calculates the proportion of diffuse radiation"""
# Proportion of incident light on the window surface
return (1 + math.cos(self.alititude_tilt_rad)) / 2


if __name__ == "__main__":
pass
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
data = {
"Germany": {
"construction_periods": {
(1980, 1990): "01",
(1991, 2000): "02",
},
"code": "DE",
},
"Poland": {
"construction_periods": {
(1980, 1990): "01",
(1991, 2000): "02",
},
"code": "PL",
},
}
Loading
Loading