ifcopenshell.api.void.remove_filling

Module Contents

ifcopenshell.api.void.remove_filling.remove_filling(file, element=None) → None

Remove a filling relationship

If an element is filling an opening, this removes the relationship such that the opening and element both still exist, but the element no longer fills the opening.

Parameters:

element (ifcopenshell.entity_instance) – The element filling an opening.

Returns:

None

Return type:

None

Example:

# Create a wall
wall = ifcopenshell.api.run("root.create_entity", model, ifc_class="IfcWall")

# Create an opening, such as for a service penetration with fire and
# acoustic requirements.
opening = ifcopenshell.api.run("root.create_entity", model, ifc_class="IfcOpeningElement")

# Create a door
door = ifcopenshell.api.run("root.create_entity", model, ifc_class="IfcDoor")

# The door will now fill the opening.
ifcopenshell.api.run("void.add_filling", model, opening=opening, element=door)

# Not anymore!
ifcopenshell.api.run("void.remove_filling", model, element=door)