ifcopenshell.api.owner.unassign_actor#

Module Contents#

class ifcopenshell.api.owner.unassign_actor.Usecase(file, relating_actor=None, related_object=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.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)
execute(self)#