Skip to content

ifc-georef ​

Georeferencing: map conversion, coordinate reference systems, site placement.

StatusImplemented
Latest release0.8.3 (2026-11-09)
Registriescrates.io ifc-georef
Via the facadeopenbim-ifc feature georef
API documentationrustdoc · docs.rs
Sourcecrates/ifc-georef/

Overview ​

IFC project-to-map coordinate operations.

This crate resolves IFC references, units, axis defaults, and CRS metadata into plain-number operation parameters and, with the default transform feature, a format-neutral axiolid_core::Transform3. It does not place products, reproject coordinates, or select a geometry backend.

IFC4 and IFC4X3 state georeferencing as IfcCoordinateOperation entities (resolve_project_to_map); IFC2X3, which declares none, as the ePSet_MapConversion and ePSet_ProjectedCRS property sets of the buildingSMART geo-referencing guide (resolve_property_set_georeferencing). Both resolve to the same ProjectToMap; the declared release decides which is read.

Features ​

FeatureDefaultEnables
ifc2x3yesifc-schema/ifc2x3
ifc4yesifc-schema/ifc4
ifc4x1yesifc-schema/ifc4x1
ifc4x2yesifc-schema/ifc4x2
ifc4x3yesifc-schema/ifc4x3
transformyesdep:axiolid-core

Depends on ​

Changes ​

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

Added (#690) ​

  • GeorefError::RecordDamaged, the refusal for a CRS, coordinate-operation or IFC2X3 property-set record the reader reported. UnitRecordDamaged stays for unit records; RecordsIncomplete covers diagnostics that may hide any record georeferencing reads, units included.

Fixed (#690) ​

  • resolve_project_to_map, resolve_project_to_map_in, resolve_geographic_offset_in and resolve_property_set_georeferencing check, against ifc_model::RecordDamage, every record they read besides units, and refuse a reported one with RecordDamaged naming it. Each record is checked before it is read or filtered on, so a damaged copy cannot steer the choice: the operation (before its type and coordinates), its source, every operation scanned for HasCoordinateOperation, the CRS, every IfcWellKnownText scanned, and in IFC2X3 every IfcRelDefinesByProperties scanned, its property set, each related host and each IfcPropertySingleValue. One Damage is built per entry point.
  • A skip naming a held id elsewhere is refused as RecordsIncomplete, and so is an empty IFC2X3 host list when a record was skipped and an ePSet_MapConversion or ePSet_ProjectedCRS set is present.
  • The facade's presence gate before the property-set entry point is #695. Semver: patch.

Added (#686) ​

  • GeorefError::UnitRecordDamaged and GeorefError::RecordsIncomplete, the refusals for a unit record the reader reported and for diagnostics that may hide a record georeferencing reads.

Fixed (#686) ​

  • The CRS unit resolver reads Model::diagnostics() through ifc_model::RecordDamage, so the public entry points that resolve a CRS unit refuse a damaged lenient model instead of using whichever unit record the reader kept: resolve_project_to_map(_in), the projected and geographic CRS readers (including their angle and height units) and resolve_property_set_georeferencing. A reported unit record (a duplicate id, or a skip with that id) is refused by name; an unclassified diagnostic, a skip or duplicate without an id, or a skip naming a held id is refused as incomplete. The CRS, operation and property-set records themselves are covered by #690. Semver: patch.

Full history: crates/ifc-georef/CHANGELOG.md

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