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): linksaxiolid-coreand addsProjectToMap::transformandcompose_project_frame. Withdefault-features = falsethe 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 throughProjectToMap::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§
- Angle
Unit - A plane-angle unit reduced to a radian factor, as an IFC4X3
IfcGeographicCRS.AngleUnitdeclares it. - Compound
Plane Angle - An
IfcCompoundPlaneAngleMeasureas authored: signed integer degrees, minutes, seconds and optional millionths of a second. - Geographic
Crs - A geographic coordinate reference system read from IFC4X3
IfcGeographicCRS. - Geographic
Offset - An IFC4X3
IfcRigidOperationwith plane-angle coordinates, read as authored. - Georef
View - A model whose declared schema has been pinned to IFC4 or IFC4X3.
- Length
Unit - A length unit reduced to a metre factor.
- Project
ToMap - A resolved project-to-map coordinate operation, normalised to metres.
- Projected
Crs - A projected coordinate reference system read from
IfcProjectedCRS. - Site
Elevation Comparison - Both heights of the site origin, in metres, and how far apart they are.
- Site
Reference - The WGS84 reference point an
IfcSitestates for its placement origin.
Enums§
- Georef
Error - Why a project-to-map operation could not be resolved losslessly.
- North
Reference - A resolved north reference: a unit-length 2D direction in the project’s own XY plane, plus which reference it names.
- Operation
Kind - Which coordinate-operation subtype a
ProjectToMapwas lowered from. - Operation
Source - The validated
SourceCRSof a coordinate operation. - Site
Elevation Check - How
IfcSite.RefElevationrelates 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
SourceCRSissource: theHasCoordinateOperationinverse, read in a schema-pinned view. - grid_
north_ direction - Resolve grid north from an already-computed
IfcMapConversionoperation. - has_
property_ set_ georeferencing - Whether
modelholds anyIfcPropertySetnamedePSet_MapConversionorePSet_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_elevationtomap’sOrthogonalHeightand the target CRS’sVerticalDatum. - resolve_
geographic_ offset_ in - Read an IFC4X3
IfcRigidOperationwhose coordinates are plane angles. - resolve_
operation_ source - Read and validate the
SourceCRSof the coordinate operationoperationin 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 theIfcProject, or else one perIfcSitecarrying the sets, in ascending host id. - resolve_
true_ north - Resolve
IfcGeometricRepresentationContext.TrueNorth. - site_
reference - Read the reference point of the
IfcSitesite.
Type Aliases§
- Georef
Result - Result of a georeferencing read, carrying
GeorefErroron failure.