Skip to content

openbim-ifc-py ​

Python bindings for openbim-ifc: read, edit and write IFC STEP files from Python.

StatusImplemented
Latest release0.16.0 (2026-11-09)
RegistriesPyPI openbim-ifc
API documentationrustdoc
Sourcecrates/openbim-ifc-py/

Overview ​

Python bindings for the IFC facade (ADR 0013, #39).

The compiled module is openbim_ifc._native; the public API is the pure Python package openbim_ifc, which wraps it and defines the value classes. Values cross as plain dicts in the tagged encoding shared with the WASM and C bindings; openbim_ifc turns them into frozen dataclasses.

This crate adds calling-convention glue only. IFC behaviour belongs in openbim-ifc, shared binding behaviour in openbim-ifc-binding-core.

Features ​

FeatureDefaultEnables
graphopenbim-ifc-binding-core/graph
meshopenbim-ifc-binding-core/mesh
rusty_allocdep:rusty_alloc-api, dep:rusty_alloc

Depends on ​

Changes ​

Latest release, 0.16.0 (2026-11-09):

Changed (wire format 1.5) ​

  • The geometry graph payload (#367) may be Axiolid's wire format 1.5, written only when a graph holds a ruled surface (axiolid/kernel#402); every other graph keeps its version. The newest version the build advertises (GEOMETRY_FORMAT_VERSION) is "1.5". A reader on axiolid-model 0.3.17 or older refuses 1.5.

Added (#603) ​

  • SurfaceColour.source can be "materialSet": source_entity is the set (IfcMaterialLayerSet, IfcMaterialProfileSet, IfcMaterialConstituentSet or IfcMaterialList, or a usage of one (IfcMaterialLayerSetUsage, IfcMaterialProfileSetUsage and its Tapering)) whose materials all state the colour, and the new source_materials (a tuple, last field) lists the materials of the set that colour the item: every one, or the constituents its shape aspects name (ascending id, distinct); () for other sources.

Semver: minor (pre-1.0 breaking: a record field is added).

Changed (#651) ​

  • representation accepts "Reference", the void geometry of an IFC4 Reference View opening.

Semver: patch (additive).

Changed (#614) ​

  • A diagnostic string with a position reads "warning at line L, column C (bytes a..b): ...".

Semver: patch (Display text changes)

Fixed (#617) ​

  • The first id handed out after a read is above every declared and referenced id, so a new entity never takes the id of a dangling reference or a skipped record.

Semver: patch

Full history: crates/openbim-ifc-py/CHANGELOG.md

Dual-licensed under AGPL-3.0-or-later or a commercial licence. ISO and CEN standards material is not redistributed.