L200 up to 6.2.1.6

schematron/v2.2.0/exemplary_files/L200_Audit.xml

@@ -93,6 +93,10 @@
                 </auc:FloorArea>
               </auc:FloorAreas>
 
+              <auc:TotalExteriorAboveGradeWallArea>123</auc:TotalExteriorAboveGradeWallArea>
+              <auc:TotalExteriorBelowGradeWallArea>123</auc:TotalExteriorBelowGradeWallArea>
+              <auc:OverallWindowToWallRatio>0.2</auc:OverallWindowToWallRatio>
+
               <!-- 6.1.1.1.i -->
               <auc:YearOfConstruction>1993</auc:YearOfConstruction>
               <!-- 6.1.1.1.l (recommended) -->
@@ -148,6 +152,41 @@
 
                 <auc:Section>
                   <auc:SectionType>Whole building</auc:SectionType>
+                  <auc:FootprintShape>Rectangular</auc:FootprintShape>
+                  <auc:Sides>
+                    <auc:Side>
+                      <auc:SideNumber>A1</auc:SideNumber>
+                      <auc:WallIDs>
+                        <auc:WallID IDref="Wall-A">
+                          <auc:WallArea>123</auc:WallArea>
+                        </auc:WallID>
+                      </auc:WallIDs>
+                    </auc:Side>
+                    <auc:Side>
+                      <auc:SideNumber>B1</auc:SideNumber>
+                      <auc:WallIDs>
+                        <auc:WallID IDref="Wall-A">
+                          <auc:WallArea>123</auc:WallArea>
+                        </auc:WallID>
+                      </auc:WallIDs>
+                    </auc:Side>
+                    <auc:Side>
+                      <auc:SideNumber>C1</auc:SideNumber>
+                      <auc:WallIDs>
+                        <auc:WallID IDref="Wall-A">
+                          <auc:WallArea>123</auc:WallArea>
+                        </auc:WallID>
+                      </auc:WallIDs>
+                    </auc:Side>
+                    <auc:Side>
+                      <auc:SideNumber>D1</auc:SideNumber>
+                      <auc:WallIDs>
+                        <auc:WallID IDref="Wall-A">
+                          <auc:WallArea>123</auc:WallArea>
+                        </auc:WallID>
+                      </auc:WallIDs>
+                    </auc:Side>
+                  </auc:Sides>
                   <auc:Roofs>
                     <auc:Roof>
                       <auc:RoofID IDref="Roof-A">
@@ -196,6 +235,13 @@
           </auc:LightingSystem>
         </auc:LightingSystems>
 
+        <auc:WallSystems>
+          <auc:WallSystem ID="Wall-A">
+            <auc:ExteriorWallConstruction>Concrete poured</auc:ExteriorWallConstruction>
+            <auc:WallRValue>1</auc:WallRValue>
+          </auc:WallSystem>
+        </auc:WallSystems>
+
         <auc:RoofSystems>
           <auc:RoofSystem ID="Roof-A">
             <auc:RoofConstruction>Wood frame</auc:RoofConstruction>

schematron/v2.2.0/tests/test_v2-2-0_L200_Audit.py

@@ -1,10 +1,51 @@
 import os
 
+from lxml import etree
+import pytest
 
-from tools.constants import BSYNC_NSMAP
+from tools.constants import BSYNC_NSMAP, BSYNC_NS
 from tools.validate_sch import validate_schematron
 
