IfcPerformanceHistory

BACnet MVD

#### IfcPerformanceHistory

Natural language names

| Leistungsverlauf
| Performance History
| Historique de performance

Change log

Item | SPF | XML | Change | Description
--- | --- | --- | --- | ---
IFC2x3 to IFC4
IfcPerformanceHistory |  |  |  |
OwnerHistory |  |  | MODIFIED | Instantiation changed to OPTIONAL.
Identification |  |  | MODIFIED | Name changed from LifeCyclePhase to Identification. Type changed from IfcLabel to IfcIdentifier. Instantiation changed to OPTIONAL.
LifeCyclePhase |  |  | ADDED |
PredefinedType |  |  | ADDED |

##### Semantic definitions at the entity

Entity definition

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.

Attribute definitions

# | Attribute | Type | Cardinality | Description | B
--- | --- | --- | --- | --- | ---
7 | LifeCyclePhase | IfcLabel |  | Describes the applicable building life-cycle phase. Typical values should be DESIGNDEVELOPMENT, SCHEMATICDEVELOPMENT, CONSTRUCTIONDOCUMENT, CONSTRUCTION, ASBUILT, COMMISSIONING, OPERATION, etc. |  | X

8

PredefinedType

IfcPerformanceHistoryTypeEnum

?

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.

X

##### Inherited definitions from supertypes

Entity inheritance
Attribute inheritance

# | Attribute | Type | Cardinality | Description | B
--- | --- | --- | --- | --- | ---
IfcRoot
1 | GlobalId | IfcGloballyUniqueId |  | Assignment of a globally unique identifier within the entire software world. | X | X

2

OwnerHistory

IfcOwnerHistory

?

Assignment of the information about the current ownership of that object, including owning actor, application, local identification and information captured about the recent changes of the object,

> NOTE only the last modification in stored - either as addition, deletion or modification.

> IFC4 CHANGE The attribute has been changed to be OPTIONAL.

X

X

3 | Name | IfcLabel | ? | Optional name for use by the participating software systems or users. For some subtypes of IfcRoot the insertion of the Name attribute may be required. This would be enforced by a where rule. | X | X
4 | Description | IfcText | ? | Optional description, provided for exchanging informative comments. |  | X
IfcObjectDefinition
| HasAssignments | IfcRelAssigns @RelatedObjects | S[0:?] | Reference to the relationship objects, that assign (by an association relationship) other subtypes of IfcObject to this object instance. Examples are the association to products, processes, controls, resources or groups. |  | X

Nests

IfcRelNests
@RelatedObjects

S[0:1]

References to the decomposition relationship being a nesting. It determines that this object definition is a part within an ordered whole/part decomposition relationship. An object occurrence or type can only be part of a single decomposition (to allow hierarchical strutures only).

> IFC4 CHANGE The inverse attribute datatype has been added and separated from Decomposes defined at IfcObjectDefinition.

X

IsNestedBy

IfcRelNests
@RelatingObject

S[0:?]

References to the decomposition relationship being a nesting. It determines that this object definition is the whole within an ordered whole/part decomposition relationship. An object or object type can be nested by several other objects (occurrences or types).

> IFC4 CHANGE The inverse attribute datatype has been added and separated from IsDecomposedBy defined at IfcObjectDefinition.

X

X

HasContext

IfcRelDeclares
@RelatedDefinitions

S[0:1]

References to the context providing context information such as project unit or representation context. It should only be asserted for the uppermost non-spatial object.

> IFC4 CHANGE The inverse attribute datatype has been added.

X

IsDecomposedBy

IfcRelAggregates
@RelatingObject

S[0:?]

References to the decomposition relationship being an aggregation. It determines that this object definition is whole within an unordered whole/part decomposition relationship. An object definitions can be aggregated by several other objects (occurrences or parts).

> IFC4 CHANGE The inverse attribute datatype has been changed from the supertype IfcRelDecomposes to subtype IfcRelAggregates.

X

X

Decomposes

IfcRelAggregates
@RelatedObjects

S[0:1]

References to the decomposition relationship being an aggregation. It determines that this object definition is a part within an unordered whole/part decomposition relationship. An object definitions can only be part of a single decomposition (to allow hierarchical strutures only).

> IFC4 CHANGE The inverse attribute datatype has been changed from the supertype IfcRelDecomposes to subtype IfcRelAggregates.

X

X

| HasAssociations | IfcRelAssociates @RelatedObjects | S[0:?] | Reference to the relationship objects, that associates external references or other resource definitions to the object.. Examples are the association to library, documentation or classification. | X | X
IfcObject

5

ObjectType

IfcLabel

?

