IFX core

One Rust IFC engine for native Python and browser WebAssembly. It reads IFC4 and IFC4X3 models. Geometry, properties, quantities, placements, units, materials, spatial data, and relationships come from this core.

import ifx_core

model = ifx_core.extract_ifc(open("building.ifc", "rb").read(), "high")
mesh = model["geometry"]["elements"][42]
properties = model["entities"]["entities"][42]["property_sets"]
spatial = model["model"]["spatial"]

extract_ifc uses the same Rust extraction function as WASM. It tessellates once. Python receives f64 vertex and u32 face buffers for NumPy. Separate model_data, model_data_json, entity_data, geometry_data_buffers, and geometry_data_json methods are available when only one part is needed.

Geometry and placements use absolute IFC world coordinates in metres, with Z up. The recorded RTC offset is already included. Do not add it again. Properties and quantities keep their source units. Use the reported unit scale for each dimension.

Layout

No external IFClite package is used. IFX includes an adapted source port. See ACKNOWLEDGEMENTS.md, UPSTREAM_SOURCE.json, and LICENSE. Keep the MPL terms, attribution, and matching source when you distribute a native or WASM build. Property extraction currently covers single-value properties; complex property forms are not yet supported by the imported reader.

Build and check

Python 3.10 or later and the pinned Rust toolchain are required.

uv sync --group dev --no-install-project
uv run --no-sync maturin develop --uv --release
.venv/bin/python -m pytest -m 'not corpus and not integration'
cargo test -p ifx-core
cargo clippy -p ifx-core --all-targets --all-features --no-deps -- -D warnings
./scripts/build-wasm.sh

The WASM build exports extractIfcJson(bytes, quality) and modelDataJson(bytes). The IFX TypeScript loader calls it in a Web Worker. The JSON boundary is the first implementation; large models can use more memory than the native buffer path.

Use maturin build --release --out dist for a native wheel, and maturin sdist --out dist for its matching source archive. The source archive includes the local crates and provenance file.