Module Contents#

class ifcopenshell.api.system.disconnect_port.Usecase(file, port=None)#

Disconnects a port from any other port

A port may only be connected to one other port, so the other port is not needed to be specified.


port (ifcopenshell.entity_instance.entity_instance) – The IfcDistributionPort to disconnect.



Return type



# A completely empty distribution system
system = ifcopenshell.api.run("system.add_system", model)

# Create a duct and a 90 degree bend fitting
duct = ifcopenshell.api.run("root.create_entity", model,
    ifc_class="IfcDuctSegment", predefined_type="RIGIDSEGMENT")
fitting = ifcopenshell.api.run("root.create_entity", model,
    ifc_class="IfcDuctFitting", predefined_type="BEND")

# The duct and fitting is part of the system
ifcopenshell.api.run("system.assign_system", model, product=duct, system=system)
ifcopenshell.api.run("system.assign_system", model, product=fitting, system=system)

# Create 2 ports, one for either end of both the duct and fitting.
duct_port1 = ifcopenshell.api.run("system.add_port", model, element=duct)
duct_port2 = ifcopenshell.api.run("system.add_port", model, element=duct)
fitting_port1 = ifcopenshell.api.run("system.add_port", model, element=fitting)
fitting_port2 = ifcopenshell.api.run("system.add_port", model, element=fitting)

# Connect the duct and fitting together. At this point, we have not
# yet determined the direction of the flow, so we leave direction as
ifcopenshell.api.run("system.connect_port", model, port1=duct_port2, port2=fitting_port1)

# Disconnect the port. note we could've equally disconnected
# fitting_port1 instead of duct_port2
ifcopenshell.api.run("system.disconnect_port", model, port=duct_port2)