Upload heat_transfer.py

utils/heat_transfer.py

@@ -475,8 +475,8 @@ class HeatTransferCalculations:
         return q
 
     def infiltration_latent_heat_transfer(self, flow_rate: Union[float, np.ndarray], delta_w: Union[float, np.ndarray],
-                                        t_db: Union[float, np.ndarray], # Temp for density/hfg calc
-                                        p_atm: Union[float, np.ndarray] = ATMOSPHERIC_PRESSURE) -> Union[float, np.ndarray]:
+                                         t_db: Union[float, np.ndarray], rh: Union[float, np.ndarray] = 40.0,
+                                         p_atm: Union[float, np.ndarray] = ATMOSPHERIC_PRESSURE) -> Union[float, np.ndarray]:
         """
         Calculate latent heat transfer due to infiltration or ventilation.
         Reference: ASHRAE Handbook—Fundamentals (2017), Chapter 18, Equation 18.6.
@@ -484,25 +484,33 @@ class HeatTransferCalculations:
             flow_rate: Air flow rate(s) in m³/s
             delta_w: Humidity ratio difference(s) in kg/kg
             t_db: Dry-bulb temperature(s) for air properties in °C
-            p_atm: Atmospheric pressure(s) in Pa
+            rh: Relative humidity(ies) in % (0-100), default 40%
+            p_atm: Atmospheric pressure(s) in Pa, default 101325 Pa
         Returns:
             Latent heat transfer rate(s) in W
         """
-        is_array = any(isinstance(arg, np.ndarray) for arg in [flow_rate, delta_w, t_db, p_atm])
+        is_array = any(isinstance(arg, np.ndarray) for arg in [flow_rate, delta_w, t_db, rh, p_atm])
         if is_array:
             flow_rate = np.asarray(flow_rate)
             delta_w = np.asarray(delta_w)
             t_db = np.asarray(t_db)
+            rh = np.asarray(rh)
             p_atm = np.asarray(p_atm)
             if np.any(flow_rate < 0):
-                 raise ValueError("Flow rate cannot be negative")
+                raise ValueError("Flow rate cannot be negative")
+            if np.any(rh < 0) or np.any(rh > 100):
+                raise ValueError("Relative humidity must be between 0 and 100%")
             # Delta_w can be negative (humidification)
-        elif flow_rate < 0:
-            raise ValueError("Flow rate cannot be negative")
+        else:
+            if flow_rate < 0:
+                raise ValueError("Flow rate cannot be negative")
+            if not 0 <= rh <= 100:
+                raise ValueError("Relative humidity must be between 0 and 100%")
 
         # Calculate air density and latent heat
-        rho = self.psychrometrics.density(t_db, w=0.008, p_atm=p_atm) # Approximate density
-        h_fg = self.psychrometrics.latent_heat_of_vaporization(t_db) # J/kg
+        w = self.psychrometrics.humidity_ratio(t_db, rh, p_atm)  # Calculate humidity ratio from rh
+        rho = self.psychrometrics.density(t_db, w, p_atm)  # Use actual humidity ratio for density
+        h_fg = self.psychrometrics.latent_heat_of_vaporization(t_db)  # J/kg
 
         q = flow_rate * rho * h_fg * delta_w
         return q
@@ -601,7 +609,7 @@ if __name__ == "__main__":
 
     # Example infiltration calculation (Latent)
     delta_w_inf = 0.002 # kg/kg
-    q_inf_lat = heat_transfer.infiltration_latent_heat_transfer(flow_rate, delta_w_inf, t_db_inf)
+    q_inf_lat = heat_transfer.infiltration_latent_heat_transfer(flow_rate, delta_w_inf, t_db_inf, rh_inf)
     logger.info(f"Infiltration latent heat transfer: {q_inf_lat:.2f} W")
 
     # Example Solar Calculation