118 lines
5.0 KiB
Python
118 lines
5.0 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
|
|
import ifcopenshell.guid
|
|
import ifcopenshell.util.element
|
|
|
|
|
|
def add_filling(
|
|
file: ifcopenshell.file, opening: ifcopenshell.entity_instance, element: ifcopenshell.entity_instance
|
|
) -> ifcopenshell.entity_instance:
|
|
"""Fill an opening with an element
|
|
|
|
Physical elements may have openings in them. For example, a wall might
|
|
have an opening for a door. That opening is then filled by the door.
|
|
This indicates that when the door moves, the opening will move with it.
|
|
Or if the door is removed, then the opening may remain and need to be
|
|
filled.
|
|
|
|
:param opening: The IfcOpeningElement to fill with the element.
|
|
:param element: The IfcElement to be inserted into the opening.
|
|
:return: The new IfcRelFillsElement relationship
|
|
|
|
Example:
|
|
|
|
.. code:: python
|
|
|
|
# A bit of preparation, let's create some geometric contexts since
|
|
# we want to create some geometry for our wall and opening.
|
|
model3d = ifcopenshell.api.context.add_context(model, context_type="Model")
|
|
body = ifcopenshell.api.context.add_context(model,
|
|
context_type="Model", context_identifier="Body", target_view="MODEL_VIEW", parent=model3d)
|
|
|
|
# Create a wall
|
|
wall = ifcopenshell.api.root.create_entity(model, ifc_class="IfcWall")
|
|
|
|
# Let's use the "3D Body" representation we created earlier to add a
|
|
# new wall-like body geometry, 5 meters long, 3 meters high, and
|
|
# 200mm thick
|
|
representation = ifcopenshell.api.geometry.add_wall_representation(model,
|
|
context=body, length=5, height=3, thickness=0.2)
|
|
ifcopenshell.api.geometry.assign_representation(model,
|
|
product=wall, representation=representation)
|
|
|
|
# Place our wall at the origin
|
|
ifcopenshell.api.geometry.edit_object_placement(model, product=wall)
|
|
|
|
# Create an opening, such as for a service penetration with fire and
|
|
# acoustic requirements.
|
|
opening = ifcopenshell.api.root.create_entity(model, ifc_class="IfcOpeningElement")
|
|
|
|
# Let's create an opening representation of a 950mm x 2100mm door.
|
|
# Notice how the thickness is greater than the wall thickness, this
|
|
# helps resolve floating point resolution errors in 3D.
|
|
representation = ifcopenshell.api.geometry.add_wall_representation(model,
|
|
context=body, length=.95, height=2.1, thickness=0.4)
|
|
ifcopenshell.api.geometry.assign_representation(model,
|
|
product=opening, representation=representation)
|
|
|
|
# Let's shift our door 1 meter along the wall and 100mm along the
|
|
# wall, to create a nice overlap for the opening boolean.
|
|
matrix = np.identity(4)
|
|
matrix[:,3] = [1, -.1, 0, 0]
|
|
ifcopenshell.api.geometry.edit_object_placement(model, product=opening, matrix=matrix)
|
|
|
|
# The opening will now void the wall.
|
|
ifcopenshell.api.feature.add_feature(model, feature=opening, element=wall)
|
|
|
|
# Create a door
|
|
door = ifcopenshell.api.root.create_entity(model, ifc_class="IfcDoor")
|
|
|
|
# Let's create a door representation of a 950mm x 2100mm door.
|
|
representation = ifcopenshell.api.geometry.add_wall_representation(model,
|
|
context=body, length=.95, height=2.1, thickness=0.05)
|
|
ifcopenshell.api.geometry.assign_representation(model,
|
|
product=door, representation=representation)
|
|
|
|
# Let's shift our door 1 meter along the wall and 100mm along the
|
|
# wall, which lines up with our opening.
|
|
matrix = np.identity(4)
|
|
matrix[:,3] = [1, .05, 0, 0]
|
|
ifcopenshell.api.geometry.edit_object_placement(model, product=door, matrix=matrix)
|
|
|
|
# The door will now fill the opening.
|
|
ifcopenshell.api.feature.add_filling(model, opening=opening, element=door)
|
|
"""
|
|
fills_voids = element.FillsVoids
|
|
|
|
if fills_voids:
|
|
if fills_voids[0].RelatingOpeningElement == opening:
|
|
return fills_voids[0]
|
|
history = fills_voids[0].OwnerHistory
|
|
file.remove(fills_voids[0])
|
|
if history:
|
|
ifcopenshell.util.element.remove_deep2(file, history)
|
|
|
|
return file.create_entity(
|
|
"IfcRelFillsElement",
|
|
GlobalId=ifcopenshell.guid.new(),
|
|
RelatingOpeningElement=opening,
|
|
RelatedBuildingElement=element,
|
|
)
|