# IfcOpenShell - IFC toolkit and geometry engine # Copyright (C) 2021 Thomas Krijnen # # This file is part of IfcOpenShell. # # IfcOpenShell is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # IfcOpenShell is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with IfcOpenShell. If not, see . import os import re import pytest import logging import unittest import tempfile import xmlschema import functools import itertools import ifcopenshell import ifcopenshell.api from bcf import bcfxml from dataclasses import dataclass from ifcopenshell import ids, template, validate from xml.dom.minidom import parseString IFC_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IFC/", "IFC4_Wall_3_with_properties.ifc") IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_all_fields.xml") logger = logging.getLogger("IDS_Logger") # logging.basicConfig(level=logging.INFO, format="%(message)s") # logging.basicConfig(filename=os.path.join(os.path.dirname(__file__), "log.txt"), level=logging.INFO, format="%(message)s") file = open(os.path.join(tempfile.gettempdir(), "test.ifc"), "w") file.write(IFC_URL) file.close() ifc_file = ifcopenshell.open(IFC_URL) os.remove(os.path.join(tempfile.gettempdir(), "test.ifc")) class TestIdsParsing(unittest.TestCase): def test_parse_basic_ids(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_all_fields.xml") ids_file = ids.ids.open(IDS_URL) self.assertEqual(type(ids_file).__name__, "ids") def test_parse_entity_facet(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_entity.xml") ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "IfcWall") def test_parse_predefinedType_facet(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_predefinedtype.xml") ids_file = ids.ids.open(IDS_URL) self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["predefinedType"]["simpleValue"], "CLADDING" ) def test_parse_property_facet(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property.xml") ids_file = ids.ids.open(IDS_URL) self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["propertySet"]["simpleValue"], "Test_PropertySet" ) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["value"]["simpleValue"], "Test_Value") def test_parse_material_facet(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_material.xml") ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["value"]["simpleValue"], "Test_Material") def test_parse_classification_facet(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_classification.xml") ids_file = ids.ids.open(IDS_URL) self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["value"]["simpleValue"], "Test_Classification" ) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["system"]["simpleValue"], "Test_System") def test_failing_on_opening_invalid_ids_data(self): with pytest.raises(xmlschema.validators.exceptions.XMLSchemaValidationError): ids.ids.open("""""") """ Saving parsed IDS to IDS.xml """ def test_parsed_ids_to_xml(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files", "IDS", "IDS_Wall_needs_all_fields.xml") ids_file = ids.ids.open(IDS_URL) fn = "output.xml" result = ids_file.to_xml(fn) assert os.path.isfile(fn) os.remove(fn) self.assertTrue(result) def test_parsed_ids_to_string(self): return # TODO IDS_URL = os.path.join(os.path.dirname(__file__), "Sample-BIM-Files", "IDS", "IDS_Wall_needs_all_fields.xml") ids_file = ids.ids.open(IDS_URL) output = ids_file.to_string() assert output and "http://standards.buildingsmart.org/IDS" in output """ Parsing IDS files with restrictions """ def test_parse_restrictions_enumeration(self): return # TODO IDS_URL = os.path.join( os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property_with_restriction_enumeration.xml", ) ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual( [ x["@value"] for x in ids_file.specifications[0].requirements.terms[0].node["value"]["restriction"][0]["enumeration"] ], ["testA", "testB"], ) def test_parse_restrictions_bounds(self): return # TODO IDS_URL = os.path.join( os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property_with_restriction_bounds.xml" ) ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["value"]["restriction"][0]["minInclusive"]["@value"], "0", ) def test_parse_restrictions_pattern_simple(self): return # TODO IDS_URL = os.path.join( os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property_with_restriction_pattern.xml" ) ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["value"]["restriction"][0]["pattern"]["@value"], "[A-Z]{2,4}", ) @dataclass class doc_test_case: name: str ids_content: str ids_filename: str ifc_content: str ifc_filename: str expected_result: str class spec_generator: cases = [] def __call__(self, name, *, facet, inst, expected): if not name: return fail_or_pass = "pass" if expected is True else "fail" # Create an IFC file with the instance in `inst` passed to us # based on an IFC file template with project and units. f = template.create() instances = [f.add(inst)] for nm in inst.wrapped_data.get_inverse_attribute_names(): for v in getattr(inst, nm): instances.append(f.add(v)) # Validate the file created and loop over the issues, fixing them # one by one. l = validate.json_logger() validate.validate(f, l) for issue in l.statements: if "GlobalId" in issue["message"]: issue["instance"].GlobalId = ifcopenshell.guid.new() elif "PredefinedType" in issue["message"]: ty = re.findall("\\(.+?\\)", issue["message"])[0][1:-1].split(", ")[0] issue["instance"].PredefinedType = ty elif "IfcMaterialList" in issue["message"]: issue["instance"].Materials = [f.createIfcMaterial("Concrete", None, "CONCRETE")] else: raise Exception("About to emit invalid example data") ifc_text = "\n".join( map(str, {inst: None for inst in itertools.chain.from_iterable(map(f.traverse, instances))}.keys()) ) basename = f"{fail_or_pass}_{name.lower().replace(' ', '_')}" # Write IFC to disk f.write(f"{basename}.ifc") # Create an IDS with the applicability selecting exactly # the entity type passed to us in `inst`. specs = ids.ids(title=name) spec = ids.specification(name=name) spec.add_applicability(ids.entity.create(name=inst.is_a())) spec.add_requirement(facet) specs.specifications.append(spec) # Write IDS to disk with open(f"{basename}.ids", "w", encoding="utf-8") as ids_file: ids_file.write(specs.to_string()) xml_text = "\n".join( l for l in parseString(specs.to_string()) .getElementsByTagName("requirements")[0] .childNodes[1] .toprettyxml() .split("\n") if l.strip() ).replace("\t", " ") self.cases.append(doc_test_case(name, xml_text, f"{basename}.ids", ifc_text, f"{basename}.ifc", fail_or_pass)) assert bool(facet(inst)) is expected case = spec_generator() class TestIdsAuthoring(unittest.TestCase): def test_create_an_ids_with_minimal_information(self): specs = ids.ids() assert specs.asdict() == { "@xmlns": "http://standards.buildingsmart.org/IDS", "@xmlns:xs": "http://www.w3.org/2001/XMLSchema", "@xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "@xsi:schemaLocation": "http://standards.buildingsmart.org/IDS/ids_05.xsd", "info": {"title": "Untitled"}, "specifications": {"specification": []}, } def test_create_an_ids_with_all_possible_information(self): specs = ids.ids( title="title", copyright="copyright", version="version", description="description", author="author@test.com", date="2020-01-01", purpose="purpose", milestone="milestone", ) assert specs.asdict() == { "@xmlns": "http://standards.buildingsmart.org/IDS", "@xmlns:xs": "http://www.w3.org/2001/XMLSchema", "@xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "@xsi:schemaLocation": "http://standards.buildingsmart.org/IDS/ids_05.xsd", "info": { "title": "title", "copyright": "copyright", "version": "version", "description": "description", "author": "author@test.com", "date": "2020-01-01", "purpose": "purpose", "milestone": "milestone", }, "specifications": {"specification": []}, } def test_check_invalid_ids_information(self): specs = ids.ids(title=None, author="author", date="9999-99-99") assert specs.asdict() == { "@xmlns": "http://standards.buildingsmart.org/IDS", "@xmlns:xs": "http://www.w3.org/2001/XMLSchema", "@xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "@xsi:schemaLocation": "http://standards.buildingsmart.org/IDS/ids_05.xsd", "info": {"title": "Untitled"}, "specifications": {"specification": []}, } def test_authoring_an_ids_with_no_specifications_is_invalid(self): specs = ids.ids() with pytest.raises(xmlschema.validators.exceptions.XMLSchemaChildrenValidationError): specs.to_string() def test_create_specification_with_minimal_information(self): spec = ids.specification() assert spec.asdict() == { "@name": "Unnamed", "@ifcVersion": ["IFC2X3", "IFC4"], "applicability": {}, "requirements": {}, } def test_create_specification_with_all_possible_information(self): spec = ids.specification( name="name", minOccurs="0", maxOccurs="unbounded", ifcVersion="IFC4", identifier="identifier", description="description", instructions="instructions", ) assert spec.asdict() == { "@name": "name", "@minOccurs": "0", "@maxOccurs": "unbounded", "@ifcVersion": "IFC4", "@identifier": "identifier", "@description": "description", "@instructions": "instructions", "applicability": {}, "requirements": {}, } def test_creating_an_entity_facet(self): facet = ids.entity.create(name="IfcName") assert facet.asdict() == {"name": {"simpleValue": "IfcName"}} facet = ids.entity.create(name="IfcName", predefinedType="predefinedType", instructions="instructions") assert facet.asdict() == { "name": {"simpleValue": "IfcName"}, "predefinedType": {"simpleValue": "predefinedType"}, "@instructions": "instructions", } def test_filtering_using_an_entity_facet(self): ifc = ifcopenshell.file() # Wrong IFC classes are never matched. facet = ids.entity.create(name="IfcRabbit") case("Non-existent entity name", facet=facet, inst=ifc.createIfcWall(), expected=False) # IFC class is checked for an exact match. Subclasses should not match. # TODO: Some votes to prefer inheritance (For: Moult, Evandro, Artur) # Possible argument: CAD tools don't understand IFC facet = ids.entity.create(name="IfcWall") case("Entity matching", facet=facet, inst=ifc.createIfcWall(), expected=True) case( "Entity with PredefinedType", facet=facet, inst=ifc.createIfcWall(PredefinedType="SOLIDWALL"), expected=True ) case("Entity matching", facet=facet, inst=ifc.createIfcSlab(), expected=False) case("Entity subtype", facet=facet, inst=ifc.createIfcWallStandardCase(), expected=False) # IFC class is case insensitive. # WRONG WRONG WRONG should be UPPERCASE # But in that case why are the enumerations for things like partOf using the IFC capitalisation? facet = ids.entity.create(name="IFCWALL") case("Entity case 0", facet=facet, inst=ifc.createIfcWall(), expected=True) case("Entity case 1", facet=facet, inst=ifc.createIfcWall(PredefinedType="SOLIDWALL"), expected=True) case("Entity case 2", facet=facet, inst=ifc.createIfcSlab(), expected=False) # Predefined types are checked from standard enumeration values facet = ids.entity.create(name="IfcWall", predefinedType="SOLIDWALL") case("Entity PredefinedType 0", facet=facet, inst=ifc.createIfcWall(), expected=False) case("Entity PredefinedType 1", facet=facet, inst=ifc.createIfcWall(PredefinedType="SOLIDWALL"), expected=True) case( "Entity PredefinedType 2", facet=facet, inst=ifc.createIfcWall(PredefinedType="PARTITIONING"), expected=False, ) # Predefined Type must be uppercase, exactly the same as defined in the enumeration facet = ids.entity.create(name="IfcWall", predefinedType="solidwall") assert bool(facet(ifc.createIfcWall(PredefinedType="SOLIDWALL"))) is False # Predefined types are checked from the object type field if not standard facet = ids.entity.create(name="IfcWall", predefinedType="WALDO") case( "Entity user-defined type", facet=facet, inst=ifc.createIfcWall(PredefinedType="USERDEFINED", ObjectType="WALDO"), expected=True, ) # Predefined types are checked from the element type field if not standard for types facet = ids.entity.create(name="IfcWallType", predefinedType="WALDO") case( "Entity ElementType", facet=facet, inst=ifc.createIfcWallType(PredefinedType="USERDEFINED", ElementType="WALDO"), expected=True, ) # Predefined types are checked from the process type field if not standard for processes # TODO # Userdefined is not an allowed filter because userdefined implies a specified object or element type facet = ids.entity.create(name="IfcWall", predefinedType="USERDEFINED") case( "Entity no USERDEFINED", facet=facet, inst=ifc.createIfcWall(PredefinedType="USERDEFINED", ObjectType="WALDO"), expected=False, ) # Predefined types should match inherited predefined types from the element type wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") wall_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType", predefined_type="X") ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) facet = ids.entity.create(name="IfcWall", predefinedType="X") case("Entity PredefinedType inheritance 0", facet=facet, inst=wall, expected=True) # Predefined types should match overridden predefined types from the element type wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall", predefined_type="X") wall_type = ifcopenshell.api.run( "root.create_entity", ifc, ifc_class="IfcWallType", predefined_type="NOTDEFINED" ) ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) facet = ids.entity.create(name="IfcWall", predefinedType="X") case("Entity PredefinedType inheritance 1", facet=facet, inst=wall, expected=True) # Restrictions are allowed when matching the IFC class restriction = ids.restriction.create(options=["IfcWall", "IfcSlab"], type="enumeration") facet = ids.entity.create(name=restriction) case("Entity enumeration 0", facet=facet, inst=ifc.createIfcWall(), expected=True) case("Entity enumeration 1", facet=facet, inst=ifc.createIfcSlab(), expected=True) case("Entity enumeration 2", facet=facet, inst=ifc.createIfcBeam(), expected=False) # Another example of how restrictions are allowed when matching the IFC class # Note: Regex patterns follow the XSD flavour restriction = ids.restriction.create(options="Ifc.*Type", type="pattern") facet = ids.entity.create(name=restriction) case("Entity pattern 0", facet=facet, inst=ifc.createIfcWall(), expected=False) case("Entity pattern 1", facet=facet, inst=ifc.createIfcWallType(), expected=True) # Restrictions are allowed when matching the predefined type restriction = ids.restriction.create(options="FOO.*", type="pattern") facet = ids.entity.create(name="IfcWall", predefinedType=restriction) wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall", predefined_type="FOOBAR") wall2 = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall", predefined_type="FOOBAZ") wall3 = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall", predefined_type="BAZFOO") case("", facet=facet, inst=wall, expected=True) case("", facet=facet, inst=wall2, expected=True) case("", facet=facet, inst=wall3, expected=False) def test_creating_an_attribute_facet(self): attribute = ids.attribute.create(name="name") assert attribute.asdict() == {"name": {"simpleValue": "name"}} attribute = ids.attribute.create(name="name", value="value") assert attribute.asdict() == {"name": {"simpleValue": "name"}, "value": {"simpleValue": "value"}} attribute = ids.attribute.create( name="name", value="value", minOccurs="0", maxOccurs="unbounded", instructions="instructions" ) assert attribute.asdict() == { "name": {"simpleValue": "name"}, "value": {"simpleValue": "value"}, "@minOccurs": "0", "@maxOccurs": "unbounded", "@instructions": "instructions", } def test_filtering_using_an_attribute_facet(self): ifc = ifcopenshell.file() # Attribute names that don't exist are never matched facet = ids.attribute.create(name="Foobar") case("", facet=facet, inst=ifc.createIfcWall(), expected=False) # Attribute names that are either null or empty string are not matched. # The logic is that unfortunately most BIM users cannot differentiate between the two. facet = ids.attribute.create(name="Name") case("", facet=facet, inst=ifc.createIfcWall(), expected=False) case("", facet=facet, inst=ifc.createIfcWall(Name=""), expected=False) case("", facet=facet, inst=ifc.createIfcWall(Name="Foobar"), expected=True) # TODO write test case that evaluates empty list / set as False # TODO write test case that evaluates logical UNKNOWN as False # TODO write test case that evaluates any bool as True # An object value is truthy facet = ids.attribute.create(name="OwnerHistory") assert bool(facet(ifc.createIfcWall())) is False assert bool(facet(ifc.createIfcWall(OwnerHistory=ifc.createIfcOwnerHistory()))) is True # Selects are only considered for truthy or falsey facet = ids.attribute.create(name="DiffuseColour") element = ifc.createIfcSurfaceStyleRendering() assert bool(facet(element)) is False assert bool(facet(ifc.createIfcSurfaceStyleRendering(DiffuseColour=ifc.createIfcColourRgb()))) is True assert ( bool(facet(ifc.createIfcSurfaceStyleRendering(DiffuseColour=ifc.createIfcNormalisedRatioMeasure(0.5)))) is True ) # When a value is specified, the value shall match case sensitively facet = ids.attribute.create(name="Name", value="Foobar") case("", facet=facet, inst=ifc.createIfcWall(Name="Foobar"), expected=True) case("", facet=facet, inst=ifc.createIfcWall(Name="foobar"), expected=False) case("", facet=facet, inst=ifc.createIfcWall(Name="Foobaz"), expected=False) # A value that is 0 is still considered a value, not "null-like", so it is matched facet = ids.attribute.create(name="Eastings") case("", facet=facet, inst=ifc.createIfcMapConversion(Eastings=0), expected=True) # Value checks are meaningless for checking objects, selects, and lists so it always fails facet = ids.attribute.create(name="OwnerHistory", value="Foobar") assert bool(facet(ifc.createIfcWall(OwnerHistory=ifc.createIfcOwnerHistory()))) is False # Selects # Lists # TODO continue from here # TODO should we be allowed to check inverse attributes? # Nope - always false # TODO should we be allowed to check derived attributes? # Nope - always false # Simple values which must be strings are checked with strict typing. No type casting shall occur. facet = ids.attribute.create(name="Eastings", value="42") case("", facet=facet, inst=ifc.createIfcMapConversion(Eastings=0), expected=False) case("", facet=facet, inst=ifc.createIfcMapConversion(Eastings=42), expected=False) # Strict type checking is done with restrictions. This is really ugly, but hopefully hidden to a user. restriction = ids.restriction.create(options=[42], type="enumeration", base="decimal") # Here is another uglier option: # restriction = ids.restriction.create( # options={"minInclusive": 42, "maxInclusive": 42}, type="bounds", base="decimal" # ) facet = ids.attribute.create(name="Eastings", value=restriction) case("", facet=facet, inst=ifc.createIfcMapConversion(Eastings=42), expected=True) # Restrictions are allowed for the name restriction = ids.restriction.create(options=".*Name.*", type="pattern") facet = ids.attribute.create(name=restriction) case("", facet=facet, inst=ifc.createIfcMaterialLayerSet(LayerSetName="Foo"), expected=True) case("", facet=facet, inst=ifc.createIfcMaterialConstituentSet(Name="Foo"), expected=True) # Restrictions for the name imply that multiple names may be matched. All, not any, must pass the checks. restriction = ids.restriction.create(options=["Name", "Description"], type="enumeration") facet = ids.attribute.create(name=restriction) case("", facet=facet, inst=ifc.createIfcWall(Name="Foo"), expected=False) case("", facet=facet, inst=ifc.createIfcWall(Name="Foo", Description="Bar"), expected=True) # Restrictions are allowed for the value restriction = ids.restriction.create(options=["Foo", "Bar"], type="enumeration") facet = ids.attribute.create(name="Name", value=restriction) case("", facet=facet, inst=ifc.createIfcWall(Name="Foo"), expected=True) case("", facet=facet, inst=ifc.createIfcWall(Name="Bar"), expected=True) case("", facet=facet, inst=ifc.createIfcWall(Name="Foobar"), expected=False) # The facet checks on attributes on the type, which may be inherited by the occurence # TODO attribute inheritance is not defined IFC behaviour facet = ids.attribute.create(name="Description", value="Foobar") case("", facet=facet, inst=ifc.createIfcWall(Description="Foobar"), expected=True) wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") wall_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) wall_type.Description = "Foobar" case("", facet=facet, inst=wall, expected=True) # The facet checks on attributes on the type, which may be overriden by attributes on the occurence # TODO attribute overriding is not defined IFC behaviour facet = ids.attribute.create(name="Description", value="Foobar") case("", facet=facet, inst=ifc.createIfcWall(Description="Foobar"), expected=True) wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") wall_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) wall_type.Description = "Foobaz" wall.Description = "Foobar" case("", facet=facet, inst=wall, expected=True) def test_creating_a_classification_facet(self): facet = ids.classification.create() assert facet.asdict() == {} facet = ids.classification.create(value="value", system="system") assert facet.asdict() == {"value": {"simpleValue": "value"}, "system": {"simpleValue": "system"}} facet = ids.classification.create( value="value", system="system", uri="https://test.com", minOccurs="0", maxOccurs="unbounded", instructions="instructions", ) assert facet.asdict() == { "value": {"simpleValue": "value"}, "system": {"simpleValue": "system"}, "@uri": "https://test.com", "@minOccurs": "0", "@maxOccurs": "unbounded", "@instructions": "instructions", } def test_filtering_using_a_classification_facet(self): library = ifcopenshell.file() system = library.createIfcClassification(Name="Foobar") ref1 = library.createIfcClassificationReference(Identification="1", ReferencedSource=system) ref11 = library.createIfcClassificationReference(Identification="11", ReferencedSource=ref1) ref2 = library.createIfcClassificationReference(Identification="2", ReferencedSource=system) ref22 = library.createIfcClassificationReference(Identification="22", ReferencedSource=ref2) ifc = ifcopenshell.file() project = ifc.createIfcProject() ifcopenshell.api.run("classification.add_classification", ifc, classification=system) element0 = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") element1 = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") ifcopenshell.api.run( "classification.add_reference", ifc, product=element1, reference=ref1, classification=system ) element11 = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") ifcopenshell.api.run( "classification.add_reference", ifc, product=element11, reference=ref11, classification=system ) element22 = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") ifcopenshell.api.run( "classification.add_reference", ifc, product=element22, reference=ref22, classification=system, is_lightweight=False, ) # A classification facet with no data matches any present classification facet = ids.classification.create() case("", facet=facet, inst=element0, expected=False) case("", facet=facet, inst=element1, expected=True) # Values should match exactly if lightweight classifications are used. facet = ids.classification.create(value="1") case("", facet=facet, inst=element1, expected=True) # Values should match subreferences if full classifications are used. # E.g. a facet searching for Uniclass EF_25_10 Walls will match Uniclass EF_25_10_25, EF_25_10_30, etc facet = ids.classification.create(value="2") case("", facet=facet, inst=element22, expected=True) # Systems should match exactly regardless of lightweight or full classifications facet = ids.classification.create(system="Foobar") case("", facet=facet, inst=project, expected=True) case("", facet=facet, inst=element0, expected=False) case("", facet=facet, inst=element1, expected=True) case("", facet=facet, inst=element11, expected=True) case("", facet=facet, inst=element22, expected=True) # Restrictions can be used for values restriction = ids.restriction.create(options="1.*", type="pattern") facet = ids.classification.create(value=restriction) case("", facet=facet, inst=element1, expected=True) case("", facet=facet, inst=element11, expected=True) case("", facet=facet, inst=element22, expected=False) # Restrictions can be used for systems restriction = ids.restriction.create(options="Foo.*", type="pattern") facet = ids.classification.create(system=restriction) case("", facet=facet, inst=element0, expected=False) case("", facet=facet, inst=element1, expected=True) # Specifying both a value and a system means that both (as opposed to either) requirements must be met facet = ids.classification.create(system="Foobar", value="1") case("", facet=facet, inst=element1, expected=True) case("", facet=facet, inst=element11, expected=False) # The facet checks on either the type or instance. # IFC doesn't specify how inheritance and overrides work here. Two options: # Option 1) Occurrences replace inherited type references # Option 2) Occurrences union with inherited type references # Option 2 is followed here. wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") wall_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) ifcopenshell.api.run("classification.add_reference", ifc, product=wall, reference=ref11, classification=system) ifcopenshell.api.run( "classification.add_reference", ifc, product=wall_type, reference=ref22, classification=system ) facet = ids.classification.create(value="11") case("", facet=facet, inst=wall, expected=True) case("", facet=facet, inst=wall_type, expected=False) facet = ids.classification.create(value="22") case("", facet=facet, inst=wall, expected=True) case("", facet=facet, inst=wall_type, expected=True) def test_creating_a_property_facet(self): facet = ids.property.create() assert facet.asdict() == { "propertySet": {"simpleValue": "Property_Set"}, "name": {"simpleValue": "PropertyName"}, } facet = ids.property.create( propertySet="propertySet", name="name", value="value", measure="String", uri="https://test.com", minOccurs="0", maxOccurs="unbounded", instructions="instructions", ) assert facet.asdict() == { "propertySet": {"simpleValue": "propertySet"}, "name": {"simpleValue": "name"}, "value": {"simpleValue": "value"}, "@measure": "String", "@uri": "https://test.com", "@minOccurs": "0", "@maxOccurs": "unbounded", "@instructions": "instructions", } def test_filtering_using_a_property_facet(self): ifc = ifcopenshell.file() ifc.createIfcProject() # Milli prefix used to check measurement conversions lengthunit = ifcopenshell.api.run("unit.add_si_unit", ifc, unit_type="LENGTHUNIT", name="METRE", prefix="MILLI") areaunit = ifcopenshell.api.run( "unit.add_si_unit", ifc, unit_type="AREAUNIT", name="SQUARE_METRE", prefix="MILLI" ) volumeunit = ifcopenshell.api.run( "unit.add_si_unit", ifc, unit_type="VOLUMEUNIT", name="CUBIC_METRE", prefix="MILLI" ) timeunit = ifcopenshell.api.run("unit.add_si_unit", ifc, unit_type="TIMEUNIT", name="SECOND") ifcopenshell.api.run("unit.assign_unit", ifc, units=[lengthunit, areaunit, volumeunit, timeunit]) # A name check by itself only checks that a property is non-null and non empty string # The logic is that unfortunately most BIM users cannot differentiate between the two. facet = ids.property.create(propertySet="Foo_Bar", name="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") case("", facet=facet, inst=element, expected=False) pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": None}) case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Bar"}) case("", facet=facet, inst=element, expected=True) # A simple value checks an exact case-sensitive match facet = ids.property.create(propertySet="Foo_Bar", name="Foo", value="Bar") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Bar"}) case("", facet=facet, inst=element, expected=True) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Baz"}) case("", facet=facet, inst=element, expected=False) # Simple values only check string matches facet = ids.property.create(propertySet="Foo_Bar", name="Foo", value="1") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "1"}) case("", facet=facet, inst=element, expected=True) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": ifc.createIfcInteger(1)}) case("", facet=facet, inst=element, expected=False) # Restrictions are supported for property sets. If multiple are matched, all must satisfy requirements. restriction = ids.restriction.create(options="Foo_.*", type="pattern") facet = ids.property.create(propertySet=restriction, name="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Bar"}) case("", facet=facet, inst=element, expected=True) pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Baz") case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Bar"}) case("", facet=facet, inst=element, expected=True) # Restrictions are supported for names. If multiple are matched, all must satisfy requirements. restriction = ids.restriction.create(options="Foo.*", type="pattern") facet = ids.property.create(propertySet="Foo_Bar", name=restriction, value="x") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": "x"}) case("", facet=facet, inst=element, expected=True) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": "x", "Foobaz": "x"}) case("", facet=facet, inst=element, expected=True) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": "x", "Foobaz": "y"}) case("", facet=facet, inst=element, expected=False) # Restrictions are supported for values. If multiple are matched, all must satisfy requirements. restriction1 = ids.restriction.create(options="Foo.*", type="pattern") restriction2 = ids.restriction.create(options=["x", "y"], type="enumeration") facet = ids.property.create(propertySet="Foo_Bar", name=restriction1, value=restriction2) element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": "x", "Foobaz": "y"}) case("", facet=facet, inst=element, expected=True) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": "x", "Foobaz": "z"}) case("", facet=facet, inst=element, expected=False) # Restrictions may be used to check basic data primitives restriction = ids.restriction.create(options=[42.12], type="enumeration", base="decimal") facet = ids.property.create(propertySet="Foo_Bar", name="Foobar", value=restriction) element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": 42.12}) case("", facet=facet, inst=element, expected=True) restriction = ids.restriction.create(options=[42], type="enumeration", base="integer") facet = ids.property.create(propertySet="Foo_Bar", name="Foobar", value=restriction) case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": 42}) case("", facet=facet, inst=element, expected=True) restriction = ids.restriction.create(options=[True], type="enumeration", base="boolean") facet = ids.property.create(propertySet="Foo_Bar", name="Foobar", value=restriction) case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": True}) case("", facet=facet, inst=element, expected=True) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": False}) case("", facet=facet, inst=element, expected=False) # When measure is not specified, no unit conversion is done and only primitives are checked restriction = ids.restriction.create(options=[42.12], type="enumeration", base="decimal") facet = ids.property.create(propertySet="Foo_Bar", name="Foobar", value=restriction) element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foobar": 42.12}) case("", facet=facet, inst=element, expected=True) # Measure may be used to specify an IFC data type restriction = ids.restriction.create(options=[2], type="enumeration", base="decimal") facet = ids.property.create(propertySet="Foo_Bar", name="Foo", value=restriction, measure="Time") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": ifc.createIfcMassMeasure(2)}) case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": ifc.createIfcTimeMeasure(2)}) case("", facet=facet, inst=element, expected=True) # Measure also implies that a unit matters, and so a conversion shall take place to SI units restriction = ids.restriction.create(options=[2], type="enumeration", base="decimal") facet = ids.property.create(propertySet="Foo_Bar", name="Foo", value=restriction, measure="Length") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") pset = ifcopenshell.api.run("pset.add_pset", ifc, product=element, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": ifc.createIfcLengthMeasure(2)}) case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": ifc.createIfcLengthMeasure(2000)}) case("", facet=facet, inst=element, expected=True) # The facet checks inherited properties from the type wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") wall_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) pset = ifcopenshell.api.run("pset.add_pset", ifc, product=wall_type, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Bar"}) facet = ids.property.create(propertySet="Foo_Bar", name="Foo") case("", facet=facet, inst=wall, expected=True) case("", facet=facet, inst=wall_type, expected=True) # The facet checks overriden properties from the occurrence wall = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") wall_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=wall, relating_type=wall_type) pset = ifcopenshell.api.run("pset.add_pset", ifc, product=wall_type, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Baz"}) pset = ifcopenshell.api.run("pset.add_pset", ifc, product=wall, name="Foo_Bar") ifcopenshell.api.run("pset.edit_pset", ifc, pset=pset, properties={"Foo": "Bar"}) facet = ids.property.create(propertySet="Foo_Bar", name="Foo", value="Bar") case("", facet=facet, inst=wall, expected=True) case("", facet=facet, inst=wall_type, expected=False) def test_creating_a_material_facet(self): facet = ids.material.create() assert facet.asdict() == {} facet = ids.material.create( value="value", uri="https://test.com", minOccurs="0", maxOccurs="unbounded", instructions="instructions" ) assert facet.asdict() == { "value": {"simpleValue": "value"}, "@uri": "https://test.com", "@minOccurs": "0", "@maxOccurs": "unbounded", "@instructions": "instructions", } def test_filtering_using_a_material_facet(self): ifc = ifcopenshell.file() # A material facet with no data matches any present material facet = ids.material.create() element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") case("", facet=facet, inst=element, expected=False) material = ifcopenshell.api.run("material.add_material", ifc) ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material) case("", facet=facet, inst=element, expected=True) # A value will match a material name or category facet = ids.material.create(value="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") material = ifcopenshell.api.run("material.add_material", ifc) ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material) case("", facet=facet, inst=element, expected=False) material.Name = "Foo" case("", facet=facet, inst=element, expected=True) material.Name = "Bar" material.Category = "Foo" case("", facet=facet, inst=element, expected=True) # A value will match any material name or category in a material list facet = ids.material.create(value="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") material_set = ifcopenshell.api.run("material.add_material_set", ifc, set_type="IfcMaterialList") ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material_set) case("", facet=facet, inst=element, expected=False) material = ifcopenshell.api.run("material.add_material", ifc) ifcopenshell.api.run("material.add_list_item", ifc, material_list=material_set, material=material) material.Name = "Foo" case("", facet=facet, inst=element, expected=True) material.Name = "Bar" material.Category = "Foo" case("", facet=facet, inst=element, expected=True) # A value will match any material name or category, or layer name or category in a layer set facet = ids.material.create(value="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") material_set = ifcopenshell.api.run("material.add_material_set", ifc, set_type="IfcMaterialLayerSet") ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material_set) case("", facet=facet, inst=element, expected=False) material = ifcopenshell.api.run("material.add_material", ifc) layer = ifcopenshell.api.run("material.add_layer", ifc, layer_set=material_set, material=material) layer.Name = "Foo" case("", facet=facet, inst=element, expected=True) layer.Name = "Bar" layer.Category = "Foo" case("", facet=facet, inst=element, expected=True) layer.Category = "Bar" material.Name = "Foo" case("", facet=facet, inst=element, expected=True) material.Name = "Bar" material.Category = "Foo" case("", facet=facet, inst=element, expected=True) # A value will match any material name or category, or profile name or category in a profile set facet = ids.material.create(value="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") material_set = ifcopenshell.api.run("material.add_material_set", ifc, set_type="IfcMaterialProfileSet") ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material_set) case("", facet=facet, inst=element, expected=False) material = ifcopenshell.api.run("material.add_material", ifc) profile = ifcopenshell.api.run("material.add_profile", ifc, profile_set=material_set, material=material) profile.Name = "Foo" case("", facet=facet, inst=element, expected=True) profile.Name = "Bar" profile.Category = "Foo" case("", facet=facet, inst=element, expected=True) profile.Category = "Bar" material.Name = "Foo" case("", facet=facet, inst=element, expected=True) material.Name = "Bar" material.Category = "Foo" case("", facet=facet, inst=element, expected=True) # A value will match any material name or category, or constituent name or category in a constituent set facet = ids.material.create(value="Foo") element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") material_set = ifcopenshell.api.run("material.add_material_set", ifc, set_type="IfcMaterialConstituentSet") ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material_set) case("", facet=facet, inst=element, expected=False) material = ifcopenshell.api.run("material.add_material", ifc) constituent = ifcopenshell.api.run( "material.add_constituent", ifc, constituent_set=material_set, material=material ) constituent.Name = "Foo" case("", facet=facet, inst=element, expected=True) constituent.Name = "Bar" constituent.Category = "Foo" case("", facet=facet, inst=element, expected=True) constituent.Category = "Bar" material.Name = "Foo" case("", facet=facet, inst=element, expected=True) material.Name = "Bar" material.Category = "Foo" case("", facet=facet, inst=element, expected=True) # The facet will check for inherited materials element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") element_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=element, relating_type=element_type) material = ifcopenshell.api.run("material.add_material", ifc) ifcopenshell.api.run("material.assign_material", ifc, product=element_type, material=material) material.Name = "Foo" facet = ids.material.create(value="Foo") case("", facet=facet, inst=element, expected=True) case("", facet=facet, inst=element_type, expected=True) # The facet will check for overriden materials element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") element_type = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWallType") ifcopenshell.api.run("type.assign_type", ifc, related_object=element, relating_type=element_type) material = ifcopenshell.api.run("material.add_material", ifc) ifcopenshell.api.run("material.assign_material", ifc, product=element_type, material=material) material.Name = "Bar" material = ifcopenshell.api.run("material.add_material", ifc) ifcopenshell.api.run("material.assign_material", ifc, product=element, material=material) material.Name = "Foo" facet = ids.material.create(value="Foo") case("", facet=facet, inst=element, expected=True) case("", facet=facet, inst=element_type, expected=False) def test_creating_a_partof_facet(self): facet = ids.partOf.create() assert facet.asdict() == {"@entity": "IfcSystem"} facet = ids.partOf.create(entity="IfcGroup") assert facet.asdict() == {"@entity": "IfcGroup"} def test_filtering_using_a_partof_facet(self): ifc = ifcopenshell.file() # An IfcElementAssembly entity only passes those who are part of an assembly element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcElementAssembly") subelement = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcWall") ifcopenshell.api.run("aggregate.assign_object", ifc, product=subelement, relating_object=element) facet = ids.partOf.create(entity="IfcElementAssembly") case("", facet=facet, inst=element, expected=False) case("", facet=facet, inst=subelement, expected=True) # An IfcElementAssembly strictly checks that the whole is an IfcElementAssembly class element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcSlab") subelement = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcBeam") ifcopenshell.api.run("aggregate.assign_object", ifc, product=subelement, relating_object=element) facet = ids.partOf.create(entity="IfcElementAssembly") case("", facet=facet, inst=subelement, expected=False) # A nested subelement still passes so long as one of its parents is an IfcElementAssembly # TODO nononono element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcElementAssembly") subelement = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcSlab") subsubelement = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcBeam") ifcopenshell.api.run("aggregate.assign_object", ifc, product=subelement, relating_object=element) ifcopenshell.api.run("aggregate.assign_object", ifc, product=subsubelement, relating_object=subelement) facet = ids.partOf.create(entity="IfcElementAssembly") case("", facet=facet, inst=subsubelement, expected=True) # An IfcGroup only checks that a group is assigned without any other logic element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcElementAssembly") group = ifcopenshell.api.run("group.add_group", ifc) facet = ids.partOf.create(entity="IfcGroup") case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("group.assign_group", ifc, product=element, group=group) case("", facet=facet, inst=element, expected=True) # An IfcGroup can be passed by subtypes # TODO: wrong, subtypes should not be matched element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcElementAssembly") group = ifc.createIfcInventory() facet = ids.partOf.create(entity="IfcGroup") ifcopenshell.api.run("group.assign_group", ifc, product=element, group=group) case("", facet=facet, inst=element, expected=True) # An IfcSystem only checks that a system is assigned without any other logic element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcElementAssembly") system = ifcopenshell.api.run("system.add_system", ifc) facet = ids.partOf.create(entity="IfcSystem") case("", facet=facet, inst=element, expected=False) ifcopenshell.api.run("system.assign_system", ifc, product=element, system=system) case("", facet=facet, inst=element, expected=True) # An IfcSystem allows subtypes # TODO: wrong, subtypes should not be matched element = ifcopenshell.api.run("root.create_entity", ifc, ifc_class="IfcElementAssembly") system = ifcopenshell.api.run("system.add_system", ifc, ifc_class="IfcDistributionSystem") ifcopenshell.api.run("system.assign_system", ifc, product=element, system=system) facet = ids.partOf.create(entity="IfcSystem") case("", facet=facet, inst=element, expected=True) """ Creating IDS with restrictions """ def test_create_restrictions_enumeration(self): i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) i.specifications[0].add_applicability(ids.entity.create(name="Test_Name")) r = ids.restriction.create(options=["testA", "testB"], type="enumeration") m = ids.material.create(value=r) i.specifications[0].add_requirement(m) self.assertEqual(i.specifications[0].requirements.terms[0].value, "testA") self.assertEqual(i.specifications[0].requirements.terms[0].value, "testB") self.assertNotEqual(i.specifications[0].requirements.terms[0].value, "testC") def test_create_restrictions_bounds(self): i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) i.specifications[0].add_applicability(ids.entity.create(name="Test_Name")) r = ids.restriction.create(options={"minInclusive": 0, "maxExclusive": 10}, type="bounds", base="integer") p = ids.property.create(propertySet="Test", name="Test", value=r) i.specifications[0].add_requirement(p) self.assertEqual(i.specifications[0].requirements.terms[0].value, 0) self.assertEqual(i.specifications[0].requirements.terms[0].value, 5) self.assertNotEqual(i.specifications[0].requirements.terms[0].value, -1) self.assertNotEqual(i.specifications[0].requirements.terms[0].value, 10) def test_create_restrictions_pattern_simple(self): i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) i.specifications[0].add_applicability(ids.entity.create(name="Test_Name")) r = ids.restriction.create(options="[A-Z]{2,4}", type="pattern") p = ids.property.create(propertySet="Test", name="Test", value=r) i.specifications[0].add_requirement(p) self.assertEqual(i.specifications[0].requirements.terms[0].value, "XYZ") self.assertNotEqual(i.specifications[0].requirements.terms[0].value, "abc") self.assertNotEqual(i.specifications[0].requirements.terms[0].value, "ABCDE") self.assertNotEqual(i.specifications[0].requirements.terms[0].value, "A") def test_create_restrictions_pattern_advanced(self): i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) i.specifications[0].add_applicability(ids.entity.create(name="Test_Name")) r = ids.restriction.create(options="(Wanddurchbruch|Deckendurchbruch).*", type="pattern") p = ids.property.create(propertySet="Test", name="Test", value=r) i.specifications[0].add_requirement(p) self.assertEqual(i.specifications[0].requirements.terms[0].value, "Wanddurchbruch") self.assertEqual(i.specifications[0].requirements.terms[0].value, "Deckendurchbruch") self.assertNotEqual(i.specifications[0].requirements.terms[0].value, "Deeckendurchbruch") def test_create_restrictions_pattern_utf(self): i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) i.specifications[0].add_applicability(ids.entity.create(name="Test_Name")) r = ids.restriction.create(options="èêóòâôæøåążźćęóʑʒʓʔʕʗʘʙʚʛʜʝʞ", type="pattern") p = ids.property.create(propertySet="Test", name="Test", value=r) i.specifications[0].add_requirement(p) self.assertEqual(i.specifications[0].requirements.terms[0].value, "èêóòâôæøåążźćęóʑʒʓʔʕʗʘʙʚʛʜʝʞ") def test_created_ids_to_xml(self): i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) e = ids.entity.create(name="Test_Name", predefinedType="Test_PredefinedType") c = ids.classification.create(value="Test_Value", system="Test_System") m = ids.material.create(value="Test_Value") re = ids.restriction.create(options=["testA", "testB"], type="enumeration") rb = ids.restriction.create(options={"minInclusive": 0, "maxExclusive": 10}, type="bounds", base="integer") rp1 = ids.restriction.create(options="[A-Z]{2,4}", type="pattern") rp2 = ids.restriction.create(options="èêóòâôæøåążźćęóʑʒʓʔʕʗʘʙʚʛʜʝʞ", type="pattern") p1 = ids.property.create(propertySet="Test_PropertySet", name="Test_Parameter", value=re) p2 = ids.property.create(propertySet="Test_PropertySet", name="Test_Parameter", value=rb) p3 = ids.property.create(propertySet="Test_PropertySet", name="Test_Parameter", value=rp1) p4 = ids.property.create(propertySet="Test_PropertySet", name="Test_Parameter", value=rp2) p5 = ids.property.create(propertySet="Test_PropertySet", name="Test_Parameter", value=[re, rb, rp1]) i.specifications[0].add_applicability(e) i.specifications[0].add_applicability(m) i.specifications[0].add_requirement(c) i.specifications[0].add_requirement(p1) i.specifications[0].add_requirement(p2) i.specifications[0].add_requirement(p3) i.specifications[0].add_requirement(p4) i.specifications[0].add_requirement(p5) fn = "TEST_FILE.xml" result = i.to_xml(fn) os.remove(fn) self.assertTrue(result) class TestIfcValidation(unittest.TestCase): def test_creating_a_minimal_ids_and_validating(self): specs = ids.ids(title="Title") spec = ids.specification(name="Name") spec.add_applicability(ids.entity.create(name="IfcWall")) spec.add_requirement(ids.attribute.create(name="Name", value="Waldo")) specs.specifications.append(spec) assert "http://standards.buildingsmart.org/IDS" in specs.to_string() assert spec.status == None model = ifcopenshell.file() wall = model.createIfcWall() waldo = model.createIfcWall(Name="Waldo") specs.validate2(model) assert spec.status == False assert set(spec.applicable_entities) == {wall, waldo} assert spec.failed_entities == [wall] def test_creating_multiple_specifications(self): specs = ids.ids(title="Title") spec = ids.specification(name="Name") spec.add_applicability(ids.entity.create(name="IfcWall")) spec.add_requirement(ids.attribute.create(name="Name", value="Waldo")) specs.specifications.append(spec) spec2 = ids.specification(name="Name") spec2.add_applicability(ids.entity.create(name="IfcWall")) spec2.add_requirement(ids.attribute.create(name="Name", value="Waldo")) specs.specifications.append(spec2) model = ifcopenshell.file() wall = model.createIfcWall() waldo = model.createIfcWall(Name="Waldo") specs.validate2(model) assert spec.status == False assert set(spec.applicable_entities) == {wall, waldo} assert spec.failed_entities == [wall] assert spec2.failed_entities == [wall] def test_validate_simple(self): return # TODO # Same test as in reporting... ids_file = ids.ids.open(IDS_URL) report = ids.SimpleHandler() logger.addHandler(report) ids_file.validate(ifc_file, logger) self.assertEqual(len(report.statements), 5) logger.handlers.pop() def test_validate_all_facets(self): # Those are true: e = ids.entity.create(name="IfcWall") p1 = ids.property.create(propertySet="MySet", name="Param1", value="banan") p2 = ids.property.create(propertySet="MySet", name="Param2", value=120.0) p3 = ids.property.create(propertySet="Pset_WallCommon", name="LoadBearing", value=False) # Those are false: p4 = ids.property.create(propertySet="MySet", name="Param1", value="orange") p5 = ids.property.create(propertySet="MySet", name="Param2", value=123.4) p6 = ids.property.create(propertySet="Pset_WallCommon", name="LoadBearing", value=True) i = ids.ids(title="My IDS") i.specifications.append(ids.specification(name="Test_Specification")) i.specifications[0].add_applicability(e) i.specifications[0].add_requirement(p1) i.specifications[0].add_requirement(p2) i.specifications[0].add_requirement(p3) i.specifications[0].add_requirement(p4) i.specifications[0].add_requirement(p5) i.specifications[0].add_requirement(p6) report = ids.SimpleHandler(report_valid=True) logger.addHandler(report) i.validate(ifc_file, logger) # TODO self.assertEqual(len(report.statements), 27) #there are 5 walls in the IFC, one passed 3 criteria, est should fail (27 failures) logger.handlers.pop() """ Validating IDS files with restrictions """ def test_validate_restrictions_enumeration(self): return # TODO IDS_URL = os.path.join( os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property_with_restriction_enumeration.xml", ) ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual( [ x["@value"] for x in ids_file.specifications[0].requirements.terms[0].node["value"]["restriction"][0]["enumeration"] ], ["testA", "testB"], ) # TODO actual test of validation result # self.assertTrue( ) def test_validate_restrictions_boundsInclusive(self): return # TODO IDS_URL = os.path.join( os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property_with_restriction_bounds.xml" ) ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["value"]["restriction"][0]["minInclusive"]["@value"], "0", ) # TODO actual test of validation result # self.assertTrue( ) def test_validate_restrictions_boundsExclusive(self): # TODO pass def test_validate_restrictions_pattern_simple(self): return # TODO IDS_URL = os.path.join( os.path.dirname(__file__), "Sample-BIM-Files/IDS/", "IDS_Wall_needs_property_with_restriction_pattern.xml" ) ids_file = ids.ids.open(IDS_URL) self.assertEqual(ids_file.specifications[0].requirements.terms[0].node["name"]["simpleValue"], "Test_Parameter") self.assertEqual( ids_file.specifications[0].requirements.terms[0].node["value"]["restriction"][0]["pattern"]["@value"], "[A-Z]{2,4}", ) # TODO actual test of validation result # self.assertTrue( ) class TestIdsReporting(unittest.TestCase): def test_simple_report(self): return # TODO # Same test as in validation... ids_file = ids.ids.open(IDS_URL) report = ids.SimpleHandler() logger.addHandler(report) ids_file.validate(ifc_file, logger) self.assertEqual(len(report.statements), 5) logger.handlers.pop() def test_bcf_report(self): return # TODO ids_file = ids.ids.open(IDS_URL) fn = os.path.join(tempfile.gettempdir(), "test.bcf") bcf_handler = ids.BcfHandler(project_name="Default IDS Project", author="your@email.com", filepath=fn) logger.addHandler(bcf_handler) ids_file.validate(ifc_file, logger) my_bcfxml = bcfxml.load(fn) topics = my_bcfxml.get_topics() self.assertEqual(len(topics), 5) logger.handlers.pop() if __name__ == "__main__": try: unittest.main() except: pass with open("spec.md", "w") as f: for c in case.cases: write = functools.partial(print, file=f) write("##", c.name) write() write("~~~xml") write(c.ids_content) write("~~~") write() write(f"[{c.ids_filename}]({c.ids_filename})") write() write("~~~lua") write(c.ifc_content) write("~~~") write() write(f"[{c.ifc_filename}]({c.ifc_filename})") write() write("Expected result:", c.expected_result) write()