# IfcOpenShell - IFC toolkit and geometry engine # Copyright (C) 2021 Dion Moult # # 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 ifcopenshell import ifcopenshell.util.element def remove_classification(file: ifcopenshell.file, classification: ifcopenshell.entity_instance) -> None: """Removes an IfcClassification from the project and all references The classification and all of its relationships, children references, and relationships between objects and child references are completely removed from a project. :param classification: The IfcClassification entity you want to remove :type classification: ifcopenshell.entity_instance :return: None :rtype: None Example: .. code:: python classification = model.by_type("IfcClassification")[0] ifcopenshell.api.run("classification.remove_classification", model, classification=classification) """ usecase = Usecase() usecase.file = file usecase.settings = {"classification": classification} return usecase.execute() class Usecase: def execute(self): references = self.get_references(self.settings["classification"]) for reference in references: self.file.remove(reference) self.file.remove(self.settings["classification"]) for rel in self.file.by_type("IfcRelAssociatesClassification"): if not rel.RelatingClassification: history = rel.OwnerHistory self.file.remove(rel) if history: ifcopenshell.util.element.remove_deep2(self.file, history) if self.file.schema != "IFC2X3": for rel in self.file.by_type("IfcExternalReferenceRelationship"): if not rel.RelatingReference: self.file.remove(rel) def get_references(self, classification: ifcopenshell.entity_instance) -> list[ifcopenshell.entity_instance]: results = [] if self.file.schema == "IFC2X3": for reference in self.file.by_type("IfcClassificationReference"): if reference.ReferencedSource == classification: results.append(reference) else: for reference in classification.HasReferences: results.append(reference) results.extend(self.get_references(reference)) return results