# 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 . class Usecase: def __init__(self, file, role=None): """Removes a role People and organisations using the role will be untouched. This may leave some of them without roles. :param role: The IfcActorRole to remove. :type role: ifcopenshell.entity_instance.entity_instance :return: None :rtype: None Example: .. code:: python organisation = ifcopenshell.api.run("owner.add_organisation", model, identification="AWB", name="Architects Without Ballpens") role = ifcopenshell.api.run("owner.add_role", model, assigned_object=organisation, role="ARCHITECT") # After running this, the organisation will have no role again ifcopenshell.api.run("owner.remove_role", model, role=role) """ self.file = file self.settings = {"role": role} def execute(self): for inverse in self.file.get_inverse(self.settings["role"]): if inverse.is_a() in ("IfcOrganization", "IfcPerson", "IfcPersonAndOrganization"): if inverse.Roles == (self.settings["role"],): inverse.Roles = None elif inverse.is_a("IfcResourceLevelRelationship") and not inverse.is_a("IfcOrganizationRelationship"): if inverse.RelatedResourceObjects == (self.settings["organisation"],): self.file.remove(inverse) self.file.remove(self.settings["role"])