Skip to main content

connect_with_realizing_elements

Function connect_with_realizing_elements 

Source
pub fn connect_with_realizing_elements(
    tx: &mut Transaction,
    model: &Model,
    global_id: &str,
    relating: EntityId,
    related: EntityId,
    realizing: &[EntityId],
) -> SpatialAuthoringResult<EntityId>
Expand description

Stage an IfcRelConnectsWithRealizingElements.

The realizing elements are what physically make the connection – a weld, a bolt, a bracket.

Bound to the model’s declared release (#213): the record is laid out by attribute name with the release’s nine attributes (ConnectionGeometry and ConnectionType unset). OwnerHistory is left $, which IFC4 and IFC4X3 allow and IFC2X3 does not; in IFC2X3 use connect_with_realizing_elements_with_owner_history.

§Errors

Refuses a malformed GlobalId, an element connected to itself, and an empty realizing set: the subtype exists precisely to name those elements, so omitting them makes it an IfcRelConnectsElements wearing the wrong type name. A header binding no single verified release (MultipleSchemas, UnsupportedSchema) and an IFC2X3 model (AuthoringRequired) are refused. Nothing is staged on an error.