Skip to main content

Module mapped

Module mapped 

Source
Expand description

Mapped-item instancing: reuse one lowered subtree under many transforms.

§Why this preserves instancing

A mapped item is IFC’s only first-class instancing mechanism. A furniture family placed 400 times is authored once as an IfcRepresentationMap and referenced by 400 IfcMappedItems. Flattening that into 400 copies of the geometry is the single most expensive mistake an importer can make, so the lowered form keeps the shared subtree and emits one Instance per use.

§Transform composition

Three frames stack, outermost first:

  world  o  MappingTarget  o  MappingOrigin

MappingOrigin locates the geometry inside the map’s own space, and MappingTarget places the instance. Getting the order backwards produces geometry that is plausibly near the right place, which is far worse than an obvious failure.

Functions§

lower_mapped_item_node
Lower one IfcMappedItem into an Instance over its shared source.
lower_representation
Lower every item of an IfcRepresentation into one collection node.