The type denotes a particular type that indicates the object further. The use has to be established at the level of instantiable subtypes. In particular it holds the user defined type, if the enumeration of the attribute PredefinedType is set to USERDEFINED.

X

IsDeclaredBy

IfcRelDefinesByObject
@RelatedObjects

S[0:1]

Link to the relationship object pointing to the declaring object that provides the object definitions for this object occurrence. The declaring object has to be part of an object type decomposition. The associated IfcObject, or its subtypes, contains the specific information (as part of a type, or style, definition), that is common to all reflected instances of the declaring IfcObject, or its subtypes.

> IFC4 CHANGE New inverse relationship, change made with upward compatibility for file based exchange.

X

X

Declares

IfcRelDefinesByObject
@RelatingObject

S[0:?]

Link to the relationship object pointing to the reflected object(s) that receives the object definitions. The reflected object has to be part of an object occurrence decomposition. The associated IfcObject, or its subtypes, provides the specific information (as part of a type, or style, definition), that is common to all reflected instances of the declaring IfcObject, or its subtypes.

> IFC4 CHANGE New inverse relationship, change made with upward compatibility for file based exchange.

X

IsTypedBy

IfcRelDefinesByType
@RelatedObjects

S[0:1]

Set of relationships to the object type that provides the type definitions for this object occurrence. The then associated IfcTypeObject, or its subtypes, contains the specific information (or type, or style), that is common to all instances of IfcObject, or its subtypes, referring to the same type.

> IFC4 CHANGE New inverse relationship, the link to IfcRelDefinesByType had previously be included in the inverse relationship IfcRelDefines. Change made with upward compatibility for file based exchange.

X

IsDefinedBy

IfcRelDefinesByProperties
@RelatedObjects

S[0:?]

Set of relationships to property set definitions attached to this object. Those statically or dynamically defined properties contain alphanumeric information content that further defines the object.

> IFC4 CHANGE The data type has been changed from IfcRelDefines to IfcRelDefinesByProperties with upward compatibility for file based exchange.

X

IfcControl

6

Identification

IfcIdentifier

?

An identifying designation given to a control It is the identifier at the occurrence level.

> IFC4 CHANGE Attribute unified by promoting from various subtypes of IfcControl.

X

| Controls | IfcRelAssignsToControl @RelatingControl | S[0:?] | Reference to the relationship that associates the control to the object(s) being controlled. |  | X
IfcPerformanceHistory
7 | LifeCyclePhase | IfcLabel |  | Describes the applicable building life-cycle phase. Typical values should be DESIGNDEVELOPMENT, SCHEMATICDEVELOPMENT, CONSTRUCTIONDOCUMENT, CONSTRUCTION, ASBUILT, COMMISSIONING, OPERATION, etc. |  | X

8

PredefinedType

IfcPerformanceHistoryTypeEnum

?

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.

X

##### Definitions applying to Design Transfer View

Concept inheritance

# | Concept | Template | Model View
--- | --- | --- | ---
IfcRoot
| Revision Control | Revision Control | Design Transfer View

##### Definitions applying to BACnet View

Instance diagram

#####

Concept usage

BACnet ObjectDefinition Composition

The BACnet ObjectDefinition Composition concept applies to this entity.

Software Identity

The Software Identity concept applies to this entity.

Object User Identity

The Object User Identity concept applies to this entity.

BACnet PerformanceHistory Predefined Type

The BACnet PerformanceHistory Predefined Type concept applies to this entity.

Control Assignment

The Control Assignment concept applies to this entity.

Property Sets for Objects

The Property Sets for Objects concept template applies to this entity as shown in Table 2.

PsetName | Properties
--- | ---

Pset_BACnetScheduleObject

Template | PropertyName | Value | UpperValue | LowerValue | SetValue | Reference
--- | --- | --- | --- | --- | --- | ---
Single Value | Present Value |  |  |  |  |
Bounded Value | Effective Period | IfcDateTime |  |  |  |
Single Value | Schedule Default |  |  |  |  |
Bounded Value | Priority For Writing | IfcInteger |  |  |  |
Enumerated Value | Status Flags | IfcLabel |  |  |  | PEnum_BACnetStatusFlag
Enumerated Value | Event State | IfcLabel |  |  |  | PEnum_BACnetEventState
Enumerated Value | Reliability | IfcLabel |  |  |  | PEnum_BACnetReliability
Single Value | Out Of Service | IfcBoolean |  |  |  |
Single Value | Out Of Service | IfcBoolean |  |  |  |
Bounded Value | Effective Period | IfcDateTime |  |  |  |
Bounded Value | Priority For Writing | IfcInteger |  |  |  |
Enumerated Value | Status Flags | IfcLabel |  |  |  | PEnum_BACnetStatusFlag
Enumerated Value | Event State | IfcLabel |  |  |  | PEnum_BACnetEventState
Enumerated Value | Reliability | IfcLabel |  |  |  | PEnum_BACnetReliability

