Bonsai Implementation: BIM Modeling

Version: Bonsai v0.8.x | Blender 4.2.0+ | Python 3.11 Module path: bonsai.bim.module.model — NEVER blenderbim.* Data layer: All IFC operations use ifcopenshell.api.run()

1. Critical Warnings

1. ALWAYS use bonsai.* — NEVER blenderbim.*. The rename occurred in 2024 (v0.8.0).
2. ALWAYS check IfcStore.get_file() for None before any IFC operation.
3. ALWAYS verify representation context exists before creating geometry.
4. ALWAYS use spatial.assign_container for placing elements in storeys — NEVER aggregate.assign_object.
5. ALWAYS use feature.add_feature for openings — NEVER void.add_opening (does not exist in v0.8.0+).
6. ALWAYS pass lists to related_objects / products parameters — NEVER single entities.
7. ALWAYS call bpy.ops.bim.edit_object_placement() after moving Blender objects to sync IFC placement.
8. NEVER treat Bonsai as an importer/exporter — IFC IS the native document.

2. Element Creation Pipeline