5.2.3.1 IfcPerformanceHistory

Historique de performance
Leistungsverlauf

IfcPerformanceHistory is used to document the actual performance of an occurrence instance over time. It includes machine-measured data from building automation systems and human-specified data such as task and resource usage. The data may represent actual conditions, predictions, or simulations.

The realtime data tracked by performance history takes the form of property sets where all properties are based on time series. Unlike design-based data at occurrences and types, performance-driven data is time-sensitive and may change in realtime by some measurement device. Data may be captured at irregular intervals such as when values change beyond established thresholds, or at regular intervals of specified duration.

Declaration use definition

IfcPerformanceHistory may be declared within a project using IfcRelDeclares where RelatingContext refers to the IfcProject and RelatedDefinitions includes the IfcPerformanceHistory. Default units (used for property sets) are indicated by the declaring project. Only top-level objects are declared; nested performance history objects (through IfcRelNests) do not participate in such relationship.

HISTORY  New entity in IFC2x2.

Common Use Definitions

The following concepts are inherited at supertypes:

 Instance diagram

Property Sets for Performance

The Property Sets for Performance concept applies to this entity.

The property sets relating to this entity are defined by IfcPropertySet and attached by the IfcRelDefinesByProperties relationship. They are accessible by the IsDefinedBy inverse attribute. Applicable property sets are defined at assigned entities (primarily IfcDistributionElement subtypes) where IfcPropertySetTemplate.PropertySetType is PSET_PERFORMANCEDRIVEN.

In addition to standard property sets defined within this specification, if the underlying information source provides metadata (specific type information), then custom property sets may capture such data, where corresponding IfcPropertySetTemplate and IfcPropertyTemplate objects may be defined for such information to be accessed by other applications.



Object Classification

The Object Classification concept applies to this entity.

IfcPerformanceHistory may be classified using IfcRelAssociatesClassification where RelatingClassification refers to an IfcClassificationReference indicating a classification notation. Such classification notation may be used to identify the information such as an address within a building automation system, a work breakdown structure code for tasks, or a cost code for resource allocation.



Object Aggregation

The Object Aggregation concept applies to this entity as shown in Table 8.
PredefinedTypeRelatedObjects
 IfcPerformanceHistory

Table 8 — IfcPerformanceHistory Object Aggregation

IfcPerformanceHistory may be decomposed into components using IfcRelNests where RelatingObject refers to the enclosing IfcPerformanceHistory and RelatedObjects contains one or more IfcPerformanceHistory components. Composition indicates breakdown of further detail and may correspond to the hierarchy of objects it represents.



Control Assignment

The Control Assignment concept applies to this entity as shown in Table 9.
TypeDescription
IfcGroupA system or zone for which time-based system information is provided, such as overall status parameters of a building control system.
IfcProductA building space, physical device, or port for which time-based information is provided, such as a chiller or an analog input within a device.
IfcProcessA process for which time-based information is provided, such as an alarm event being raised and acknowledged, or regular and overtime costs incurred for a task.
IfcResourceA resource for which usage is recorded or planned over time, such as wage rates and number of workers at particular times.

Table 9 — IfcPerformanceHistory Control Assignment




XSD Specification:

 <xs:element name="IfcPerformanceHistory" type="ifc:IfcPerformanceHistory" substitutionGroup="ifc:IfcControl" nillable="true"/>
 <xs:complexType name="IfcPerformanceHistory">
  <xs:complexContent>
   <xs:extension base="ifc:IfcControl">
    <xs:attribute name="LifeCyclePhase" type="ifc:IfcLabel" use="optional"/>
    <xs:attribute name="PredefinedType" type="ifc:IfcPerformanceHistoryTypeEnum" use="optional"/>
   </xs:extension>
  </xs:complexContent>
 </xs:complexType>

EXPRESS Specification:

ENTITY IfcPerformanceHistory
SUBTYPE OF IfcControl;
LifeCyclePhase : IfcLabel;
PredefinedType : OPTIONAL IfcPerformanceHistoryTypeEnum;
END_ENTITY;

Link to EXPRESS-G diagram EXPRESS-G diagram

Attribute Definitions:

LifeCyclePhase : Describes the applicable building life-cycle phase. Typical values should be DESIGNDEVELOPMENT, SCHEMATICDEVELOPMENT, CONSTRUCTIONDOCUMENT, CONSTRUCTION, ASBUILT, COMMISSIONING, OPERATION, etc.
PredefinedType : Predefined generic type for a performace history that is specified in an enumeration.
IFC4 CHANGE The attribute has been added at the end of the entity definition.

Inheritance Graph:

ENTITY IfcPerformanceHistory
ENTITY IfcRoot
GlobalId : IfcGloballyUniqueId;
OwnerHistory : OPTIONAL IfcOwnerHistory;
Name : OPTIONAL IfcLabel;
Description : OPTIONAL IfcText;
ENTITY IfcObjectDefinition
INVERSE
HasAssignments : SET OF IfcRelAssigns FOR RelatedObjects;
Nests : SET [0:1] OF IfcRelNests FOR RelatedObjects;
IsNestedBy : SET OF IfcRelNests FOR RelatingObject;
HasContext : SET [0:1] OF IfcRelDeclares FOR RelatedDefinitions;
IsDecomposedBy : SET OF IfcRelAggregates FOR RelatingObject;
Decomposes : SET [0:1] OF IfcRelAggregates FOR RelatedObjects;
HasAssociations : SET OF IfcRelAssociates FOR RelatedObjects;
ENTITY IfcObject
ObjectType : OPTIONAL IfcLabel;
INVERSE
IsDeclaredBy : SET [0:1] OF IfcRelDefinesByObject FOR RelatedObjects;
Declares : SET OF IfcRelDefinesByObject FOR RelatingObject;
IsTypedBy : SET [0:1] OF IfcRelDefinesByType FOR RelatedObjects;
IsDefinedBy : SET OF IfcRelDefinesByProperties FOR RelatedObjects;
ENTITY IfcControl
Identification : OPTIONAL IfcIdentifier;
INVERSE
Controls : SET OF IfcRelAssignsToControl FOR RelatingControl;
ENTITY IfcPerformanceHistory
LifeCyclePhase : IfcLabel;
PredefinedType : OPTIONAL IfcPerformanceHistoryTypeEnum;
END_ENTITY;

Link to this page  Link to this page