Skip to main content

Module connection

Module connection 

Source
Expand description

Connection-surface lowering: the surface where two elements meet.

§Why a helper and not a representation item

IfcConnectionSurfaceGeometry is not a representation item. It is what IfcRelSpaceBoundary.ConnectionGeometry and the element-connection relationships point at, and its payload is an IfcSurfaceOrFaceSurface: a bare IfcSurface, an IfcFaceSurface (or its IfcAdvancedFace subtype), or an IfcFaceBasedSurfaceModel. The select is resolved here so a consumer measuring space-boundary coverage does not re-derive it, and each member goes through the lowerer that already owns its family.

§Two ends, two coordinate systems

SurfaceOnRelatingElement is given in the relating element’s local coordinate system, the optional SurfaceOnRelatedElement in the related element’s (IFC4 ADD2 TC1, IfcConnectionSurfaceGeometry attribute definitions). One frame cannot place both, so each end has its own entry point and the caller passes the placement of the element that end belongs to. For a space boundary that is the space’s placement.

§Only surfaces

The point, curve, volume and (IFC2X3) port connection kinds are legal connection geometry but carry no surface. They are refused with a typed crate::GeometryError::Unsupported naming the connection, never substituted by a degenerate or bounding surface. Anything that is not a connection geometry at all is a wrong-type error.

Slots are identical in IFC2X3 TC1, IFC4 ADD2 TC1 and IFC4X3 ADD2: IfcConnectionGeometry declares no attributes, so SurfaceOnRelatingElement is 0 and SurfaceOnRelatedElement is 1 (data/absolute-slots.txt).

Functions§

lower_connection_surface
Lower SurfaceOnRelatingElement of an IfcConnectionSurfaceGeometry.
lower_related_connection_surface
Lower the optional SurfaceOnRelatedElement of an IfcConnectionSurfaceGeometry.