Skip to main content

Module properties

Module properties 

Source
Expand description

Property sets, quantities and units (feature properties, #123).

The facade’s exact, release-bound resolver (ifc::properties:: exact_properties) answers for one object: its own sets, then the sets its type object holds, an occurrence property overriding an inherited one of the same set and name. Each set and property crosses as an owned record keyed by entity id, with the set’s GlobalId. Values keep their declared IFC type in the tagged encoding: a quantity’s bare 2.5 read as IfcLengthMeasure crosses as typed IFCLENGTHMEASURE(real 2.5), a label as typed IFCLABEL(text ...), and .U. stays unknown.

The release is the one the header declares, IFC2X3, IFC4 or IFC4X3; any other is refused with unsupported-schema, and a model read leniently with skipped records with invalid-model, since an exact answer cannot be proven from an incomplete file.

§Many objects in one call (#358)

IfcModel::property_sets validates every IfcRelDefinesByProperties and IfcRelDefinesByType of the file on each call, because a malformed one could hide an assignment; a host loop over every object is then quadratic. IfcModel::property_sets_many builds one ifc::properties::PropertyIndex for the call, so the validation runs once and the whole pass is linear in objects plus relationships. Its answer for each object is exactly the per-object call’s: the same sets, or the same refusal, as an ObjectPropertySets record.

The index never outlives the call. It borrows the model, which the binding owns and mutates through &mut self, so no index can be held across an edit and no answer can come from a model state other than the one the call sees: there is no cache to invalidate. The per-object call keeps the free resolver for the same reason; to resolve many objects, ask for them together.

The records are shaped for the checked edit of part 2 of #123: a property is addressed by its object, set name and property name, and its value is exactly the tagged value an edit would write back.

Structs§

Bounds
The values of an IfcPropertyBoundedValue; null when unstated.
Enumeration
An IfcPropertyEnumeration.
ObjectPropertySets
The answer for one object of IfcModel::property_sets_many: its sets, or why the per-object call would refuse it.
Property
One property, quantity or predefined-set attribute.
PropertyRefusal
Why one object’s property sets were refused: the shared binding code and message of the error the per-object call returns.
PropertySet
One property set, quantity set or predefined property set applying to an object.
ResolvedUnit
A measure’s effective unit, resolved to SI: si = value * scale + offset.
Table
An IfcPropertyTableValue.