Update utils/cooling_load.py

utils/cooling_load.py

@@ -5,7 +5,7 @@ Reference: ASHRAE Handbook—Fundamentals (2017), Chapter 18, Section 18.5.
 
 Author: Dr Majed Abuseif
 Date: April 2025
-Version: 1.0.6
+Version: 1.0.7
 """
 
 from typing import Dict, List, Any, Optional, Tuple
@@ -14,7 +14,7 @@ import logging
 from data.ashrae_tables import ASHRAETables
 from utils.heat_transfer import HeatTransferCalculations
 from utils.psychrometrics import Psychrometrics
-from app.component_selection import Wall, Roof, Window, Door, Orientation
+from app.component_selection import Wall, Roof, Window, Door, Skylight, Orientation
 from data.drapery import Drapery
 
 # Set up logging
@@ -219,6 +219,8 @@ class CoolingLoadCalculator:
             'roofs': {h: 0.0 for h in range(1, 25)},
             'windows_conduction': {h: 0.0 for h in range(1, 25)},
             'windows_solar': {h: 0.0 for h in range(1, 25)},
+            'skylights_conduction': {h: 0.0 for h in range(1, 25)},
+            'skylights_solar': {h: 0.0 for h in range(1, 25)},
             'doors': {h: 0.0 for h in range(1, 25)},
             'people_sensible': {h: 0.0 for h in range(1, 25)},
             'people_latent': {h: 0.0 for h in range(1, 25)},
@@ -276,6 +278,7 @@ class CoolingLoadCalculator:
             # Calculate loads for windows
             for window in building_components.get('windows', []):
                 for hour in range(24):
+                    adjusted_shgc = getattr(window, 'adjusted_shgc', None)
                     load_dict = self.calculate_window_cooling_load(
                         window=window,
                         outdoor_temp=outdoor_conditions['temperature'],
@@ -283,11 +286,29 @@ class CoolingLoadCalculator:
                         month=month,
                         hour=hour,
                         latitude=latitude,
-                        shading_coefficient=window.shading_coefficient
+                        shading_coefficient=window.shading_coefficient,
+                        adjusted_shgc=adjusted_shgc
                     )
                     hourly_loads['windows_conduction'][hour + 1] += load_dict['conduction']
                     hourly_loads['windows_solar'][hour + 1] += load_dict['solar']
             
+            # Calculate loads for skylights
+            for skylight in building_components.get('skylights', []):
+                for hour in range(24):
+                    adjusted_shgc = getattr(skylight, 'adjusted_shgc', None)
+                    load_dict = self.calculate_skylight_cooling_load(
+                        skylight=skylight,
+                        outdoor_temp=outdoor_conditions['temperature'],
+                        indoor_temp=indoor_conditions['temperature'],
+                        month=month,
+                        hour=hour,
+                        latitude=latitude,
+                        shading_coefficient=skylight.shading_coefficient,
+                        adjusted_shgc=adjusted_shgc
+                    )
+                    hourly_loads['skylights_conduction'][hour + 1] += load_dict['conduction']
+                    hourly_loads['skylights_solar'][hour + 1] += load_dict['solar']
+            
             # Calculate loads for doors
             for door in building_components.get('doors', []):
                 for hour in range(24):
@@ -381,6 +402,8 @@ class CoolingLoadCalculator:
                     hourly_loads['roofs'][hour],
                     hourly_loads['windows_conduction'][hour],
                     hourly_loads['windows_solar'][hour],
+                    hourly_loads['skylights_conduction'][hour],
+                    hourly_loads['skylights_solar'][hour],
                     hourly_loads['doors'][hour],
                     hourly_loads['people_sensible'][hour],
                     hourly_loads['people_latent'][hour],
@@ -402,6 +425,8 @@ class CoolingLoadCalculator:
                 'roofs': hourly_loads['roofs'][design_hour],
                 'windows_conduction': hourly_loads['windows_conduction'][design_hour],
                 'windows_solar': hourly_loads['windows_solar'][design_hour],
+                'skylights_conduction': hourly_loads['skylights_conduction'][design_hour],
+                'skylights_solar': hourly_loads['skylights_solar'][design_hour],
                 'doors': hourly_loads['doors'][design_hour],
                 'people_sensible': hourly_loads['people_sensible'][design_hour],
                 'people_latent': hourly_loads['people_latent'][design_hour],
@@ -438,6 +463,8 @@ class CoolingLoadCalculator:
                 design_loads['roofs'] +
                 design_loads['windows_conduction'] +
                 design_loads['windows_solar'] +
+                design_loads['skylights_conduction'] +
+                design_loads['skylights_solar'] +
                 design_loads['doors'] +
                 design_loads['people_sensible'] +
                 design_loads['lights'] +
@@ -634,7 +661,8 @@ class CoolingLoadCalculator:
         month: str,
         hour: int,
         latitude: str,
-        shading_coefficient: float
+        shading_coefficient: float,
+        adjusted_shgc: Optional[float] = None
     ) -> Dict[str, float]:
         """
         Calculate cooling load for a window (conduction and solar).
@@ -648,6 +676,7 @@ class CoolingLoadCalculator:
             hour: Hour of the day
             latitude: Latitude (e.g., '24N')
             shading_coefficient: Default shading coefficient
+            adjusted_shgc: Adjusted SHGC from external drapery calculation (optional)
             
         Returns:
             Dictionary with conduction, solar, and total loads in Watts
