Upload heat_transfer.py

utils/heat_transfer.py

@@ -158,7 +158,7 @@ class SolarCalculations:
             solar_altitude: Solar altitude angle in degrees
             
         Returns:
-            Direct normal irradiance in W/m^2
+            Direct normal irradiance in W/m²
         """
         self.validate_angle(solar_altitude, "Solar altitude", 0, 90)
         if solar_altitude <= 0:
@@ -172,11 +172,11 @@ class SolarCalculations:
         Calculate diffuse horizontal irradiance.
         
         Args:
-            dni: Direct normal irradiance in W/m^2
+            dni: Direct normal irradiance in W/m²
             solar_altitude: Solar altitude angle in degrees
             
         Returns:
-            Diffuse horizontal irradiance in W/m^2
+            Diffuse horizontal irradiance in W/m²
         """
         self.validate_angle(solar_altitude, "Solar altitude", 0, 90)
         if solar_altitude <= 0:
@@ -188,13 +188,13 @@ class SolarCalculations:
         Calculate total irradiance on a tilted surface.
         
         Args:
-            dni: Direct normal irradiance in W/m^2
-            dhi: Diffuse horizontal irradiance in W/m^2
+            dni: Direct normal irradiance in W/m²
+            dhi: Diffuse horizontal irradiance in W/m²
             incident_angle: Angle of incidence in degrees
             surface_tilt: Surface tilt angle in degrees
             
         Returns:
-            Total irradiance in W/m^2
+            Total irradiance in W/m²
         """
         self.validate_angle(incident_angle, "Incident angle", 0, 90)
         self.validate_angle(surface_tilt, "Surface tilt", 0, 180)
@@ -220,8 +220,8 @@ class HeatTransferCalculations:
         
         Args:
             temp: Temperature in °C
-            area: Area in m^2
-            flow_rate: Flow rate in m^3/s
+            area: Area in m²
+            flow_rate: Flow rate in m³/s
             
         Raises:
             ValueError: If inputs are out of acceptable ranges
@@ -229,24 +229,24 @@ class HeatTransferCalculations:
         if not -50 <= temp <= 60:
             raise ValueError(f"Temperature {temp}°C is outside valid range (-50 to 60°C)")
         if area < 0:
-            raise ValueError(f"Area {area}m^2 cannot be negative")
+            raise ValueError(f"Area {area}m² cannot be negative")
         if flow_rate < 0:
-            raise ValueError(f"Flow rate {flow_rate}m^3/s cannot be negative")
+            raise ValueError(f"Flow rate {flow_rate}m³/s cannot be negative")
     
     def conduction_heat_transfer(self, u_value: float, area: float, delta_t: float) -> float:
         """
         Calculate heat transfer by conduction.
         
         Args:
-            u_value: Overall heat transfer coefficient in W/(m^2·K)
-            area: Surface area in m^2
+            u_value: Overall heat transfer coefficient in W/(m²·K)
+            area: Surface area in m²
             delta_t: Temperature difference in °C
             
         Returns:
             Heat transfer rate in W
         """
         if u_value < 0:
-            raise ValueError(f"U-value {u_value} W/(m^2·K) cannot be negative")
+            raise ValueError(f"U-value {u_value} W/(m²·K) cannot be negative")
         self.validate_inputs(delta_t, area)
         return u_value * area * delta_t
     
@@ -255,15 +255,15 @@ class HeatTransferCalculations:
         Calculate heat transfer by convection.
         
         Args:
-            h: Convective heat transfer coefficient in W/(m^2·K)
-            area: Surface area in m^2
+            h: Convective heat transfer coefficient in W/(m²·K)
+            area: Surface area in m²
             delta_t: Temperature difference in °C
             
         Returns:
             Heat transfer rate in W
         """
         if h < 0:
-            raise ValueError(f"Convective coefficient {h} W/(m^2·K) cannot be negative")
+            raise ValueError(f"Convective coefficient {h} W/(m²·K) cannot be negative")
         self.validate_inputs(delta_t, area)
         return h * area * delta_t
     
@@ -273,7 +273,7 @@ class HeatTransferCalculations:
         
         Args:
             emissivity: Surface emissivity (0-1)
-            area: Surface area in m^2
+            area: Surface area in m²
             t_surface: Surface temperature in °C
             t_surroundings: Surroundings temperature in °C
             
@@ -285,7 +285,7 @@ class HeatTransferCalculations:
         self.validate_inputs(t_surface, area)
         self.validate_inputs(t_surroundings)
         
-        sigma = 5.67e-8  # Stefan-Boltzmann constant in W/(m^2·K^4)
+        sigma = 5.67e-8  # Stefan-Boltzmann constant in W/(m²·K⁴)
         t_s = t_surface + 273.15
         t_sur = t_surroundings + 273.15
         return emissivity * sigma * area * (t_s**4 - t_sur**4)
@@ -316,14 +316,14 @@ class HeatTransferCalculations:
         Calculate sensible heat transfer due to infiltration or ventilation.
         
         Args:
