ifcopenshell.api.resource.unassign_resource

Module Contents

ifcopenshell.api.resource.unassign_resource.unassign_resource(file, relating_resource=None, related_object=None) → None

Removes the relationship between a resource and object

Parameters:

• relating_resource (ifcopenshell.entity_instance) – The IfcResource to assign the object to.

• related_object (ifcopenshell.entity_instance) – The IfcProduct or IfcActor to assign to the object.

Returns:

The newly created IfcRelAssignsToResource

Return type:

ifcopenshell.entity_instance

Example:

# Add our own crew
crew = ifcopenshell.api.run("resource.add_resource", model, ifc_class="IfcCrewResource")

# Add some a tower crane to our crew.
crane = ifcopenshell.api.run("resource.add_resource", model,
    parent_resource=crew, ifc_class="IfcConstructionEquipmentResource", name="Tower Crane 01")

# Our tower crane will be placed via this physical product.
product = ifcopenshell.api.run("root.create_entity", model,
    ifc_class="IfcBuildingElementProxy", predefined_type="CRANE")

# Let's assign our crane to the resource. The crane now represents
# the resource.
ifcopenshell.api.run("resource.assign_resource", model,
    relating_resource=crane, related_object=product)

# Undo it.
ifcopenshell.api.run("resource.unassign_resource", model,
    relating_resource=crane, related_object=product)