ifcopenshell.api.owner.unassign_actor

Module Contents

ifcopenshell.api.owner.unassign_actor.unassign_actor(file, relating_actor=None, related_object=None) → None

Unassigns an actor to an object

This means that the actor is no longer responsible for the object.

Parameters:
Returns:

The updated IfcRelAssignsToActor relationship or none if there is no more valid relationship.

Return type:

None, ifcopenshell.entity_instance

Example:

# We need to procure and install 2 of this particular pump type in our facility.
pump_type = ifcopenshell.api.run("root.create_entity", model, ifc_class="IfcPumpType")

# Define who the manufacturer is
manufacturer = ifcopenshell.api.run("owner.add_organisation", model,
    identification="PWP", name="Pumps With Power")
ifcopenshell.api.run("owner.add_role", model, assigned_object=manufacturer, role="MANUFACTURER")

# Make the manufacturer responsible for that pump type.
ifcopenshell.api.run("owner.assign_actor", model,
    relating_actor=manufacturer, related_object=pump_type)

# Undo the assignment
ifcopenshell.api.run("owner.unassign_actor", model,
    relating_actor=manufacturer, related_object=pump_type)