-            flow_rate: Air flow rate in m^3/s
+            flow_rate: Air flow rate in m³/s
             delta_t: Temperature difference in °C
             
         Returns:
             Sensible heat transfer rate in W
         """
         self.validate_inputs(delta_t, flow_rate=flow_rate)
-        rho = 1.2  # Air density in kg/m^3
+        rho = 1.2  # Air density in kg/m³
         cp = 1005  # Specific heat of air in J/(kg·K)
         return flow_rate * rho * cp * delta_t
     
@@ -332,14 +332,14 @@ class HeatTransferCalculations:
         Calculate latent heat transfer due to infiltration or ventilation.
         
         Args:
-            flow_rate: Air flow rate in m^3/s
+            flow_rate: Air flow rate in m³/s
             delta_w: Humidity ratio difference in kg/kg
             
         Returns:
             Latent heat transfer rate in W
         """
         self.validate_inputs(0, flow_rate=flow_rate)
-        rho = 1.2  # Air density in kg/m^3
+        rho = 1.2  # Air density in kg/m³
         h_fg = 2501000  # Latent heat of vaporization in J/kg
         return flow_rate * rho * h_fg * delta_w
     
@@ -359,7 +359,7 @@ class HeatTransferCalculations:
         if not 0 <= wind_coefficient <= 1:
             raise ValueError(f"Wind coefficient {wind_coefficient} must be between 0 and 1")
         
-        rho = 1.2  # Air density in kg/m^3
+        rho = 1.2  # Air density in kg/m³
         return 0.5 * wind_coefficient * rho * wind_speed**2
     
     def stack_pressure_difference(self, height: float, indoor_temp: float, outdoor_temp: float) -> float:
@@ -379,8 +379,8 @@ class HeatTransferCalculations:
         if indoor_temp <= 0 or outdoor_temp <= 0:
             raise ValueError("Temperatures must be positive in Kelvin")
         
-        g = 9.81  # Gravitational acceleration in m/s^2
-        rho = 1.2  # Air density in kg/m^3
+        g = 9.81  # Gravitational acceleration in m/s²
+        rho = 1.2  # Air density in kg/m³
         delta_t = abs(indoor_temp - outdoor_temp)
         t_avg = (indoor_temp + outdoor_temp) / 2
         return rho * g * height * delta_t / t_avg
@@ -407,11 +407,11 @@ class HeatTransferCalculations:
         
         Args:
             crack_length: Total crack length in m
-            coefficient: Flow coefficient in m^3/(s·m·Pa^n)
+            coefficient: Flow coefficient in m³/(s·m·Pa^n)
             pressure_difference: Pressure difference in Pa
             
         Returns:
-            Infiltration flow rate in m^3/s
+            Infiltration flow rate in m³/s
         """
         if crack_length < 0:
             raise ValueError(f"Crack length {crack_length} m cannot be negative")
@@ -430,20 +430,20 @@ class HeatTransferCalculations:
         
         Args:
             outdoor_temp: Outdoor air temperature in °C
-            solar_irradiance: Solar irradiance on surface in W/m^2
+            solar_irradiance: Solar irradiance on surface in W/m²
             surface_absorptivity: Surface absorptivity (0-1)
-            surface_resistance: Surface resistance in m^2·K/W
+            surface_resistance: Surface resistance in m²·K/W
             
         Returns:
             Sol-air temperature in °C
         """
         self.validate_inputs(outdoor_temp)
         if solar_irradiance < 0:
-            raise ValueError(f"Solar irradiance {solar_irradiance} W/m^2 cannot be negative")
+            raise ValueError(f"Solar irradiance {solar_irradiance} W/m² cannot be negative")
         if not 0 <= surface_absorptivity <= 1:
             raise ValueError(f"Surface absorptivity {surface_absorptivity} must be between 0 and 1")
         if surface_resistance < 0:
-            raise ValueError(f"Surface resistance {surface_resistance} m^2·K/W cannot be negative")
+            raise ValueError(f"Surface resistance {surface_resistance} m²·K/W cannot be negative")
         
         h_ext = 1 / surface_resistance  # External convective coefficient
         delta_t_rad = surface_absorptivity * solar_irradiance / h_ext
@@ -455,8 +455,8 @@ class HeatTransferCalculations:
         Calculate solar heat gain through a surface.
         
         Args:
-            irradiance: Solar irradiance on surface in W/m^2
-            area: Surface area in m^2
+            irradiance: Solar irradiance on surface in W/m²
+            area: Surface area in m²
             shgc: Solar heat gain coefficient (0-1)
             shading_coefficient: Shading coefficient (0-1)
             
@@ -465,7 +465,7 @@ class HeatTransferCalculations:
         """
         self.validate_inputs(0, area)
         if irradiance < 0:
-            raise ValueError(f"Irradiance {irradiance} W/m^2 cannot be negative")
+            raise ValueError(f"Irradiance {irradiance} W/m² cannot be negative")
         if not 0 <= shgc <= 1:
             raise ValueError(f"SHGC {shgc} must be between 0 and 1")
         if not 0 <= shading_coefficient <= 1:
@@ -495,8 +495,8 @@ if __name__ == "__main__":
     print(f"Solar Azimuth: {azimuth:.2f}°")
     
     # Example heat transfer calculation
-    u_value = 0.5  # W/(m^2·K)
-    area = 20.0  # m^2
+    u_value = 0.5  # W/(m²·K)
+    area = 20.0  # m²
     delta_t = 10.0  # °C
     conduction = heat_transfer_calculator.conduction_heat_transfer(u_value, area, delta_t)
     print(f"Conduction Heat Transfer: {conduction:.2f} W")