From 14b2fa004795c51adb4e9fae7459e639fa08962e Mon Sep 17 00:00:00 2001
From: Filip Jorissen <filip.jorissen@gmail.com>
Date: Sat, 18 Oct 2025 11:32:45 +0200
Subject: [PATCH 1/3] added overhang shading implementation for #1467

---
 .../Components/Shading/BuildingShade.mo       |  57 ++-
 .../Components/Shading/BuildingShade.png      | Bin 19634 -> 21910 bytes
 .../Components/Shading/BuildingShade.svg      | 407 ++++++++++++++----
 3 files changed, 355 insertions(+), 109 deletions(-)

diff --git a/IDEAS/Buildings/Components/Shading/BuildingShade.mo b/IDEAS/Buildings/Components/Shading/BuildingShade.mo
index 45cb396064..b93b64bee3 100644
--- a/IDEAS/Buildings/Components/Shading/BuildingShade.mo
+++ b/IDEAS/Buildings/Components/Shading/BuildingShade.mo
@@ -7,15 +7,23 @@ model BuildingShade
   parameter Modelica.Units.SI.Length L(min=0)
     "Distance to object perpendicular to window"
     annotation (Dialog(group="Dimensions (see illustration in documentation)"));
+  parameter Modelica.Units.SI.Length LOv(min=0) = 0
+    "Overhang length perpendicular to window"
+    annotation (Dialog(group="Dimensions (see illustration in documentation)"));
   parameter Modelica.Units.SI.Length dh
     "Height difference between top of object and top of window glazing"
     annotation (Dialog(group="Dimensions (see illustration in documentation)"));
+  parameter Modelica.Units.SI.Length dhOv = 0
+    "Height difference between bottom of overhang and top of window glazing"
+    annotation (Dialog(group="Dimensions (see illustration in documentation)"));
   parameter Modelica.Units.SI.Length hWin(min=0) = 1
     "Window height: distance between top and bottom of window glazing"
     annotation (Dialog(group="Dimensions (see illustration in documentation)"));
   parameter Real fraSha(min=0,max=1) = 1
-    "Fraction of the light that is shaded, e.g. smaller than 1 for shading cast by tree lines.";
-  final parameter Real fraSunDifSky(final min=0,final max=1, final unit="1") = 1-vieAngObj/(Modelica.Constants.pi/2)
+    "Fraction of the light that is absorbed, e.g. smaller than 1 for shading cast by tree lines.";
+  parameter Real fraShaOv(min=0,max=1) = fraSha
+    "Fraction of the light that is absorbed for overhang, e.g. smaller than 1 for shading cast by screens.";
+  final parameter Real fraSunDifSky(final min=0,final max=1, final unit="1") = max(0, 1-(vieAngObj + vieAngOv)/(Modelica.Constants.pi/2))
     "Fraction of window area exposed to diffuse sun light";
 
   Real fraSunDir(final min=0,final max=1, final unit="1")
@@ -26,33 +34,42 @@ model BuildingShade
 protected
   parameter Modelica.Units.SI.Angle vieAngObj=atan((hWin/2 + dh)/L)
     "Viewing angle of opposite object";
+  parameter Modelica.Units.SI.Angle vieAngOv=Modelica.constants.pi/2 - atan((hWin/2 + dhOv)/LOv)
+    "Viewing angle of overhang";
   final parameter Modelica.Units.SI.Angle rot=0
     "Rotation angle of opposite building. Zero when parallel, positive when rotated clockwise"
     annotation (Evaluate=true);
-  final parameter Real coeff = 1-fraSha "More efficient implementation";
-  final parameter Real hWinInv = 1/hWin "More efficient implementation";
+  final parameter Real coeff = 1-fraSha 
+    "More efficient implementation";
+  final parameter Real coeffOv = 1-fraShaOv 
+    "More efficient implementation";
+  final parameter Real hWinInv = 1/hWin 
+    "More efficient implementation";
   Real tanZen = tan(min(angZen, Modelica.Constants.pi/2.01));
-  Modelica.Units.SI.Length L1
+  Modelica.Units.SI.Length L1 = max(0, L/cos(verAzi))
     "Horizontal distance to object when following vertical plane through sun ray";
