mirror of
https://github.com/IfcOpenShell/IfcOpenShell.git
synced 2026-08-09 09:21:46 +00:00
Dion Moult
eeac0a2e30
Previously remove_profile would purge unused materials and profiles, but remove_layer and remove_constituent wouldn't. This was as subtle inconsitency. Now everything by default consistently retains materials and profiles, and has options to change this default.
61 lines
2.8 KiB
Python
61 lines
2.8 KiB
Python
# IfcOpenShell - IFC toolkit and geometry engine
|
|
# Copyright (C) 2021 Dion Moult <dion@thinkmoult.com>
|
|
#
|
|
# This file is part of IfcOpenShell.
|
|
#
|
|
# IfcOpenShell is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU Lesser General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# IfcOpenShell is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU Lesser General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public License
|
|
# along with IfcOpenShell. If not, see <http://www.gnu.org/licenses/>.
|
|
import ifcopenshell.util.element
|
|
|
|
|
|
def remove_layer(
|
|
file: ifcopenshell.file, layer: ifcopenshell.entity_instance, should_remove_material: bool = False
|
|
) -> None:
|
|
"""Removes a layer from a layer set
|
|
|
|
Note that it is invalid to have zero items in a set, so you should leave
|
|
at least one layer to ensure a valid IFC dataset.
|
|
|
|
:param layer: The IfcMaterialLayer entity you want to remove
|
|
:param should_remove_material: If true, materials with no users will be removed
|
|
|
|
Example:
|
|
|
|
.. code:: python
|
|
|
|
# Create a material set for steel stud partition walls.
|
|
material_set = ifcopenshell.api.material.add_material_set(model,
|
|
name="Window", set_type="IfcMaterialConstituentSet")
|
|
|
|
gypsum = ifcopenshell.api.material.add_material(model, name="PB01", category="gypsum")
|
|
steel = ifcopenshell.api.material.add_material(model, name="ST01", category="steel")
|
|
|
|
# Now let's use those materials as three layers in our set, such
|
|
# that the steel studs are sandwiched by the gypsum. Let's imagine
|
|
# we're setting the layer thickness in millimeters.
|
|
layer1 = ifcopenshell.api.material.add_layer(model, layer_set=material_set, material=gypsum)
|
|
ifcopenshell.api.material.edit_layer(model, layer=layer1, attributes={"LayerThickness": 13})
|
|
layer2 = ifcopenshell.api.material.add_layer(model, layer_set=material_set, material=steel)
|
|
ifcopenshell.api.material.edit_layer(model, layer=layer2, attributes={"LayerThickness": 92})
|
|
layer3 = ifcopenshell.api.material.add_layer(model, layer_set=material_set, material=gypsum)
|
|
ifcopenshell.api.material.edit_layer(model, layer=layer3, attributes={"LayerThickness": 13})
|
|
|
|
# Let's remove the last layer, such that the wall might be clad only
|
|
# one one side such as to line a services riser.
|
|
ifcopenshell.api.material.remove_layer(model, layer=layer3)
|
|
"""
|
|
material = layer.Material
|
|
file.remove(layer)
|
|
if material and should_remove_material:
|
|
ifcopenshell.util.element.remove_deep2(file, subelement)
|