You can now connect, disconnect, and set flow directions of distribution ports in Blender.

src/ifcopenshell-python/ifcopenshell/util/system.py

@@ -43,3 +43,28 @@ def get_ports(element):
     for rel in element.HasPorts or []:
         results.append(rel.RelatingPort)
     return results
+
+
+def get_connected_port(port):
+    for rel in port.ConnectedTo:
+        return rel.RelatedPort
+    for rel in port.ConnectedFrom:
+        return rel.RelatingPort
+
+
+def get_connected_to(element):
+    # Note: this code is for IFC2X3. IFC4 has a different approach.
+    results = []
+    for rel in element.HasPorts:
+        for rel2 in rel.RelatingPort.ConnectedTo:
+            results.extend([r.RelatedElement for r in rel2.RelatedPort.ContainedIn if r.RelatedElement != element])
+    return results
+
+
+def get_connected_from(element):
+    # Note: this code is for IFC2X3. IFC4 has a different approach.
+    results = []
+    for rel in element.HasPorts:
+        for rel2 in rel.RelatingPort.ConnectedFrom:
+            results.extend([r.RelatedElement for r in rel2.RelatingPort.ContainedIn if r.RelatedElement != element])
+    return results

src/ifcopenshell-python/test/util/test_system.py

@@ -61,3 +61,12 @@ class TestGetPortsIFC2X3(test.bootstrap.IFC2X3):
         element = ifcopenshell.api.run("root.create_entity", self.file, ifc_class="IfcFlowSegment")
         ifcopenshell.api.run("system.assign_port", self.file, element=element, port=port)
         assert subject.get_ports(element) == [port]
+
+
+class TestGetConnectedPort(test.bootstrap.IFC4):
+    def test_run(self):
+        port1 = ifcopenshell.api.run("system.add_port", self.file)
+        port2 = ifcopenshell.api.run("system.add_port", self.file)
+        ifcopenshell.api.run("system.connect_port", self.file, port1=port1, port2=port2)
+        assert subject.get_connected_port(port1) == port2
+        assert subject.get_connected_port(port2) == port1