#### 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.

## Building Automation

Realtime and historical data is captured on property sets defined on IfcPerformanceHistory instances. IfcPerformanceHistory represents a subscription to a data feed, which may have one or more IfcDistributionElement-derived objects assigned.

All properties used at IfcPerformanceHistory use time series, which may be regular (data captured at constant time intervals) or irregular (data captured when it has changed beyond a threshold).

Performance history objects may be nested into levels of detail, where a parent history object represents the aggregate average of its components.

Performance history objects may be nested inside calendars, where the enclosing calendar indicates active and inactive monitoring periods.

Performance history objects may be classified using IfcRelAssociatesClassification to indicate the device address for capturing data.

The following concepts are inherited at supertypes:

- IfcRoot: Revision Control

Instance diagram

Property Sets for Performance

The Property Sets for Performance concept applies to this entity as shown in Table 8.

Name
Pset_ActuatorPHistory
Pset_AlarmPHistory
Pset_ControllerPHistory
Pset_FlowInstrumentPHistory
Pset_SensorPHistory
Pset_UnitaryControlElementPHistory
Pset_DistributionPortPHistoryCable
Table 8 — IfcPerformanceHistory Property Sets for Performance

Exchange |  |  |  |  |
--- | --- | --- | --- | --- | ---
Import |  |  |  |  |
Export |  |  |  |  |

Control Assignment

The Control Assignment concept applies to this entity as shown in Table 9.

Type | Description
--- | ---
IfcDistributionElement | Performance history may have one or more devices assigned for which data is captured.
Table 9 — IfcPerformanceHistory Control Assignment

Exchange |  |  |  |  |
--- | --- | --- | --- | --- | ---
Import |  |  |  |  |
Export |  |  |  |  |

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:extension>
</xs:complexContent>
</xs:complexType>

EXPRESS Specification:

ENTITY IfcPerformanceHistory

| SUBTYPE OF IfcControl;

LifeCyclePhase | : | IfcLabel;
PredefinedType | : | OPTIONAL IfcStrippedOptional;

END_ENTITY;

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.

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 IfcStrippedOptional;

END_ENTITY;

Link to this page