From 306030d0287aa78408d98c1bc89ef4032630c6aa Mon Sep 17 00:00:00 2001
From: Pilar <pilar_monsalvete@yahoo.es>
Date: Mon, 28 Nov 2022 15:26:31 -0500
Subject: [PATCH] added soil layer to ground surfaces

---
 .../building_demand/thermal_boundary.py       |  2 +-
 config/configuration.ini                      |  5 +++++
 helpers/configuration_helper.py               | 20 +++++++++++++++++--
 3 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/city_model_structure/building_demand/thermal_boundary.py b/city_model_structure/building_demand/thermal_boundary.py
index 70998758..2e4b4b72 100644
--- a/city_model_structure/building_demand/thermal_boundary.py
+++ b/city_model_structure/building_demand/thermal_boundary.py
@@ -215,7 +215,7 @@ class ThermalBoundary:
       h_i = self.hi
       h_e = self.he
       if self.type == cte.GROUND:
-        r_value = 1.0 / h_i
+        r_value = 1.0 / h_i + ch().soil_thickness / ch().soil_conductivity
       else:
         r_value = 1.0/h_i + 1.0/h_e
       try:
diff --git a/config/configuration.ini b/config/configuration.ini
index 399649f1..58bf8d87 100644
--- a/config/configuration.ini
+++ b/config/configuration.ini
@@ -11,5 +11,10 @@ comnet_occupancy_sensible_radiant = 0.1
 comnet_plugs_latent = 0
 comnet_plugs_convective = 0.75
 comnet_plugs_radiant = 0.25
+#W/m2K
 convective_heat_transfer_coefficient_interior = 3.5
 convective_heat_transfer_coefficient_exterior = 20
+#W/mK
+soil_conductivity = 3
+#m
+soil_thickness = 0.5
\ No newline at end of file
diff --git a/helpers/configuration_helper.py b/helpers/configuration_helper.py
index d6aca652..88cc5671 100644
--- a/helpers/configuration_helper.py
+++ b/helpers/configuration_helper.py
@@ -111,7 +111,7 @@ class ConfigurationHelper:
   def convective_heat_transfer_coefficient_interior(self) -> float:
     """
     Get configured convective heat transfer coefficient for surfaces inside the building
-    :return: 3.5
+    :return: 3.5 W/m2K
     """
     return self._config.getfloat('buildings', 'convective_heat_transfer_coefficient_interior').real
 
@@ -119,6 +119,22 @@ class ConfigurationHelper:
   def convective_heat_transfer_coefficient_exterior(self) -> float:
     """
     Get configured convective heat transfer coefficient for surfaces outside the building
-    :return: 20
+    :return: 20 W/m2K
     """
     return self._config.getfloat('buildings', 'convective_heat_transfer_coefficient_exterior').real
+
+  @property
+  def soil_conductivity(self) -> float:
+    """
+    Get configured soil conductivity for surfaces touching the ground
+    :return: 3 W/mK
+    """
+    return self._config.getfloat('buildings', 'soil_conductivity').real
+
+  @property
+  def soil_thickness(self) -> float:
+    """
+    Get configured soil thickness for surfaces touching the ground
+    :return: 0.5
+    """
+    return self._config.getfloat('buildings', 'soil_thickness').real