Pset_BACnetTrendLogObject

Template | PropertyName | Value | Reference
--- | --- | --- | ---
Single Value | Stop When Full | IfcBoolean |
Single Value | Buffer Size | IfcReal |
Enumerated Value | Log Buffer | IfcLabel | PEnum_BACnetLogRecord
Single Value | Total Record Count | IfcInteger |
Enumerated Value | Logging Type | IfcLabel | PEnum_BACnetLoggingType
Enumerated Value | Status Flags | IfcLabel | PEnum_BACnetStatusFlag
Enumerated Value | Event State | IfcLabel | PEnum_BACnetEventState
Enumerated Value | Status Flags | IfcLabel | PEnum_BACnetStatusFlag
Enumerated Value | Event State | IfcLabel | PEnum_BACnetEventState

Table 2 — IfcPerformanceHistory Property Sets for Objects

mvdXML Specification
`<?xml version="1.0"?>
<ConceptRoot xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" uuid="334cfd8a-81bc-4335-921e-1b09858e89e7" name="IfcPerformanceHistory" status="sample" applicableRootEntity="IfcPerformanceHistory">
<Concepts>
<Concept uuid="b66affb7-9fec-46da-b8e5-f256fd91a633" name="BACnet ObjectDefinition Composition" status="sample" override="false">
<Template ref="c8ce5b1b-84be-4e74-971f-0f7a5e0a654b" />
<Requirements>
<Requirement applicability="import" requirement="recommended" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
<Requirement applicability="export" requirement="recommended" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
</Requirements>
</Concept>
<Concept uuid="f9256e3d-0a22-49db-9399-8e228721cbf3" name="Software Identity" status="sample" override="false">
<Template ref="f7cb0a08-fee7-4cc0-85fe-43f6a6a0bce1" />
<Requirements>
<Requirement applicability="import" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
<Requirement applicability="export" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
</Requirements>
</Concept>
<Concept uuid="2c135076-5280-4b87-870d-c5110c524ba7" name="Object User Identity" status="sample" override="false">
<Template ref="c19ec186-9cfd-47fc-a4d4-9fb35008d04a" />
<Requirements>
<Requirement applicability="import" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
<Requirement applicability="export" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
</Requirements>
</Concept>
<Concept uuid="522a3c04-5747-4069-885b-fb340222bacc" name="BACnet PerformanceHistory Predefined Type" status="sample" override="false">
<Template ref="4456bb0b-7f86-4296-87e6-1e973c670eae" />
<Requirements>
<Requirement applicability="import" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
<Requirement applicability="export" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
</Requirements>
</Concept>
<Concept uuid="09e3cf42-995f-491f-96ef-10288263ef66" name="Control Assignment" status="sample" override="false">
<Template ref="813e73fe-5641-4648-a680-8887cf4359f1" />
<Requirements>
<Requirement applicability="import" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
<Requirement applicability="export" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
</Requirements>
</Concept>
<Concept uuid="054191ad-bf68-4c1b-8ccd-6768170e1b61" name="Property Sets for Objects" status="sample" override="false">
<Template ref="f74255a6-0c0e-4f31-84ad-24981db62461" />
<Requirements>
<Requirement applicability="import" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
<Requirement applicability="export" requirement="mandatory" exchangeRequirement="b8a611d3-6f94-4bdf-b974-b74089a6e6c7" />
</Requirements>
<TemplateRules operator="and">
<TemplateRule Parameters="PsetName[Value]='Pset_BACnetScheduleObject'" />
<TemplateRule Parameters="PsetName[Value]='Pset_BACnetTrendLogObject'" />
</TemplateRules>
</Concept>
</Concepts>
</ConceptRoot>
`
Concept inheritance

# | Concept | Template | Model View
--- | --- | --- | ---
IfcRoot
| Revision Control | Revision Control | Design Transfer View
IfcPerformanceHistory
| BACnet ObjectDefinition Composition | BACnet ObjectDefinition Composition | BACnet View
| Software Identity | Software Identity | BACnet View
| Object User Identity | Object User Identity | BACnet View
| BACnet PerformanceHistory Predefined Type | BACnet PerformanceHistory Predefined Type | BACnet View
| Control Assignment | Control Assignment | BACnet View
| Property Sets for Objects | Property Sets for Objects | BACnet View

##### Formal representations

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

EXPRESS-G diagram

`

Link to this page