ifcopenshell.api.owner.remove_role

Module Contents

ifcopenshell.api.owner.remove_role.remove_role(file: ifcopenshell.file, role: ifcopenshell.entity_instance) → None

Removes a role

People and organisations using the role will be untouched. This may leave some of them without roles.

Parameters:

role (ifcopenshell.entity_instance) – The IfcActorRole to remove.

Returns:

None

Return type:

None

Example:

organisation = ifcopenshell.api.owner.add_organisation(model,
    identification="AWB", name="Architects Without Ballpens")
role = ifcopenshell.api.owner.add_role(model, assigned_object=organisation, role="ARCHITECT")

# After running this, the organisation will have no role again
ifcopenshell.api.owner.remove_role(model, role=role)