IfcMetric

Natural language names
Metrik
Metric
Métrique
Change log
ItemSPFXMLChangeDescription
IFC2x3 to IFC4 4.0.0.0
    IfcMetric
      CreationTimeXXMODIFIEDType changed from IfcDateTimeSelect to IfcDateTime.
      ReferencePathADDED
IFC4 Addendum 1 4.0.1.0
    IfcMetric
      DataValueMODIFIEDInstantiation changed to OPTIONAL.
      PropertiesForConstraintADDED
      ConstrainedResourcesDELETED
      ConstrainedObjectsDELETED
Semantic definitions at the entity
Entity definition

An IfcMetric is used to capture quantitative resultant metrics that can be applied to objectives.

IfcMetric is a subtype of IfcConstraint and may be associated with any subtype of IfcRoot through the IfcRelAssociatesConstraint relationship in the IfcControlExtension schema, or may be associated with IfcProperty by IfcResourceConstraintRelationship.

The aim of IfcMetric is to capture the quantitative aspects of a constraint.

HISTORY  New entity in IFC2.0.

IFC4 CHANGE  ReferencePath attribute added for indicating the value to be constrained along a path of attribute references.

Attribute definitions
#AttributeTypeCardinalityDescription G
8BenchmarkIfcBenchmarkEnum Enumeration that identifies the type of benchmark data. X
9ValueSourceIfcLabel? Reference source for data values. If DataValue refers to an IfcTable, this attribute identifies the relevent column identified by IfcTableColumn.Identifier. X
10DataValueIfcMetricValueSelect? The value to be compared on associated objects. A null value indicates comparison to null.
IFC4 ADD1 CHANGE  This attribute is now optional.
X
11ReferencePathIfcReference? Optional path to an attribute to be constrained on associated objects. If provided, the metric may be validated by resolving the path to the current value on associated object(s), and comparing such value with DataValue according to the Benchmark. X
Inherited definitions from supertypes
Entity inheritance IfcConstraint
Attribute inheritance
#AttributeTypeCardinalityDescriptionG
IfcConstraint
1NameIfcLabel A human-readable name to be used for the constraint. X
2DescriptionIfcText? A human-readable description that may apply additional information about a constraint. X
3ConstraintGradeIfcConstraintEnum Enumeration that qualifies the type of constraint. X
4ConstraintSourceIfcLabel? Any source material, such as a code or standard, from which the constraint originated. X
5CreatingActorIfcActorSelect? Person and/or organization that has created the constraint. X
6CreationTimeIfcDateTime? Time when information specifying the constraint instance was created. X
7UserDefinedGradeIfcLabel? Allows for specification of user defined grade of the constraint beyond the enumeration values (hard, soft, advisory) provided by ConstraintGrade attribute of type IfcConstraintEnum. When a value is provided for attribute UserDefinedGrade in parallel the attribute ConstraintGrade shall have enumeration value USERDEFINED. X
HasExternalReferencesIfcExternalReferenceRelationship
@RelatedResourceObjects
S[0:?]Reference to an external references, e.g. library, classification, or document information, that are associated to the constraint.
IFC4 CHANGE New inverse attribute.
X
PropertiesForConstraintIfcResourceConstraintRelationship
@RelatingConstraint
S[0:?]Reference to the properties to which the constraint is applied. X
IfcMetric
8BenchmarkIfcBenchmarkEnum Enumeration that identifies the type of benchmark data. X
9ValueSourceIfcLabel? Reference source for data values. If DataValue refers to an IfcTable, this attribute identifies the relevent column identified by IfcTableColumn.Identifier. X
10DataValueIfcMetricValueSelect? The value to be compared on associated objects. A null value indicates comparison to null.
IFC4 ADD1 CHANGE  This attribute is now optional.
X
11ReferencePathIfcReference? Optional path to an attribute to be constrained on associated objects. If provided, the metric may be validated by resolving the path to the current value on associated object(s), and comparing such value with DataValue according to the Benchmark. X
Formal representations
XML Specification
 <xs:element name="IfcMetric" type="ifc:IfcMetric" substitutionGroup="ifc:IfcConstraint" nillable="true"/>
 <xs:complexType name="IfcMetric">
  <xs:complexContent>
   <xs:extension base="ifc:IfcConstraint">
    <xs:sequence>
     <xs:element name="DataValue" nillable="true" minOccurs="0">
      <xs:complexType>
       <xs:group ref="ifc:IfcMetricValueSelect"/>
      </xs:complexType>
     </xs:element>
     <xs:element name="ReferencePath" type="ifc:IfcReference" nillable="true" minOccurs="0"/>
    </xs:sequence>
    <xs:attribute name="Benchmark" type="ifc:IfcBenchmarkEnum" use="optional"/>
    <xs:attribute name="ValueSource" type="ifc:IfcLabel" use="optional"/>
   </xs:extension>
  </xs:complexContent>
 </xs:complexType>
EXPRESS Specification
ENTITY IfcMetric
 SUBTYPE OF (IfcConstraint);
  Benchmark : IfcBenchmarkEnum;
  ValueSource : OPTIONAL IfcLabel;
  DataValue : OPTIONAL IfcMetricValueSelect;
  ReferencePath : OPTIONAL IfcReference;
END_ENTITY;

Link to EXPRESS-G diagram EXPRESS-G diagram

Link to this page  Link to this page