mirror of
https://github.com/IfcOpenShell/IfcOpenShell.git
synced 2026-08-06 07:51:47 +00:00
Petru Conduraru
1bcd7d2fc6
The ifc5d IfcOpenShell (geometry-based) Qto engine computed Qto_CoveringBaseQuantities using axis-agnostic heuristics: - GrossArea/NetArea: gross_get_max_side_area / net_get_max_side_area, the largest of the X/Y/Z projected side areas. - Width: gross_get_min_xyz, the smallest of the X/Y/Z dimensions. The Blender Qto engine instead already used EPset_Parametric.LayerSetDirection (AXIS2 for wall-like coverings, AXIS3 for floor/ceiling-like coverings) to pick the correct axis via get_covering_gross_area/get_covering_net_area/get_covering_width in bonsai/bim/module/qto/calculator.py. For any covering whose length isn't the largest dimension (e.g. a short wall-covering strip, or a small covering patch), the two engines' heuristics can pick different faces/axes entirely, giving different Width/Area values for the same element - this is what was reported in #6728. Fix: give the IfcOpenShell engine the same layer-set-direction awareness. Added IfcOpenShell.get_covering_parametric_axis/ get_covering_area/get_covering_width (dispatched as internal functions, like the existing get_weight/get_segment_length), and wired gross_get_covering_area/net_get_covering_area/ gross_get_covering_width into the IfcCovering rules in IFC4QtoBaseQuantities.json and IFC4X3QtoBaseQuantities.json. The AXIS2 area/width formulas (get_side_area, net_get_y) intentionally match the simpler formulas already used for Qto_WallBaseQuantities in this same rule set (net_get_side_area/net_get_y), rather than replicating the Blender engine's more elaborate get_lateral_area/ get_width (min(X,Y)) helpers, consistent with how the two engines already diverge for regular walls without being considered a bug. Verified with a standalone script driving ifc5d.qto.IfcOpenShell directly against synthetic AXIS2/AXIS3 IfcCovering geometry: for typical proportions old and new formulas agree, and for disproportionate coverings (thin dimension not the smallest/largest) the old formulas picked the wrong axis while the new ones correctly track the covering's LayerSetDirection, matching the Blender engine. Did not verify through the full Blender/Bonsai UI, as it would have required registering the addon in the machine's shared Blender profile, which is unsafe while other agents may have it loaded. Generated with the assistance of an AI coding tool.
IfcOpenShell
IfcOpenShell is an open source (LGPL) software library for working with Industry Foundation Classes (IFC). Complete parsing support is provided for IFC2x3 TC1, IFC4 Add2 TC1, IFC4x1, IFC4x2, and IFC4x3 Add2. Extensive geometric support is implemented for the IFC releases IFC2x3 TC1 and IFC4 Add2 TC1. Extending with support for arbitrary IFC schemas is possible at compile-time when using C++ and at run-time when using Python.
In addition to a C++ and Python API, IfcOpenShell comes with an ecosystem of tools, notably including IfcConvert (an application to convert IFC models to other formats), Bonsai (an add-on to Blender providing a graphical IFC authoring platform), and many other libraries, CLI apps, and more. Support is also provided for auxiliary standards such as BCF and IDS.
For more information, see:
Development is sponsored through your generous donations!
Contents
| Name | Description | License | Service |
|---|---|---|---|
| bcf | Library to read and write BCF-XML and query OpenCDE BCF-API modules | LGPL-3.0-or-later |   |
| bonsai | Add-on to Blender providing a graphical native IFC authoring platform | GPL-3.0-or-later |    |
| bsdd | Library to query the bSDD API | LGPL-3.0-or-later |  |
| ifc2ca | Utility to convert IFC structural analysis models to Code_Aster | LGPL-3.0-or-later | |
| ifc4d | Convert to and from IFC and project management software | LGPL-3.0-or-later |  |
| ifc5d | Report and optimise cost information from IFC | LGPL-3.0-or-later |  |
| ifcbimtester | Wrapper for Gherkin based unit testing for IFC models | LGPL-3.0-or-later | |
| ifcblender | Historic Blender IFC import add-on | LGPL-3.0-or-later* | |
| ifccityjson | Convert CityJSON to IFC | LGPL-3.0-or-later |  |
| ifcclash | Clash detection library and CLI app | LGPL-3.0-or-later |  |
| ifcconvert | CLI app to convert IFC to many other formats | LGPL-3.0-or-later* |   |
| ifccsv | Library and CLI app to export and import schedules from IFC | LGPL-3.0-or-later |  |
| ifcdiff | Compare changes between IFC models | LGPL-3.0-or-later |  |
| ifcedit | CLI wrapper for ifcopenshell.api IFC model mutation functions | LGPL-3.0-or-later |  |
| ifcfm | Extract IFC data for FM handover requirements | LGPL-3.0-or-later |  |
| ifcmax | Historic extension for IFC support in 3DS Max | LGPL-3.0-or-later* | |
| ifcmcp | MCP server for querying and editing IFC building models | LGPL-3.0-or-later |  |
| ifcopenshell-python | Python library for IFC manipulation | LGPL-3.0-or-later* |         |
| ifcpatch | Utility to run pre-packaged scripts to manipulate IFCs | LGPL-3.0-or-later |  |
| ifcquery | CLI tool for querying and inspecting IFC building models | LGPL-3.0-or-later |  |
| ifcsverchok | Blender Add-on for visual node programming with IFC | GPL-3.0-or-later |  |
| ifctester | Library, CLI and webapp for IDS model auditing | LGPL-3.0-or-later |  |
The IfcOpenShell C++ codebase is split into multiple interal libraries:
| Name | Description | License |
|---|---|---|
| ifcgeom | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcgeom_schema_agnostic | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcgeomserver | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcjni | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcparse | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcwrap | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| qtviewer | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| serializers | Internal library for IfcOpenShell | LGPL-3.0-or-later* |