Skip to main content

Crate ifc_georef

Crate ifc_georef 

Source
Expand description

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

  • transform (default): links axiolid-core and adds ProjectToMap::transform and compose_project_frame. With default-features = false the crate links no geometry crate and still exposes every resolved parameter: CRS metadata and units, eastings, northings and height, axis direction, scale and IFC4X3 factors, the affine parts through ProjectToMap::map_point, true and grid north, operation sources and the site reference.

Re-exports§

pub use authoring::create_angular_rigid_operation;
pub use authoring::create_direction;
pub use authoring::create_geographic_crs;
pub use authoring::create_map_conversion;
pub use authoring::create_map_conversion_scaled;
pub use authoring::create_projected_crs;
pub use authoring::create_representation_context;
pub use authoring::create_representation_subcontext;
pub use authoring::create_rigid_operation;
pub use authoring::create_well_known_text;
pub use authoring::GeographicCrsDraft;
pub use authoring::MapConversionDraft;
pub use authoring::ProjectedCrsDraft;

Modules§

authoring
Transactional authoring of the georeferencing entities.

Structs§

AngleUnit
A plane-angle unit reduced to a radian factor, as an IFC4X3 IfcGeographicCRS.AngleUnit declares it.
CompoundPlaneAngle
An IfcCompoundPlaneAngleMeasure as authored: signed integer degrees, minutes, seconds and optional millionths of a second.
GeographicCrs
A geographic coordinate reference system read from IFC4X3 IfcGeographicCRS.
GeographicOffset
An IFC4X3 IfcRigidOperation with plane-angle coordinates, read as authored.
GeorefView
A model whose declared schema has been pinned to IFC4 or IFC4X3.
LengthUnit
A length unit reduced to a metre factor.
ProjectToMap
A resolved project-to-map coordinate operation, normalised to metres.
ProjectedCrs
A projected coordinate reference system read from IfcProjectedCRS.
SiteElevationComparison
Both heights of the site origin, in metres, and how far apart they are.
SiteReference
The WGS84 reference point an IfcSite states for its placement origin.

Enums§

GeorefError
Why a project-to-map operation could not be resolved losslessly.
NorthReference
A resolved north reference: a unit-length 2D direction in the project’s own XY plane, plus which reference it names.
OperationKind
Which coordinate-operation subtype a ProjectToMap was lowered from.
OperationSource
The validated SourceCRS of a coordinate operation.
SiteElevationCheck
How IfcSite.RefElevation relates to the map conversion’s height.

Constants§

MAP_CONVERSION_PSET
The property set standing for IfcMapConversion (guide Table 3).
PROJECTED_CRS_PSET
The property set standing for IfcProjectedCRS (guide Table 4).
SITE_ELEVATION_TOLERANCE_M
Suggested tolerance, in metres, for relate_site_elevation: 1 cm.

Functions§

compose_project_frame
Compose an externally supplied project frame with a resolved project-to-map operation, producing the project frame’s map-frame transform.
coordinate_operation_for
The one coordinate operation whose SourceCRS is source: the HasCoordinateOperation inverse, read in a schema-pinned view.
grid_north_direction
Resolve grid north from an already-computed IfcMapConversion operation.
has_property_set_georeferencing
Whether model holds any IfcPropertySet named ePSet_MapConversion or ePSet_ProjectedCRS (ignoring ASCII case), attached or not.
project_north_direction
The project’s own north reference: always (0, 1) in its own XY plane.
relate_site_elevation
Relate site.ref_elevation to map’s OrthogonalHeight and the target CRS’s VerticalDatum.
resolve_geographic_offset_in
Read an IFC4X3 IfcRigidOperation whose coordinates are plane angles.
resolve_operation_source
Read and validate the SourceCRS of the coordinate operation operation in a schema-pinned view.
resolve_project_to_map
Resolve a project-to-map coordinate operation and normalize both frames to metres.
resolve_project_to_map_in
Resolve a project-to-map coordinate operation within a schema-pinned GeorefView.
resolve_property_set_georeferencing
Every IFC2X3 property-set georeferencing of model, resolved to project-to-map parameters: one for the IfcProject, or else one per IfcSite carrying the sets, in ascending host id.
resolve_true_north
Resolve IfcGeometricRepresentationContext.TrueNorth.
site_reference
Read the reference point of the IfcSite site.

Type Aliases§

GeorefResult
Result of a georeferencing read, carrying GeorefError on failure.