-from schematron.conftest import AssertFailureRolesMixin, v2_2_0_SCH_DIR, exemplary_tree
+from schematron.conftest import AssertFailureRolesMixin, v2_2_0_SCH_DIR, exemplary_tree, replace_element, remove_element
+
+
+def qname(tag):
+    return etree.QName(BSYNC_NS, tag)
+
+
+sides_by_footprint = {
+    'Rectangular': ['A1', 'B1', 'C1', 'D1'],
+    'L-Shape': ['A1', 'B1', 'A2', 'B2', 'C1', 'D1'],
+    'U-Shape': ['A1', 'B1', 'A2', 'D1', 'A3', 'B2', 'C1', 'D2'],
+    'T-Shape': ['A1', 'B1', 'C1', 'B2', 'C2', 'D1', 'C3', 'D2'],
+    'H-Shape': ['A1', 'B1', 'A2', 'D1', 'A3', 'B2', 'C1', 'D2', 'C2', 'B3', 'C3', 'D3'],
+    'O-Shape': ['A1', 'B1', 'C1', 'D1', 'A2', 'B2', 'C2', 'D2'],
+}
+
+
+def _sides_factory(footprint_shape, wall_id='Wall-A'):
+    """
+    Returns an auc:Sides element containing valid auc:Sides all pointing to the same auc:WallSystem ID
+    """
+
+    side_names = sides_by_footprint.get(footprint_shape)
+    if side_names is None:
+        raise Exception(f'Invalid footprint shape: "{footprint_shape}"')
+
+    sides_elem = etree.Element(qname('Sides'), nsmap=BSYNC_NSMAP)
+    for side_name in side_names:
+        side_elem = etree.SubElement(sides_elem, qname('Side'), nsmap=BSYNC_NSMAP)
+
+        side_num_elem = etree.SubElement(side_elem, qname('SideNumber'), nsmap=BSYNC_NSMAP)
+        side_num_elem.text = side_name
+
+        wall_ids_elem = etree.SubElement(side_elem, qname('WallIDs'), nsmap=BSYNC_NSMAP)
+        wall_id_elem = etree.SubElement(wall_ids_elem, qname('WallID'), nsmap=BSYNC_NSMAP, IDref=wall_id)
+
+        wall_area_elem = etree.SubElement(wall_id_elem, qname('WallArea'), nsmap=BSYNC_NSMAP)
+        wall_area_elem.text = '123'
+
+    return sides_elem
 
 
 class TestL200Audit(AssertFailureRolesMixin):
@@ -55,3 +96,42 @@ def test_runs_generation_storage_systems_tests_when_they_exist(self):
 
         # -- Assert
         self.assert_failure_messages(failures, {})
+
+    @pytest.mark.parametrize("footprint_shape", [
+        ("Rectangular"),
+        ("L-Shape"),
+        ("U-Shape"),
+        ("T-Shape"),
+        ("H-Shape"),
+        ("O-Shape")])
+    def test_footprint_shape_and_number_of_sides_tests_work_as_expected(self, footprint_shape):
+        # -- Setup
+        tree = exemplary_tree('L200_Audit', 'v2.2.0')
+
+        # replace auc:FootprintShape and auc:Sides
+        section_elem = tree.xpath('//auc:Building/auc:Sections/auc:Section[auc:SectionType = "Whole building"]', namespaces=BSYNC_NSMAP)
+        assert len(section_elem) == 1
+        section_elem = section_elem[0]
+
+        footprint_elem = section_elem.xpath('auc:FootprintShape', namespaces=BSYNC_NSMAP)
+        assert len(footprint_elem) == 1
+        footprint_elem = footprint_elem[0]
+        footprint_elem.text = footprint_shape
+
+        replace_element(section_elem, 'auc:Sides', _sides_factory(footprint_shape))
+
+        # make sure it's valid with substituted elements
+        failures = validate_schematron(self.schematron, tree)
+        self.assert_failure_messages(failures, {})
+
+        # remove an auc:Side to make it invalid
+        remove_element(section_elem, 'auc:Sides/auc:Side[1]')
+
+        # -- Act
+        failures = validate_schematron(self.schematron, tree)
+
+        # -- Assert
+        expected_sides = len(sides_by_footprint[footprint_shape])
+        self.assert_failure_messages(failures, {
+            'ERROR': [f'Incorrect number of auc:Side elements for footprint shape "{footprint_shape}" (found {expected_sides - 1})']
+        })

schematron/v2.2.0/v2-2-0_L200_Audit.csv

@@ -61,4 +61,21 @@
 "","","","","","","","","","auc:RoofRValue or auc:RoofUFactor","","",""
 "","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType = ""Whole building""]/auc:Roofs/auc:Roof","true","","","//auc:RoofSystem[@ID = current()/auc:RoofID/@IDref]","Every auc:RoofID within auc:SectionType of ""Whole building"" must link to a valid auc:RoofSystem's ID","",""
 "","","","","","","","","","auc:RoofID/auc:RoofArea","","",""