@@ -664,8 +693,8 @@ class CoolingLoadCalculator:
             conduction_load = window.u_value * window.area * cltd
 
             # Determine shading coefficient
-            effective_shading_coefficient = shading_coefficient
-            if hasattr(window, 'drapery') and window.drapery and window.drapery.enabled:
+            effective_shading_coefficient = adjusted_shgc if adjusted_shgc is not None else shading_coefficient
+            if adjusted_shgc is None and hasattr(window, 'drapery') and window.drapery and window.drapery.enabled:
                 try:
                     effective_shading_coefficient = window.drapery.get_shading_coefficient(window.shgc)
                     if self.debug_mode:
@@ -675,7 +704,7 @@ class CoolingLoadCalculator:
                         logger.warning(f"Error getting drapery shading coefficient: {str(e)}. Using default shading_coefficient={shading_coefficient}")
             else:
                 if self.debug_mode:
-                    logger.debug(f"No enabled drapery. Using default shading_coefficient={shading_coefficient}")
+                    logger.debug(f"Using shading coefficient: {effective_shading_coefficient} (adjusted_shgc={adjusted_shgc}, drapery={'enabled' if hasattr(window, 'drapery') and window.drapery and window.drapery.enabled else 'disabled'})")
 
             # Solar load
             try:
@@ -708,6 +737,90 @@ class CoolingLoadCalculator:
                 logger.error(f"Error in calculate_window_cooling_load: {str(e)}")
             raise Exception(f"Error in calculate_window_cooling_load: {str(e)}")
     
+    def calculate_skylight_cooling_load(
+        self,
+        skylight: Skylight,
+        outdoor_temp: float,
+        indoor_temp: float,
+        month: str,
+        hour: int,
+        latitude: str,
+        shading_coefficient: float,
+        adjusted_shgc: Optional[float] = None
+    ) -> Dict[str, float]:
+        """
+        Calculate cooling load for a skylight (conduction and solar).
+        Reference: ASHRAE Handbook—Fundamentals (2017), Chapter 18, Equations 18.12-18.13.
+        
+        Args:
+            skylight: Skylight component
+            outdoor_temp: Outdoor temperature (°C)
+            indoor_temp: Indoor temperature (°C)
+            month: Design month
+            hour: Hour of the day
+            latitude: Latitude (e.g., '24N')
+            shading_coefficient: Default shading coefficient
+            adjusted_shgc: Adjusted SHGC from external drapery calculation (optional)
+            
+        Returns:
+            Dictionary with conduction, solar, and total loads in Watts
+        """
+        try:
+            latitude = self.validate_latitude(latitude)
+            month = self.validate_month(month)
+            hour = self.validate_hour(hour)
+            if self.debug_mode:
+                logger.debug(f"calculate_skylight_cooling_load: latitude={latitude}, month={month}, hour={hour}, orientation=Horizontal")
+
+            # Conduction load
+            cltd = outdoor_temp - indoor_temp
+            conduction_load = skylight.u_value * skylight.area * cltd
+
+            # Determine shading coefficient
+            effective_shading_coefficient = adjusted_shgc if adjusted_shgc is not None else shading_coefficient
+            if adjusted_shgc is None and hasattr(skylight, 'drapery') and skylight.drapery and skylight.drapery.enabled:
+                try:
+                    effective_shading_coefficient = skylight.drapery.get_shading_coefficient(skylight.shgc)
+                    if self.debug_mode:
+                        logger.debug(f"Using drapery shading coefficient: {effective_shading_coefficient}")
+                except Exception as e:
+                    if self.debug_mode:
+                        logger.warning(f"Error getting drapery shading coefficient: {str(e)}. Using default shading_coefficient={shading_coefficient}")
+            else:
+                if self.debug_mode:
+                    logger.debug(f"Using shading coefficient: {effective_shading_coefficient} (adjusted_shgc={adjusted_shgc}, drapery={'enabled' if hasattr(skylight, 'drapery') and skylight.drapery and skylight.drapery.enabled else 'disabled'})")
+
+            # Solar load
+            try:
+                scl = self.ashrae_tables.get_scl(
+                    latitude=latitude,
+                    month=month,
+                    orientation='Horizontal',
+                    hour=hour
+                )
+            except Exception as e:
+                if self.debug_mode:
+                    logger.error(f"get_scl failed for latitude={latitude}, month={month}, orientation=Horizontal: {str(e)}")
+                    logger.warning("Using default SCL=100 W/m²")
+                scl = 100.0
+
+            solar_load = skylight.area * skylight.shgc * effective_shading_coefficient * scl
+
+            total_load = conduction_load + solar_load
+            if self.debug_mode:
+                logger.debug(f"Skylight load: conduction={conduction_load}, solar={solar_load}, total={total_load}, effective_shading_coefficient={effective_shading_coefficient}")
+
+            return {
+                'conduction': max(conduction_load, 0.0),
+                'solar': max(solar_load, 0.0),
+                'total': max(total_load, 0.0)
+            }
+        
+        except Exception as e:
+            if self.debug_mode:
+                logger.error(f"Error in calculate_skylight_cooling_load: {str(e)}")
+            raise Exception(f"Error in calculate_skylight_cooling_load: {str(e)}")
+    
     def calculate_door_cooling_load(
         self,
         door: Door,