Spaces:
Sleeping
Sleeping
Update utils/cooling_load.py
Browse files- utils/cooling_load.py +59 -15
utils/cooling_load.py
CHANGED
|
@@ -4,8 +4,8 @@ Implements ASHRAE steady-state methods with Cooling Load Temperature Difference
|
|
| 4 |
Reference: ASHRAE Handbook—Fundamentals (2017), Chapter 18, Section 18.5.
|
| 5 |
|
| 6 |
Author: Dr Majed Abuseif
|
| 7 |
-
Date:
|
| 8 |
-
Version: 1.0.
|
| 9 |
"""
|
| 10 |
|
| 11 |
from typing import Dict, List, Any, Optional, Tuple
|
|
@@ -279,6 +279,8 @@ class CoolingLoadCalculator:
|
|
| 279 |
for window in building_components.get('windows', []):
|
| 280 |
for hour in range(24):
|
| 281 |
adjusted_shgc = getattr(window, 'adjusted_shgc', None)
|
|
|
|
|
|
|
| 282 |
load_dict = self.calculate_window_cooling_load(
|
| 283 |
window=window,
|
| 284 |
outdoor_temp=outdoor_conditions['temperature'],
|
|
@@ -287,7 +289,9 @@ class CoolingLoadCalculator:
|
|
| 287 |
hour=hour,
|
| 288 |
latitude=latitude,
|
| 289 |
shading_coefficient=window.shading_coefficient,
|
| 290 |
-
adjusted_shgc=adjusted_shgc
|
|
|
|
|
|
|
| 291 |
)
|
| 292 |
hourly_loads['windows_conduction'][hour + 1] += load_dict['conduction']
|
| 293 |
hourly_loads['windows_solar'][hour + 1] += load_dict['solar']
|
|
@@ -296,6 +300,8 @@ class CoolingLoadCalculator:
|
|
| 296 |
for skylight in building_components.get('skylights', []):
|
| 297 |
for hour in range(24):
|
| 298 |
adjusted_shgc = getattr(skylight, 'adjusted_shgc', None)
|
|
|
|
|
|
|
| 299 |
load_dict = self.calculate_skylight_cooling_load(
|
| 300 |
skylight=skylight,
|
| 301 |
outdoor_temp=outdoor_conditions['temperature'],
|
|
@@ -304,7 +310,9 @@ class CoolingLoadCalculator:
|
|
| 304 |
hour=hour,
|
| 305 |
latitude=latitude,
|
| 306 |
shading_coefficient=skylight.shading_coefficient,
|
| 307 |
-
adjusted_shgc=adjusted_shgc
|
|
|
|
|
|
|
| 308 |
)
|
| 309 |
hourly_loads['skylights_conduction'][hour + 1] += load_dict['conduction']
|
| 310 |
hourly_loads['skylights_solar'][hour + 1] += load_dict['solar']
|
|
@@ -662,7 +670,9 @@ class CoolingLoadCalculator:
|
|
| 662 |
hour: int,
|
| 663 |
latitude: str,
|
| 664 |
shading_coefficient: float,
|
| 665 |
-
adjusted_shgc: Optional[float] = None
|
|
|
|
|
|
|
| 666 |
) -> Dict[str, float]:
|
| 667 |
"""
|
| 668 |
Calculate cooling load for a window (conduction and solar).
|
|
@@ -677,6 +687,8 @@ class CoolingLoadCalculator:
|
|
| 677 |
latitude: Latitude (e.g., '24N')
|
| 678 |
shading_coefficient: Default shading coefficient
|
| 679 |
adjusted_shgc: Adjusted SHGC from external drapery calculation (optional)
|
|
|
|
|
|
|
| 680 |
|
| 681 |
Returns:
|
| 682 |
Dictionary with conduction, solar, and total loads in Watts
|
|
@@ -686,17 +698,31 @@ class CoolingLoadCalculator:
|
|
| 686 |
month = self.validate_month(month)
|
| 687 |
hour = self.validate_hour(hour)
|
| 688 |
if self.debug_mode:
|
| 689 |
-
logger.debug(f"calculate_window_cooling_load: latitude={latitude}, month={month}, hour={hour}, orientation={window.orientation.value}")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 690 |
|
| 691 |
# Conduction load
|
| 692 |
cltd = outdoor_temp - indoor_temp
|
| 693 |
-
conduction_load =
|
| 694 |
|
| 695 |
# Determine shading coefficient
|
| 696 |
effective_shading_coefficient = adjusted_shgc if adjusted_shgc is not None else shading_coefficient
|
| 697 |
if adjusted_shgc is None and hasattr(window, 'drapery') and window.drapery and window.drapery.enabled:
|
| 698 |
try:
|
| 699 |
-
effective_shading_coefficient = window.drapery.get_shading_coefficient(
|
| 700 |
if self.debug_mode:
|
| 701 |
logger.debug(f"Using drapery shading coefficient: {effective_shading_coefficient}")
|
| 702 |
except Exception as e:
|
|
@@ -720,7 +746,7 @@ class CoolingLoadCalculator:
|
|
| 720 |
logger.warning("Using default SCL=100 W/m²")
|
| 721 |
scl = 100.0
|
| 722 |
|
| 723 |
-
solar_load = window.area *
|
| 724 |
|
| 725 |
total_load = conduction_load + solar_load
|
| 726 |
if self.debug_mode:
|
|
@@ -746,7 +772,9 @@ class CoolingLoadCalculator:
|
|
| 746 |
hour: int,
|
| 747 |
latitude: str,
|
| 748 |
shading_coefficient: float,
|
| 749 |
-
adjusted_shgc: Optional[float] = None
|
|
|
|
|
|
|
| 750 |
) -> Dict[str, float]:
|
| 751 |
"""
|
| 752 |
Calculate cooling load for a skylight (conduction and solar).
|
|
@@ -761,6 +789,8 @@ class CoolingLoadCalculator:
|
|
| 761 |
latitude: Latitude (e.g., '24N')
|
| 762 |
shading_coefficient: Default shading coefficient
|
| 763 |
adjusted_shgc: Adjusted SHGC from external drapery calculation (optional)
|
|
|
|
|
|
|
| 764 |
|
| 765 |
Returns:
|
| 766 |
Dictionary with conduction, solar, and total loads in Watts
|
|
@@ -770,17 +800,31 @@ class CoolingLoadCalculator:
|
|
| 770 |
month = self.validate_month(month)
|
| 771 |
hour = self.validate_hour(hour)
|
| 772 |
if self.debug_mode:
|
| 773 |
-
logger.debug(f"calculate_skylight_cooling_load: latitude={latitude}, month={month}, hour={hour}, orientation=Horizontal")
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 774 |
|
| 775 |
# Conduction load
|
| 776 |
cltd = outdoor_temp - indoor_temp
|
| 777 |
-
conduction_load =
|
| 778 |
|
| 779 |
# Determine shading coefficient
|
| 780 |
effective_shading_coefficient = adjusted_shgc if adjusted_shgc is not None else shading_coefficient
|
| 781 |
if adjusted_shgc is None and hasattr(skylight, 'drapery') and skylight.drapery and skylight.drapery.enabled:
|
| 782 |
try:
|
| 783 |
-
effective_shading_coefficient = skylight.drapery.get_shading_coefficient(
|
| 784 |
if self.debug_mode:
|
| 785 |
logger.debug(f"Using drapery shading coefficient: {effective_shading_coefficient}")
|
| 786 |
except Exception as e:
|
|
@@ -804,7 +848,7 @@ class CoolingLoadCalculator:
|
|
| 804 |
logger.warning("Using default SCL=100 W/m²")
|
| 805 |
scl = 100.0
|
| 806 |
|
| 807 |
-
solar_load = skylight.area *
|
| 808 |
|
| 809 |
total_load = conduction_load + solar_load
|
| 810 |
if self.debug_mode:
|
|
@@ -1148,7 +1192,7 @@ if __name__ == "__main__":
|
|
| 1148 |
components = {
|
| 1149 |
'walls': [Wall(id="w1", name="North Wall", area=20.0, u_value=0.5, orientation=Orientation.NORTH, wall_group='A', solar_absorptivity=0.6)],
|
| 1150 |
'roofs': [Roof(id="r1", name="Main Roof", area=100.0, u_value=0.3, orientation=Orientation.HORIZONTAL, roof_group='A', solar_absorptivity=0.6)],
|
| 1151 |
-
'windows': [Window(id="win1", name="South Window", area=10.0, u_value=2.8, orientation=Orientation.SOUTH, shgc=0.7, shading_coefficient=0.8)],
|
| 1152 |
'doors': [Door(id="d1", name="Main Door", area=2.0, u_value=2.0, orientation=Orientation.NORTH)]
|
| 1153 |
}
|
| 1154 |
outdoor_conditions = {
|
|
|
|
| 4 |
Reference: ASHRAE Handbook—Fundamentals (2017), Chapter 18, Section 18.5.
|
| 5 |
|
| 6 |
Author: Dr Majed Abuseif
|
| 7 |
+
Date: May 2025
|
| 8 |
+
Version: 1.0.8
|
| 9 |
"""
|
| 10 |
|
| 11 |
from typing import Dict, List, Any, Optional, Tuple
|
|
|
|
| 279 |
for window in building_components.get('windows', []):
|
| 280 |
for hour in range(24):
|
| 281 |
adjusted_shgc = getattr(window, 'adjusted_shgc', None)
|
| 282 |
+
glazing_type = getattr(window, 'glazing_type', None)
|
| 283 |
+
frame_type = getattr(window, 'frame_type', None)
|
| 284 |
load_dict = self.calculate_window_cooling_load(
|
| 285 |
window=window,
|
| 286 |
outdoor_temp=outdoor_conditions['temperature'],
|
|
|
|
| 289 |
hour=hour,
|
| 290 |
latitude=latitude,
|
| 291 |
shading_coefficient=window.shading_coefficient,
|
| 292 |
+
adjusted_shgc=adjusted_shgc,
|
| 293 |
+
glazing_type=glazing_type,
|
| 294 |
+
frame_type=frame_type
|
| 295 |
)
|
| 296 |
hourly_loads['windows_conduction'][hour + 1] += load_dict['conduction']
|
| 297 |
hourly_loads['windows_solar'][hour + 1] += load_dict['solar']
|
|
|
|
| 300 |
for skylight in building_components.get('skylights', []):
|
| 301 |
for hour in range(24):
|
| 302 |
adjusted_shgc = getattr(skylight, 'adjusted_shgc', None)
|
| 303 |
+
glazing_type = getattr(skylight, 'glazing_type', None)
|
| 304 |
+
frame_type = getattr(skylight, 'frame_type', None)
|
| 305 |
load_dict = self.calculate_skylight_cooling_load(
|
| 306 |
skylight=skylight,
|
| 307 |
outdoor_temp=outdoor_conditions['temperature'],
|
|
|
|
| 310 |
hour=hour,
|
| 311 |
latitude=latitude,
|
| 312 |
shading_coefficient=skylight.shading_coefficient,
|
| 313 |
+
adjusted_shgc=adjusted_shgc,
|
| 314 |
+
glazing_type=glazing_type,
|
| 315 |
+
frame_type=frame_type
|
| 316 |
)
|
| 317 |
hourly_loads['skylights_conduction'][hour + 1] += load_dict['conduction']
|
| 318 |
hourly_loads['skylights_solar'][hour + 1] += load_dict['solar']
|
|
|
|
| 670 |
hour: int,
|
| 671 |
latitude: str,
|
| 672 |
shading_coefficient: float,
|
| 673 |
+
adjusted_shgc: Optional[float] = None,
|
| 674 |
+
glazing_type: Optional[str] = None,
|
| 675 |
+
frame_type: Optional[str] = None
|
| 676 |
) -> Dict[str, float]:
|
| 677 |
"""
|
| 678 |
Calculate cooling load for a window (conduction and solar).
|
|
|
|
| 687 |
latitude: Latitude (e.g., '24N')
|
| 688 |
shading_coefficient: Default shading coefficient
|
| 689 |
adjusted_shgc: Adjusted SHGC from external drapery calculation (optional)
|
| 690 |
+
glazing_type: Type of glazing (e.g., 'Single Clear', 'Double Tinted') (optional)
|
| 691 |
+
frame_type: Type of frame (e.g., 'Aluminum', 'Vinyl') (optional)
|
| 692 |
|
| 693 |
Returns:
|
| 694 |
Dictionary with conduction, solar, and total loads in Watts
|
|
|
|
| 698 |
month = self.validate_month(month)
|
| 699 |
hour = self.validate_hour(hour)
|
| 700 |
if self.debug_mode:
|
| 701 |
+
logger.debug(f"calculate_window_cooling_load: latitude={latitude}, month={month}, hour={hour}, orientation={window.orientation.value}, glazing_type={glazing_type}, frame_type={frame_type}")
|
| 702 |
+
|
| 703 |
+
# Fetch U-factor and SHGC from Drapery if glazing_type and frame_type are provided
|
| 704 |
+
u_value = window.u_value
|
| 705 |
+
shgc = window.shgc
|
| 706 |
+
if glazing_type and frame_type:
|
| 707 |
+
try:
|
| 708 |
+
drapery = Drapery()
|
| 709 |
+
u_value = drapery.WINDOW_U_FACTORS.get((glazing_type, frame_type), window.u_value)
|
| 710 |
+
shgc = drapery.WINDOW_SHGC.get((glazing_type, frame_type), window.shgc)
|
| 711 |
+
if self.debug_mode:
|
| 712 |
+
logger.debug(f"Using Drapery values: u_value={u_value}, shgc={shgc} for glazing_type={glazing_type}, frame_type={frame_type}")
|
| 713 |
+
except Exception as e:
|
| 714 |
+
if self.debug_mode:
|
| 715 |
+
logger.warning(f"Error fetching Drapery values for glazing_type={glazing_type}, frame_type={frame_type}: {str(e)}. Using default u_value={u_value}, shgc={shgc}")
|
| 716 |
|
| 717 |
# Conduction load
|
| 718 |
cltd = outdoor_temp - indoor_temp
|
| 719 |
+
conduction_load = u_value * window.area * cltd
|
| 720 |
|
| 721 |
# Determine shading coefficient
|
| 722 |
effective_shading_coefficient = adjusted_shgc if adjusted_shgc is not None else shading_coefficient
|
| 723 |
if adjusted_shgc is None and hasattr(window, 'drapery') and window.drapery and window.drapery.enabled:
|
| 724 |
try:
|
| 725 |
+
effective_shading_coefficient = window.drapery.get_shading_coefficient(shgc)
|
| 726 |
if self.debug_mode:
|
| 727 |
logger.debug(f"Using drapery shading coefficient: {effective_shading_coefficient}")
|
| 728 |
except Exception as e:
|
|
|
|
| 746 |
logger.warning("Using default SCL=100 W/m²")
|
| 747 |
scl = 100.0
|
| 748 |
|
| 749 |
+
solar_load = window.area * shgc * effective_shading_coefficient * scl
|
| 750 |
|
| 751 |
total_load = conduction_load + solar_load
|
| 752 |
if self.debug_mode:
|
|
|
|
| 772 |
hour: int,
|
| 773 |
latitude: str,
|
| 774 |
shading_coefficient: float,
|
| 775 |
+
adjusted_shgc: Optional[float] = None,
|
| 776 |
+
glazing_type: Optional[str] = None,
|
| 777 |
+
frame_type: Optional[str] = None
|
| 778 |
) -> Dict[str, float]:
|
| 779 |
"""
|
| 780 |
Calculate cooling load for a skylight (conduction and solar).
|
|
|
|
| 789 |
latitude: Latitude (e.g., '24N')
|
| 790 |
shading_coefficient: Default shading coefficient
|
| 791 |
adjusted_shgc: Adjusted SHGC from external drapery calculation (optional)
|
| 792 |
+
glazing_type: Type of glazing (e.g., 'Single Clear', 'Double Tinted') (optional)
|
| 793 |
+
frame_type: Type of frame (e.g., 'Aluminum', 'Vinyl') (optional)
|
| 794 |
|
| 795 |
Returns:
|
| 796 |
Dictionary with conduction, solar, and total loads in Watts
|
|
|
|
| 800 |
month = self.validate_month(month)
|
| 801 |
hour = self.validate_hour(hour)
|
| 802 |
if self.debug_mode:
|
| 803 |
+
logger.debug(f"calculate_skylight_cooling_load: latitude={latitude}, month={month}, hour={hour}, orientation=Horizontal, glazing_type={glazing_type}, frame_type={frame_type}")
|
| 804 |
+
|
| 805 |
+
# Fetch U-factor and SHGC from Drapery if glazing_type and frame_type are provided
|
| 806 |
+
u_value = skylight.u_value
|
| 807 |
+
shgc = skylight.shgc
|
| 808 |
+
if glazing_type and frame_type:
|
| 809 |
+
try:
|
| 810 |
+
drapery = Drapery()
|
| 811 |
+
u_value = drapery.SKYLIGHT_U_FACTORS.get((glazing_type, frame_type), skylight.u_value)
|
| 812 |
+
shgc = drapery.SKYLIGHT_SHGC.get((glazing_type, frame_type), skylight.shgc)
|
| 813 |
+
if self.debug_mode:
|
| 814 |
+
logger.debug(f"Using Drapery values: u_value={u_value}, shgc={shgc} for glazing_type={glazing_type}, frame_type={frame_type}")
|
| 815 |
+
except Exception as e:
|
| 816 |
+
if self.debug_mode:
|
| 817 |
+
logger.warning(f"Error fetching Drapery values for glazing_type={glazing_type}, frame_type={frame_type}: {str(e)}. Using default u_value={u_value}, shgc={shgc}")
|
| 818 |
|
| 819 |
# Conduction load
|
| 820 |
cltd = outdoor_temp - indoor_temp
|
| 821 |
+
conduction_load = u_value * skylight.area * cltd
|
| 822 |
|
| 823 |
# Determine shading coefficient
|
| 824 |
effective_shading_coefficient = adjusted_shgc if adjusted_shgc is not None else shading_coefficient
|
| 825 |
if adjusted_shgc is None and hasattr(skylight, 'drapery') and skylight.drapery and skylight.drapery.enabled:
|
| 826 |
try:
|
| 827 |
+
effective_shading_coefficient = skylight.drapery.get_shading_coefficient(shgc)
|
| 828 |
if self.debug_mode:
|
| 829 |
logger.debug(f"Using drapery shading coefficient: {effective_shading_coefficient}")
|
| 830 |
except Exception as e:
|
|
|
|
| 848 |
logger.warning("Using default SCL=100 W/m²")
|
| 849 |
scl = 100.0
|
| 850 |
|
| 851 |
+
solar_load = skylight.area * shgc * effective_shading_coefficient * scl
|
| 852 |
|
| 853 |
total_load = conduction_load + solar_load
|
| 854 |
if self.debug_mode:
|
|
|
|
| 1192 |
components = {
|
| 1193 |
'walls': [Wall(id="w1", name="North Wall", area=20.0, u_value=0.5, orientation=Orientation.NORTH, wall_group='A', solar_absorptivity=0.6)],
|
| 1194 |
'roofs': [Roof(id="r1", name="Main Roof", area=100.0, u_value=0.3, orientation=Orientation.HORIZONTAL, roof_group='A', solar_absorptivity=0.6)],
|
| 1195 |
+
'windows': [Window(id="win1", name="South Window", area=10.0, u_value=2.8, orientation=Orientation.SOUTH, shgc=0.7, shading_coefficient=0.8, glazing_type='Single Clear', frame_type='Aluminum')],
|
| 1196 |
'doors': [Door(id="d1", name="Main Door", area=2.0, u_value=2.0, orientation=Orientation.NORTH)]
|
| 1197 |
}
|
| 1198 |
outdoor_conditions = {
|