-"","","","","","","","","","auc:RoofID/auc:RoofCondition","","",""
+"","","","","","","","","","auc:RoofID/auc:RoofCondition","","",""
+"","","Walls - General Requirements","ASHRAE 211 6.2.1.2 (b)","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building","true","","","auc:TotalExteriorAboveGradeWallArea","","",""
+"","","","","","","","","","auc:TotalExteriorBelowGradeWallArea","","",""
+"","","","","","","","","","auc:OverallWindowToWallRatio","","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Systems/auc:WallSystems/auc:WallSystem","true","","","auc:ExteriorWallConstruction","","",""
+"","","","","","","","","","auc:WallRValue or auc:WallUFactor","","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building""]","true","","","auc:FootprintShape","","",""
+"","","Walls - Building Sides","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'Other']","false","","","auc:NumberOfSides","Must provide auc:NumberOfSides if auc:FootprintShape is Other","",""
+"","","","","","","","","","auc:NumberOfSides = count(auc:Sides/auc:Side)","","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'Rectangular']","false","","","count(auc:Sides/auc:Side) = 4","Incorrect number of auc:Side elements for footprint shape ""Rectangular"" (found <value-of select=""count(auc:Sides/auc:Side)""/>)","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'L-Shape']","false","","","count(auc:Sides/auc:Side) = 6","Incorrect number of auc:Side elements for footprint shape ""L-Shape"" (found <value-of select=""count(auc:Sides/auc:Side)""/>)","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'U-Shape']","false","","","count(auc:Sides/auc:Side) = 8","Incorrect number of auc:Side elements for footprint shape ""U-Shape"" (found <value-of select=""count(auc:Sides/auc:Side)""/>)","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'T-Shape']","false","","","count(auc:Sides/auc:Side) = 8","Incorrect number of auc:Side elements for footprint shape ""T-Shape"" (found <value-of select=""count(auc:Sides/auc:Side)""/>)","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'H-Shape']","false","","","count(auc:Sides/auc:Side) = 12","Incorrect number of auc:Side elements for footprint shape ""H-Shape"" (found <value-of select=""count(auc:Sides/auc:Side)""/>)","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building"" and auc:FootprintShape/text() = 'O-Shape']","false","","","count(auc:Sides/auc:Side) = 8","Incorrect number of auc:Side elements for footprint shape ""O-Shape"" (found <value-of select=""count(auc:Sides/auc:Side)""/>)","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building""]/auc:Sides/auc:Side","true","","","auc:WallIDs","","",""
+"","","","","","/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = ""Whole building""]/auc:Sides/auc:Side/auc:WallIDs/auc:WallID","true","","","//auc:WallSystem[@ID = current()/@IDref]","auc:WallID in auc:Side should link to an auc:WallSystem's ID","",""
+"","","","","","","","","","auc:WallArea","","",""

schematron/v2.2.0/v2-2-0_L200_Audit.sch

@@ -21,6 +21,10 @@
   <sch:phase id="building_envelope" see="ASHRAE 211 6.2.1.2">
     <sch:active pattern="document_structure_prerequisites_roof"/>
     <sch:active pattern="roof"/>
+    <sch:active pattern="document_structure_prerequisites_walls_-_general_requirements"/>
+    <sch:active pattern="walls_-_general_requirements"/>
+    <sch:active pattern="document_structure_prerequisites_walls_-_building_sides"/>
+    <sch:active pattern="walls_-_building_sides"/>
   </sch:phase>
   <sch:pattern see="" id="document_structure_prerequisites_misc_building_info">
     <sch:title>Document Structure Prerequisites Misc Building Info</sch:title>
@@ -173,4 +177,66 @@
       <sch:assert test="auc:RoofID/auc:RoofCondition" role="">auc:RoofID/auc:RoofCondition</sch:assert>
     </sch:rule>
   </sch:pattern>
