V3_Conv is a high-performance conversion utility designed to transform IFC (Industry Foundation Classes) building models into the optimized Fragment (.frag) format.
This tool is a core component of the Antigravity ecosystem, enabling massive BIM models to be visualized efficiently in environments like Power BI through optimized geometry and side-loading.
The converter uses a headless Node.js environment powered by the @thatopen (formerly OpenBIM) stack:
sequenceDiagram
participant FS as File System
participant IFC as web-ifc (WASM)
participant OBC as @thatopen/components
participant FRAG as Fragment Manager
participant CHK as Chunker (Python)
FS->>IFC: Load model.ifc
IFC->>OBC: Parse Geometry & Data
OBC->>FRAG: Generate Fragments (.frag)
FRAG->>FS: Save model_v3.frag
FS->>CHK: (Optional) Binary Chunking
CHK->>FS: Ready for Side-Loading
- V3 Fragment Support: Utilizes the latest
@thatopen/componentsfor maximum compatibility and performance. - Headless Processing: Custom polyfills (JSDOM-less) for Node.js to enable 3D libraries to run without a browser.
- Data Optimization: Automatic coordinate centering and profile optimization to reduce file size.
- Python Integration: Includes a binary chunking utility (
chunker.py) for preparing models for Power BI's data limits.
- Node.js
- Python 3.x (Optional, for chunking)
npm install- Place your
model.ifcin the root folder. - Run the V3 conversion script:
node convert_v3.jsThe output model_v3.frag will be generated, ready for the Antigravity viewer.
- Geometry Engine: web-ifc
- Component System: @thatopen/components
- Runtime: Node.js & Three.js
- Post-Processing: Python
V3_Conv relies on the work of the following communities and contributors:
- ThatOpen/web-ifc — For the high-performance building model parsing engine.
- ThatOpen/openbim-components — Forkable framework for 3D BIM components and fragments.
- Three.js — For the geometry engine and 3D environment.
- IFC-Lite (Licensed under MPL-2.0) — By Louis True. Research and patterns relating to side-loading fragments and binary chunking in Power BI.
MIT