-  Modelica.Units.SI.Length L2
-    "Distance to object, taking into account sun position";
-  Modelica.Units.SI.Angle alt=(Modelica.Constants.pi/2) - angZen;
-  Modelica.Units.SI.Angle verAzi
+  Modelica.Units.SI.Length L2 =  L1*tan(alt)
+    "Maximum height of object before it casts some shade";
+  Modelica.Units.SI.Length L1Ov = max(0, LOv/cos(verAzi))
+    "Horizontal distance to overhang edge when following vertical plane through sun ray";
+  Modelica.Units.SI.Length L2Ov =  L1Ov*tan(alt)
+    "Minimum vertical distance between overhang and window before overhang casts some shade";
+  Modelica.Units.SI.Angle alt=(Modelica.Constants.pi/2) - angZen
+    "Solar altitude angle";
+  Modelica.Units.SI.Angle verAzi = Modelica.Math.acos(cos(angInc)/cos(alt))
     "Angle between downward projection of sun's rays and normal to vertical surface";
-initial equation
-  assert(fraSunDifSky>=0 and fraSunDifSky<=1, "In " + getInstanceName() +
-    ": The parameter fraSunDifSky has the value " +String(fraSunDifSky) + " and 
-    should be within [0,1]. Please contact the IDEAS developers.");
-
+    
 equation
-
-  verAzi = Modelica.Math.acos(cos(angInc)/cos(alt));
-  L1 = max(0,L/cos(verAzi));
-  L2 = L1*tan(alt);
+  // the below implementation does not yet consider the case where both overhang and object
+  // cast shade at the same time
   if noEvent(L2<dh) then
     fraSunDir=coeff;
   elseif noEvent(L2<dh+hWin) then
     fraSunDir=coeff + (L2-dh)*fraSha*hWinInv;
+  elseif noEvent(L2Ov>dhOv+hWin) then
+    fraSunDir=coeffOv;
+  elseif noEvent(L2Ov>dhOv) then
+    fraSunDir=coeffOv + (L2Ov-dhOv)*fraShaOv*hWinInv;
   else
     fraSunDir=1;
   end if;
@@ -96,6 +113,10 @@ can be modelled by changing the value of parameter <code>fraSha</code> according
 </html>", revisions="<html>
 <ul>
 <li>
+October 18, 2025 by Filip Jorissen:<br/>
+Added support for shading overhangs <a href=\"https://github.com/open-ideas/IDEAS/issues/1467\">#1467</a> and updated documentation image.
+</li>
+<li>
 July 18, 2022 by Filip Jorissen:<br/>
 Refactored for <a href=\"https://github.com/open-ideas/IDEAS/issues/1270\">#1270</a> for including thermal effect of screens.
 </li>
diff --git a/IDEAS/Resources/Images/Buildings/Components/Shading/BuildingShade.png b/IDEAS/Resources/Images/Buildings/Components/Shading/BuildingShade.png
index d7a7027d3f132fbb117e8187d202dd484b53e295..913c9795132509600ab8c5befd1a08fd30d2df51 100644
GIT binary patch
literal 21910
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
DPUhk2

literal 19634
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
DMM9G{

diff --git a/IDEAS/Resources/Images/Buildings/Components/Shading/BuildingShade.svg b/IDEAS/Resources/Images/Buildings/Components/Shading/BuildingShade.svg
index 32c41607b6..fb94e03ced 100644
--- a/IDEAS/Resources/Images/Buildings/Components/Shading/BuildingShade.svg
+++ b/IDEAS/Resources/Images/Buildings/Components/Shading/BuildingShade.svg
@@ -2,107 +2,110 @@
 <!-- Created with Inkscape (http://www.inkscape.org/) -->
 
 <svg
-   xmlns:dc="http://purl.org/dc/elements/1.1/"
-   xmlns:cc="http://creativecommons.org/ns#"
-   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   width="210mm"
-   height="297mm"
-   viewBox="0 0 744.09448819 1052.3622047"
+   width="129.85315mm"
+   height="95.616356mm"
+   viewBox="0 0 460.10958 338.79811"
    id="svg2"
    version="1.1"
-   inkscape:version="0.91 r13725"
-   sodipodi:docname="BuildingShade.svg">
+   inkscape:version="1.4 (e7c3feb1, 2024-10-09)"
+   sodipodi:docname="BuildingShade.svg"
+   inkscape:export-filename="BuildingShade.png"
+   inkscape:export-xdpi="96"
+   inkscape:export-ydpi="96"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:dc="http://purl.org/dc/elements/1.1/">
   <defs
      id="defs4">
     <marker
        inkscape:isstock="true"
-       style="overflow:visible;"
+       style="overflow:visible"
        id="marker5802"
-       refX="0.0"
-       refY="0.0"
+       refX="0"
+       refY="0"
        orient="auto"
        inkscape:stockid="Arrow2Lend">
       <path
-         transform="scale(1.1) rotate(180) translate(1,0)"
-         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
-         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round;stroke:#000000;stroke-opacity:1;fill:#000000;fill-opacity:1"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
          id="path5804" />
     </marker>
     <marker
        inkscape:isstock="true"
-       style="overflow:visible;"
+       style="overflow:visible"
        id="marker5712"
-       refX="0.0"
-       refY="0.0"
+       refX="0"
+       refY="0"
        orient="auto"
        inkscape:stockid="Arrow2Lend">
       <path
-         transform="scale(1.1) rotate(180) translate(1,0)"
-         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
-         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round;stroke:#000000;stroke-opacity:1;fill:#000000;fill-opacity:1"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
          id="path5714" />
     </marker>
     <marker
        inkscape:isstock="true"
        style="overflow:visible"
        id="marker5648"
-       refX="0.0"
-       refY="0.0"
+       refX="0"
+       refY="0"
        orient="auto"
        inkscape:stockid="Arrow2Lstart">
       <path
-         transform="scale(1.1) translate(1,0)"
-         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
-         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round;stroke:#000000;stroke-opacity:1;fill:#000000;fill-opacity:1"
+         transform="matrix(1.1,0,0,1.1,1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
          id="path5650" />
     </marker>
     <marker
        inkscape:stockid="Arrow2Lend"
        orient="auto"
-       refY="0.0"
-       refX="0.0"
+       refY="0"
+       refX="0"
        id="Arrow2Lend"
-       style="overflow:visible;"
+       style="overflow:visible"
        inkscape:isstock="true"
        inkscape:collect="always">
       <path
          id="path4196"
-         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round;stroke:#000000;stroke-opacity:1;fill:#000000;fill-opacity:1"
-         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
-         transform="scale(1.1) rotate(180) translate(1,0)" />
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)" />
     </marker>
     <marker
        inkscape:stockid="Arrow2Lstart"
        orient="auto"
-       refY="0.0"
-       refX="0.0"
+       refY="0"
+       refX="0"
        id="marker4451"
        style="overflow:visible"
        inkscape:isstock="true"
        inkscape:collect="always">
       <path
          id="path4453"
-         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round;stroke:#000000;stroke-opacity:1;fill:#000000;fill-opacity:1"
-         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
-         transform="scale(1.1) translate(1,0)" />
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="matrix(1.1,0,0,1.1,1.1,0)" />
     </marker>
     <marker
        inkscape:stockid="Arrow2Lstart"
        orient="auto"
-       refY="0.0"
-       refX="0.0"
+       refY="0"
+       refX="0"
        id="Arrow2Lstart"
        style="overflow:visible"
        inkscape:isstock="true">
       <path
          id="path4193"
-         style="fill-rule:evenodd;stroke-width:0.625;stroke-linejoin:round;stroke:#000000;stroke-opacity:1;fill:#000000;fill-opacity:1"
-         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
-         transform="scale(1.1) translate(1,0)" />
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="matrix(1.1,0,0,1.1,1.1,0)" />
     </marker>
     <marker
        inkscape:stockid="Arrow2Lstart"
@@ -164,6 +167,126 @@
          style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
          id="path5804-1" />
     </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker5648-9-9"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow2Lstart">
+      <path
+         inkscape:connector-curvature="0"
+         transform="matrix(1.1,0,0,1.1,1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         id="path5650-8-1" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker5802-3-7"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow2Lend">
+      <path
+         inkscape:connector-curvature="0"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         id="path5804-1-2" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Lstart"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="marker4451-4"
+       style="overflow:visible"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         id="path4453-8"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="matrix(1.1,0,0,1.1,1.1,0)" />
+    </marker>
+    <marker
+       inkscape:stockid="Arrow2Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow2Lend-0"
+       style="overflow:visible"
+       inkscape:isstock="true"
+       inkscape:collect="always">
+      <path
+         id="path4196-4"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker5648-9-91"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow2Lstart">
+      <path
+         inkscape:connector-curvature="0"
+         transform="matrix(1.1,0,0,1.1,1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         id="path5650-8-7" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker5802-3-5"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow2Lend">
+      <path
+         inkscape:connector-curvature="0"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         id="path5804-1-5" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker5648-9-91-0"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow2Lstart">
+      <path
+         inkscape:connector-curvature="0"
+         transform="matrix(1.1,0,0,1.1,1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         id="path5650-8-7-0" />
+    </marker>
+    <marker
+       inkscape:isstock="true"
+       style="overflow:visible"
+       id="marker5802-3-5-9"
+       refX="0"
+       refY="0"
+       orient="auto"
+       inkscape:stockid="Arrow2Lend">
+      <path
+         inkscape:connector-curvature="0"
+         transform="matrix(-1.1,0,0,-1.1,-1.1,0)"
+         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
+         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
+         id="path5804-1-5-5" />
+    </marker>
   </defs>
   <sodipodi:namedview
      id="base"
@@ -172,17 +295,20 @@
      borderopacity="1.0"
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
-     inkscape:zoom="2.8"
-     inkscape:cx="213.41693"
-     inkscape:cy="758.55328"
+     inkscape:zoom="1.8639724"
+     inkscape:cx="267.70783"
+     inkscape:cy="211.10828"
      inkscape:document-units="px"
      inkscape:current-layer="layer1"
      showgrid="false"
-     inkscape:window-width="1680"
-     inkscape:window-height="953"
-     inkscape:window-x="0"
-     inkscape:window-y="0"
-     inkscape:window-maximized="1" />
+     inkscape:window-width="1616"
+     inkscape:window-height="1018"
+     inkscape:window-x="154"
+     inkscape:window-y="198"
+     inkscape:window-maximized="0"
+     inkscape:showpageshadow="2"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1" />
   <metadata
      id="metadata7">
     <rdf:RDF>
@@ -191,23 +317,23 @@
         <dc:format>image/svg+xml</dc:format>
         <dc:type
            rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
-        <dc:title></dc:title>
       </cc:Work>
     </rdf:RDF>
   </metadata>
   <g
      inkscape:label="Layer 1"
      inkscape:groupmode="layer"
-     id="layer1">
+     id="layer1"
+     transform="translate(0.40000001,-61.108939)">
     <rect
-       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.80000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.8;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        id="rect4136"
        width="27.142857"
        height="58.57143"
        x="374.99997"
        y="202.64793" />
     <rect
-       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.80000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.8;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        id="rect4136-3"
        width="27.142857"
        height="58.57143"
@@ -215,14 +341,14 @@
        y="-395.7908"
        transform="scale(1,-1)" />
     <rect
-       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.80000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.8;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        id="rect4153"
        width="2.8571429"
        height="76.428574"
        x="385.71429"
        y="260.93362" />
     <rect
-       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.80000001;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+       style="opacity:1;fill:none;fill-opacity:1;stroke:#000000;stroke-width:0.8;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
        id="rect4155"
        width="198.57143"
        height="232.85715"
@@ -230,92 +356,191 @@
        y="162.3622" />
     <text
        xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:20px;line-height:125%;font-family:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
        x="37.142857"
-       y="315.93362"
-       id="text4157"
-       sodipodi:linespacing="125%"><tspan
+       y="354.15845"
+       id="text4157"><tspan
          sodipodi:role="line"
          id="tspan4159"
          x="37.142857"
-         y="315.93362">obstruction</tspan></text>
+         y="354.15845"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">obstruction</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       x="302.3934"
+       y="159.19032"
+       id="text4157-6"><tspan
+         sodipodi:role="line"
+         id="tspan4159-5"
+         x="302.3934"
+         y="159.19032"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">overhang</tspan></text>
     <flowRoot
        xml:space="preserve"
        id="flowRoot4161"
-       style="fill:black;stroke:none;stroke-opacity:1;stroke-width:1px;stroke-linejoin:miter;stroke-linecap:butt;fill-opacity:1;font-family:Sans;font-style:normal;font-weight:normal;font-size:20px;line-height:125%;letter-spacing:0px;word-spacing:0px"><flowRegion
-         id="flowRegion4163"><rect
+       style="font-style:normal;font-weight:normal;line-height:0.01%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"><flowRegion
+         id="flowRegion4163"
+         style="font-family:sans-serif"><rect
            id="rect4165"
            width="24.285715"
            height="37.142857"
            x="110"
            y="240.21935" /></flowRegion><flowPara
-         id="flowPara4167"></flowPara></flowRoot>    <text
+         id="flowPara4167"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif"> </flowPara></flowRoot>
+    <text
        xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:20px;line-height:125%;font-family:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
        x="282.14285"
        y="371.64792"
-       id="text4529"
-       sodipodi:linespacing="125%"><tspan
+       id="text4529"><tspan
          sodipodi:role="line"
          id="tspan4531"
          x="282.14285"
-         y="371.64792">L</tspan></text>
+         y="371.64792"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">L</tspan></text>
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.99620253px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker4451);marker-end:url(#Arrow2Lend)"
-       d="m 200.15697,387.90215 173.74786,0.17384 0,0 0,0"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.65624999;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker4451);marker-end:url(#Arrow2Lend);stroke-dasharray:none"
+       d="m 200.13804,387.90423 183.52874,0.16992 v 0 0"
        id="path4665"
        inkscape:connector-curvature="0" />
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.99127853px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker5648);marker-end:url(#marker5802)"
-       d="m 398.92653,262.36947 0.36122,73.5569"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.65624999;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker4451-4);marker-end:url(#Arrow2Lend-0);stroke-dasharray:none"
+       d="m 293.26905,194.15751 90.96793,0.22182 v 0 0"
+       id="path4665-6"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.65624999;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker5648);marker-end:url(#marker5802);stroke-dasharray:none"
+       d="m 397.05153,262.36947 0.36122,73.5569"
        id="path5776"
        inkscape:connector-curvature="0" />
     <text
        xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:20px;line-height:125%;font-family:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
        x="403.50098"
        y="306.08081"
-       id="text4529-1"
-       sodipodi:linespacing="125%"><tspan
+       id="text4529-1"><tspan
          sodipodi:role="line"
          id="tspan4531-7"
          x="403.50098"
-         y="306.08081">hWin</tspan></text>
+         y="306.08081"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">hWin</tspan></text>
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:1,1;stroke-dashoffset:0"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.28125;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:1.6875,1.6875;stroke-dashoffset:0;stroke-opacity:1"
        d="m 402.14286,261.29077 -221.07143,0.35715"
        id="path6010"
        inkscape:connector-curvature="0" />
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1.06448936px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker5648-9);marker-end:url(#marker5802-3)"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.290628;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:1.74377, 1.74377;stroke-dashoffset:0;stroke-opacity:1"
+       d="m 384.71372,303.59983 -236.16043,0.35699"
+       id="path6010-7"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.28125;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:1.68750604,1.68750604;stroke-dashoffset:0;stroke-opacity:1"
+       d="m 384.6243,275.83184 -92.81563,0.35865"
+       id="path6010-7-1"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.65624999;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker5648-9);marker-end:url(#marker5802-3);stroke-dasharray:none"
        d="m 186.62298,164.75922 0.32548,94.13454"
        id="path5776-7"
        inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.65624999;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker5648-9-91);marker-end:url(#marker5802-3-5);stroke-dasharray:none"
+       d="m 151.68822,163.52579 0.27602,137.3308"
+       id="path5776-7-4"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.74999999;stroke-linecap:butt;stroke-linejoin:miter;stroke-dasharray:none;stroke-opacity:1;marker-start:url(#marker5648-9-91-0);marker-end:url(#marker5802-3-5-9)"
+       d="m 291.8502,205.41313 0.34324,69.05253"
+       id="path5776-7-4-6"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:0.867316px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#marker5648-9-9);marker-end:url(#marker5802-3-7)"
+       d="m 396.8167,204.82325 0.37088,54.84256"
+       id="path5776-7-3"
+       inkscape:connector-curvature="0" />
     <text
        xml:space="preserve"
-       style="font-style:normal;font-weight:normal;font-size:20px;line-height:125%;font-family:Sans;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
-       x="154.10017"
-       y="218.53128"
-       id="text4529-1-8"
-       sodipodi:linespacing="125%"><tspan
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       x="162.14751"
+       y="219.03424"
+       id="text4529-1-8"><tspan
          sodipodi:role="line"
          id="tspan4531-7-9"
-         x="154.10017"
-         y="218.53128">dH</tspan></text>
+         x="162.14751"
+         y="219.03424"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">dh</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       x="126.12115"
+       y="286.1322"
+       id="text4529-1-8-5"><tspan
+         sodipodi:role="line"
+         id="tspan4531-7-9-2"
+         x="126.12115"
+         y="286.1322"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">L2</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       x="236.87024"
+       y="257.0788"
+       id="text4529-1-8-5-4"><tspan
+         sodipodi:role="line"
+         id="tspan4531-7-9-2-0"
+         x="236.87024"
+         y="257.0788"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">L2Ov</tspan></text>
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1.14797795;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:6.8878674, 1.1479779;stroke-dashoffset:0;stroke-opacity:1"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1.14798;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:6.88787, 1.14798;stroke-dashoffset:0;stroke-opacity:1"
        d="M 384.59788,303.01705 C 106.1164,89.564503 106.1164,89.564503 106.1164,89.564503"
        id="path6413"
        inkscape:connector-curvature="0" />
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1.14797795;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:6.8878674, 1.1479779;stroke-dashoffset:0;stroke-opacity:1"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1.14798;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:6.88787, 1.14798;stroke-dashoffset:0;stroke-opacity:1"
        d="M 384.59788,275.01705 C 106.1164,61.5645 106.1164,61.5645 106.1164,61.5645"
        id="path6413-9"
        inkscape:connector-curvature="0" />
     <path
-       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:6,1;stroke-dashoffset:0"
+       style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:6, 1;stroke-dashoffset:0;stroke-opacity:1"
        d="M 164.64286,162.00506 106.07143,117.3622"
        id="path6445"
        inkscape:connector-curvature="0" />
+    <rect
+       style="fill:none;stroke:#000000;stroke-width:0.793652;stroke-dasharray:none"
+       id="rect1"
+       width="111.66506"
+       height="78.433495"
+       x="290.50946"
+       y="124.19329" />
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       x="405.23694"
+       y="232.6953"
+       id="text4529-1-8-1"><tspan
+         sodipodi:role="line"
+         id="tspan4531-7-9-4"
+         x="405.23694"
+         y="232.6953"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">dhOv</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-style:normal;font-weight:normal;line-height:0%;font-family:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       x="328.96344"
+       y="190.26128"
+       id="text4529-0"><tspan
+         sodipodi:role="line"
+         id="tspan4531-3"
+         x="328.96344"
+         y="190.26128"
+         style="font-size:20px;line-height:1.25;font-family:sans-serif">LOv</tspan></text>
+    <path
+       style="fill:none;stroke:#000000;stroke-width:0.28125;stroke-dasharray:1.6875, 1.6875;stroke-dashoffset:0"
+       d="m 385.7598,399.90704 c 0,-214.645 0,-214.645 0,-214.645"
+       id="path1" />
   </g>
 </svg>

From cf888f5f6e014cd0894d88d260898de4c3748b29 Mon Sep 17 00:00:00 2001
From: Filip Jorissen <filip.jorissen@gmail.com>
Date: Sat, 18 Oct 2025 11:39:44 +0200
Subject: [PATCH 2/3] avoiding division by zero for #1467

---
 .../Components/Shading/BuildingShade.mo       | 34 +++++++++++++------
 1 file changed, 24 insertions(+), 10 deletions(-)

diff --git a/IDEAS/Buildings/Components/Shading/BuildingShade.mo b/IDEAS/Buildings/Components/Shading/BuildingShade.mo
index b93b64bee3..9edf76e2ae 100644
--- a/IDEAS/Buildings/Components/Shading/BuildingShade.mo
+++ b/IDEAS/Buildings/Components/Shading/BuildingShade.mo
@@ -32,9 +32,11 @@ model BuildingShade
   // Computation assumes that window base is at ground level.
   // Viewing angle computed from center of glazing.
 protected
+  final parameter Boolean haveOverhang = LOv > Modelica.Constants.small 
+    "To avoid divisions by zero and obsolete computations";
   parameter Modelica.Units.SI.Angle vieAngObj=atan((hWin/2 + dh)/L)
     "Viewing angle of opposite object";
-  parameter Modelica.Units.SI.Angle vieAngOv=Modelica.constants.pi/2 - atan((hWin/2 + dhOv)/LOv)
+  parameter Modelica.Units.SI.Angle vieAngOv=if haveOverhang then Modelica.Constants.pi/2 - atan((hWin/2 + dhOv)/LOv) else 0
     "Viewing angle of overhang";
   final parameter Modelica.Units.SI.Angle rot=0
     "Rotation angle of opposite building. Zero when parallel, positive when rotated clockwise"
@@ -62,16 +64,28 @@ protected
 equation
   // the below implementation does not yet consider the case where both overhang and object
   // cast shade at the same time
-  if noEvent(L2<dh) then
-    fraSunDir=coeff;
-  elseif noEvent(L2<dh+hWin) then
-    fraSunDir=coeff + (L2-dh)*fraSha*hWinInv;
-  elseif noEvent(L2Ov>dhOv+hWin) then
-    fraSunDir=coeffOv;
-  elseif noEvent(L2Ov>dhOv) then
-    fraSunDir=coeffOv + (L2Ov-dhOv)*fraShaOv*hWinInv;
+  
+  if haveOverhang then
+    if noEvent(L2<dh) then
+      fraSunDir=coeff;
+    elseif noEvent(L2<dh+hWin) then
+      fraSunDir=coeff + (L2-dh)*fraSha*hWinInv;
+    elseif noEvent(L2Ov>dhOv+hWin) then
+      fraSunDir=coeffOv;
+    elseif noEvent(L2Ov>dhOv) then
+      fraSunDir=coeffOv + (L2Ov-dhOv)*fraShaOv*hWinInv;
+    else
+      fraSunDir=1;
+    end if;
   else
-    fraSunDir=1;
+    if noEvent(L2<dh) then
+      fraSunDir=coeff;
+    elseif noEvent(L2<dh+hWin) then
+      fraSunDir=coeff + (L2-dh)*fraSha*hWinInv;
+    else
+      fraSunDir=1;
+  end if;
+
   end if;
 
   HShaDirTil=fraSunDir*HDirTil;

From e5bf2351b3b089fc30e6995fd5b6507c63af51ba Mon Sep 17 00:00:00 2001
From: Filip Jorissen <filip.jorissen@gmail.com>
Date: Sun, 19 Oct 2025 21:59:55 +0200
Subject: [PATCH 3/3] overhang support in outerwalls for #1467

---
 IDEAS/Buildings/Components/OuterWall.mo | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/IDEAS/Buildings/Components/OuterWall.mo b/IDEAS/Buildings/Components/OuterWall.mo
index 14ce522652..aacb91fed9 100644
--- a/IDEAS/Buildings/Components/OuterWall.mo
+++ b/IDEAS/Buildings/Components/OuterWall.mo
@@ -21,6 +21,12 @@ model OuterWall "Opaque building envelope construction"
   parameter Modelica.Units.SI.Length dh(min=-hWal) = 0
     "Height difference between top of object and top of wall"
     annotation (Dialog(group="Building shade", enable=hasBuildingShade));
+  parameter Modelica.Units.SI.Length LOv(min=0) = 0
+    "Distance between overhang edge and wall, perpendicular to wall"
+    annotation (Dialog(group="Building shade", enable=hasBuildingShade));
+  parameter Modelica.Units.SI.Length dhOv(min=-hWal) = 0
+    "Height difference between bottom of overhang and top of wall"
+    annotation (Dialog(group="Building shade", enable=hasBuildingShade));
   parameter Modelica.Units.SI.Length hWal(min=0) = 0 "Wall height"
     annotation (Dialog(group="Building shade", enable=hasBuildingShade));
   final parameter Real U_value=1/(1/8 + sum(constructionType.mats.R) + 1/25)
@@ -52,6 +58,8 @@ model OuterWall "Opaque building envelope construction"
     final haveBoundaryPorts=false,
     final L=L,
     final dh=dh,
+    final LOv=LOv,
+    final dhOv=dhOv,
     final hWin=hWal) if hasBuildingShade
   constrainedby IDEAS.Buildings.Components.Shading.Interfaces.PartialShading(
     final azi=aziInt)
@@ -304,6 +312,10 @@ The correct shading parameter values should then be passed through the redeclara
 </html>", revisions="<html>
 <ul>
 <li>
+October 19, 2025 by Filip Jorissen:<br/>
+Added support for shading overhangs <a href=\"https://github.com/open-ideas/IDEAS/issues/1467\">#1467</a>.
+</li>
+<li>
 August 18, 2025, by Klaas De Jonge:<br/>
 Changed inc to incInt where nececarry.
 </li>
@@ -386,4 +398,4 @@ Adjusted implementation for grouping of solar calculations.
 </li>
 </ul>
 </html>"));
-end OuterWall;
\ No newline at end of file
+end OuterWall;