+  <sch:pattern see="" id="document_structure_prerequisites_walls_-_general_requirements">
+    <sch:title>Document Structure Prerequisites Walls - General Requirements</sch:title>
+    <sch:rule context="/">
+      <sch:assert test="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building" role="ERROR">/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building</sch:assert>
+      <sch:assert test="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Systems/auc:WallSystems/auc:WallSystem" role="ERROR">/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Systems/auc:WallSystems/auc:WallSystem</sch:assert>
+      <sch:assert test="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot;]" role="ERROR">/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = "Whole building"]</sch:assert>
+    </sch:rule>
+  </sch:pattern>
+  <sch:pattern see="ASHRAE 211 6.2.1.2 (b)" id="walls_-_general_requirements">
+    <sch:title>Walls - General Requirements</sch:title>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building">
+      <sch:assert test="auc:TotalExteriorAboveGradeWallArea" role="">auc:TotalExteriorAboveGradeWallArea</sch:assert>
+      <sch:assert test="auc:TotalExteriorBelowGradeWallArea" role="">auc:TotalExteriorBelowGradeWallArea</sch:assert>
+      <sch:assert test="auc:OverallWindowToWallRatio" role="">auc:OverallWindowToWallRatio</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Systems/auc:WallSystems/auc:WallSystem">
+      <sch:assert test="auc:ExteriorWallConstruction" role="">auc:ExteriorWallConstruction</sch:assert>
+      <sch:assert test="auc:WallRValue or auc:WallUFactor" role="">auc:WallRValue or auc:WallUFactor</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot;]">
+      <sch:assert test="auc:FootprintShape" role="">auc:FootprintShape</sch:assert>
+    </sch:rule>
+  </sch:pattern>
+  <sch:pattern see="" id="document_structure_prerequisites_walls_-_building_sides">
+    <sch:title>Document Structure Prerequisites Walls - Building Sides</sch:title>
+    <sch:rule context="/">
+      <sch:assert test="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot;]/auc:Sides/auc:Side" role="ERROR">/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = "Whole building"]/auc:Sides/auc:Side</sch:assert>
+      <sch:assert test="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot;]/auc:Sides/auc:Side/auc:WallIDs/auc:WallID" role="ERROR">/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = "Whole building"]/auc:Sides/auc:Side/auc:WallIDs/auc:WallID</sch:assert>
+    </sch:rule>
+  </sch:pattern>
+  <sch:pattern see="" id="walls_-_building_sides">
+    <sch:title>Walls - Building Sides</sch:title>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'Other']">
+      <sch:assert test="auc:NumberOfSides" role="">Must provide auc:NumberOfSides if auc:FootprintShape is Other</sch:assert>
+      <sch:assert test="auc:NumberOfSides = count(auc:Sides/auc:Side)" role="">auc:NumberOfSides = count(auc:Sides/auc:Side)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'Rectangular']">
+      <sch:assert test="count(auc:Sides/auc:Side) = 4" role="">Incorrect number of auc:Side elements for footprint shape "Rectangular" (found <sch:value-of select="count(auc:Sides/auc:Side)"/>)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'L-Shape']">
+      <sch:assert test="count(auc:Sides/auc:Side) = 6" role="">Incorrect number of auc:Side elements for footprint shape "L-Shape" (found <sch:value-of select="count(auc:Sides/auc:Side)"/>)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'U-Shape']">
+      <sch:assert test="count(auc:Sides/auc:Side) = 8" role="">Incorrect number of auc:Side elements for footprint shape "U-Shape" (found <sch:value-of select="count(auc:Sides/auc:Side)"/>)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'T-Shape']">
+      <sch:assert test="count(auc:Sides/auc:Side) = 8" role="">Incorrect number of auc:Side elements for footprint shape "T-Shape" (found <sch:value-of select="count(auc:Sides/auc:Side)"/>)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'H-Shape']">
+      <sch:assert test="count(auc:Sides/auc:Side) = 12" role="">Incorrect number of auc:Side elements for footprint shape "H-Shape" (found <sch:value-of select="count(auc:Sides/auc:Side)"/>)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot; and auc:FootprintShape/text() = 'O-Shape']">
+      <sch:assert test="count(auc:Sides/auc:Side) = 8" role="">Incorrect number of auc:Side elements for footprint shape "O-Shape" (found <sch:value-of select="count(auc:Sides/auc:Side)"/>)</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot;]/auc:Sides/auc:Side">
+      <sch:assert test="auc:WallIDs" role="">auc:WallIDs</sch:assert>
+    </sch:rule>
+    <sch:rule context="/auc:BuildingSync/auc:Facilities/auc:Facility/auc:Sites/auc:Site/auc:Buildings/auc:Building/auc:Sections/auc:Section[auc:SectionType/text() = &quot;Whole building&quot;]/auc:Sides/auc:Side/auc:WallIDs/auc:WallID">
+      <sch:assert test="//auc:WallSystem[@ID = current()/@IDref]" role="">auc:WallID in auc:Side should link to an auc:WallSystem's ID</sch:assert>
+      <sch:assert test="auc:WallArea" role="">auc:WallArea</sch:assert>
+    </sch:rule>
+  </sch:pattern>
 </sch:schema>