Doc clarification for api.feature.remove_feature

Generated with the assistance of an AI coding tool.
This commit is contained in:
Bruno Postle
2026-03-20 20:51:19 +00:00
parent 4c1f79f6ab
commit 49bda7d8ba
@@ -22,11 +22,13 @@ import ifcopenshell.util.element
def remove_feature(file: ifcopenshell.file, feature: ifcopenshell.entity_instance) -> None: def remove_feature(file: ifcopenshell.file, feature: ifcopenshell.entity_instance) -> None:
"""Remove a feature """Permanently delete a feature element and its void or projection relationship.
Fillings are retained as orphans. Featured elements remain. Features The feature entity (e.g. IfcOpeningElement) is removed from the model
cannot exist by themselves, so not only is the relationship removed, the along with its IfcRelVoidsElement or IfcRelProjectsElement relationship.
feature is also removed. The host element (wall, slab, etc.) is unaffected. Any fillings (windows,
doors) that occupied the opening become orphaned and must be separately
deleted via root.remove_product.
:param feature: The IfcFeatureElement to remove. :param feature: The IfcFeatureElement to remove.