ifc-georef
Georeferencing: map conversion, coordinate reference systems, site placement.
| Status | Implemented |
| Latest release | 0.8.3 (2026-11-09) |
| Registries | crates.io ifc-georef |
| Via the facade | openbim-ifc feature georef |
| API documentation | rustdoc · docs.rs |
| Source | crates/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
| Feature | Default | Enables |
|---|---|---|
ifc2x3 | yes | ifc-schema/ifc2x3 |
ifc4 | yes | ifc-schema/ifc4 |
ifc4x1 | yes | ifc-schema/ifc4x1 |
ifc4x2 | yes | ifc-schema/ifc4x2 |
ifc4x3 | yes | ifc-schema/ifc4x3 |
transform | yes | dep: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.UnitRecordDamagedstays for unit records;RecordsIncompletecovers diagnostics that may hide any record georeferencing reads, units included.
Fixed (#690)
resolve_project_to_map,resolve_project_to_map_in,resolve_geographic_offset_inandresolve_property_set_georeferencingcheck, againstifc_model::RecordDamage, every record they read besides units, and refuse a reported one withRecordDamagednaming 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 forHasCoordinateOperation, the CRS, everyIfcWellKnownTextscanned, and in IFC2X3 everyIfcRelDefinesByPropertiesscanned, its property set, each related host and eachIfcPropertySingleValue. OneDamageis 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 anePSet_MapConversionorePSet_ProjectedCRSset is present. - The facade's presence gate before the property-set entry point is #695. Semver: patch.
Added (#686)
GeorefError::UnitRecordDamagedandGeorefError::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()throughifc_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) andresolve_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