ifcopenshell.api.material.remove_constituent

Module Contents

ifcopenshell.api.material.remove_constituent.remove_constituent(file: ifcopenshell.file, constituent: ifcopenshell.entity_instance) → None

Removes a constituent from a constituent set

Note that it is invalid to have zero items in a set, so you should leave at least one constituent to ensure a valid IFC dataset.

Parameters:

constituent (ifcopenshell.entity_instance) – The IfcMaterialConstituent entity you want to remove

Returns:

None

Return type:

None

Example:

# Create a material set for windows made out of aluminium and glass.
material_set = ifcopenshell.api.material.add_material_set(model,
    name="Window", set_type="IfcMaterialConstituentSet")

aluminium = ifcopenshell.api.material.add_material(model, name="AL01", category="aluminium")
glass = ifcopenshell.api.material.add_material(model, name="GLZ01", category="glass")

# Now let's use those materials as two constituents in our set.
framing = ifcopenshell.api.material.add_constituent(model,
    constituent_set=material_set, material=aluminium)
glazing = ifcopenshell.api.material.add_constituent(model,
    constituent_set=material_set, material=glass)

# Let's remove the glass constituent. Note that we should not remove
# the framing, at this would mean there are no constituents which is
# invalid.
ifcopenshell.api.material.remove_constituent(model, constituent=glazing)