IfcAppliedValue

BACnet MVD

#### IfcAppliedValue

Natural language names

| Angewendeter Wert
| Applied Value
| Valeur appliquée

Change log

Item | SPF | XML | Change | Description
--- | --- | --- | --- | ---
IFC2x3 to IFC4
IfcAppliedValue |  |  | MODIFIED | Instantiation changed from ABSTRACT.
ApplicableDate | X | X | MODIFIED | Type changed from IfcDateTimeSelect to IfcDate.
FixedUntilDate | X | X | MODIFIED | Type changed from IfcDateTimeSelect to IfcDate.
Category |  |  | ADDED |
Condition |  |  | ADDED |
ArithmeticOperator |  |  | ADDED |
Components |  |  | ADDED |

##### Semantic definitions at the entity

Entity definition

This entity captures a value driven by a formula, with additional qualifications including unit basis, valid date range, and categorization.

The extent of the IfcAppliedValue is determined by the AppliedValue attribute which may be defined either as an IfcMeasureWithUnit or as an IfcMonetaryMeasure or as an IfcRatioMeasure via the IfcAppliedValueSelect type.

Optionally, an IfcAppliedValue may have an applicable date. This is intended to fix the date on which the value became relevant for use. It may be the date on which the value was set in the model or it may be a prior or future date when the value becomes operable. Similarly, an IfcAppliedValue may have a 'fixed until' date. This is intended to fix the date on which the value ceases to be relevant for use.

An instance of IfcAppliedValue may have a unit basis asserted. This is defined as an IfcMeasureWithUnit that determines the extent of the unit value for application purposes. It is assumed that when this attribute is asserted, then the value given to IfcAppliedValue is that for unit quantity. This is not enforced within the schema and thus needs to be controlled within an application.

Applied values may be referenced from a document (such as a price list). The relationship between one or more occurrences of IfcAppliedValue (or its subtypes) is achieved through the use of the IfcExternalReferenceRelationship in which the document provides the IfcExternalReferenceRelationship.RelatingExtReference and the value occurrences are the IfcExternalReferenceRelationship.RelatedResourceObjects.

> HISTORY New entity in IFC2x2.

> IFC4 CHANGE Entity made non-abstract to support general formula expressions of constraints, data type of date-based attributes changed into IfcDate, ValueType and Condition promoted from IfcCostValue, Components and ArithmeticOperator attributes added to replace IfcAppliedValueRelationship for more efficient encoding and reference tracking.

Attribute definitions

# | Attribute | Type | Cardinality | Description | B
--- | --- | --- | --- | --- | ---
1 | Name | IfcLabel | ? | A name or additional clarification given to a cost value. |  | X
2 | Description | IfcText | ? | The description that may apply additional information about a cost value. |  | X
3 | AppliedValue | IfcAppliedValueSelect | ? | The extent or quantity or amount of an applied value. |  | X
4 | UnitBasis | IfcMeasureWithUnit | ? | The number and unit of measure on which the unit cost is based. Note: As well as the normally expected units of measure such as length, area, volume etc., costs may be based on units of measure which need to be defined e.g. sack, drum, pallet, item etc. Unit costs may be based on quantities greater (or lesser) than a unitary value of the basis measure. For instance, timber may have a unit cost rate per X meters where X > 1; similarly for cable, piping and many other items. The basis number may be either an integer or a real value. Note: This attribute should be asserted for all circumstances where the cost to be applied is per unit quantity. It may be asserted even for circumstances where an item price is used, in which case the unit cost basis should be by item (or equivalent definition). |  | X

5

ApplicableDate

IfcDate

?

The date on or from which an applied value is applicable.

> IFC4 CHANGE Type changed from IfcDateTimeSelect.

X

6

FixedUntilDate

IfcDate

?

The date until which applied value is applicable.

> IFC4 CHANGE Type changed from IfcDateTimeSelect.

X

7

Category

IfcLabel

?

Specification of the type of cost used.

> NOTE There are many possible types of cost value that may be identified. Whilst there is a broad understanding of the meaning of names that may be assigned to different types of costs, there is no general standard for naming cost types nor are there any broadly defined classifications. To allow for any type of cost value, the IfcLabel datatype is assigned.

In the absence of any well defined standard, it is recommended that local agreements should be made to define allowable and understandable cost value types within a project or region.

X

8 | Condition | IfcLabel | ? | The condition under which a cost value applies. For example, within the context of a bid submission, this may refer to an option that may or may not be elected. |  | X
9 | ArithmeticOperator | IfcArithmeticOperatorEnum | ? | The arithmetic operator applied to component values. |  | X
10 | Components | IfcAppliedValue | ? L[1:?] | Optional component values from which AppliedValue is calculated. |  | X

HasExternalReference

IfcExternalReferenceRelationship
@RelatedResourceObjects

S[0:?]

Reference to an external reference, e.g. library, classification, or document information, that is associated to the IfcAppliedValue.

> IFC4 CHANGE New inverse attribute.

X

##### Inherited definitions from supertypes

Entity inheritance
Attribute inheritance

# | Attribute | Type | Cardinality | Description | B
--- | --- | --- | --- | --- | ---
IfcAppliedValue
1 | Name | IfcLabel | ? | A name or additional clarification given to a cost value. |  | X
2 | Description | IfcText | ? | The description that may apply additional information about a cost value. |  | X
3 | AppliedValue | IfcAppliedValueSelect | ? | The extent or quantity or amount of an applied value. |  | X
4 | UnitBasis | IfcMeasureWithUnit | ? | The number and unit of measure on which the unit cost is based. Note: As well as the normally expected units of measure such as length, area, volume etc., costs may be based on units of measure which need to be defined e.g. sack, drum, pallet, item etc. Unit costs may be based on quantities greater (or lesser) than a unitary value of the basis measure. For instance, timber may have a unit cost rate per X meters where X > 1; similarly for cable, piping and many other items. The basis number may be either an integer or a real value. Note: This attribute should be asserted for all circumstances where the cost to be applied is per unit quantity. It may be asserted even for circumstances where an item price is used, in which case the unit cost basis should be by item (or equivalent definition). |  | X

5

ApplicableDate

IfcDate

?

The date on or from which an applied value is applicable.

> IFC4 CHANGE Type changed from IfcDateTimeSelect.

X

6

FixedUntilDate

IfcDate

?

The date until which applied value is applicable.

> IFC4 CHANGE Type changed from IfcDateTimeSelect.

X

7

Category

IfcLabel

?

Specification of the type of cost used.

> NOTE There are many possible types of cost value that may be identified. Whilst there is a broad understanding of the meaning of names that may be assigned to different types of costs, there is no general standard for naming cost types nor are there any broadly defined classifications. To allow for any type of cost value, the IfcLabel datatype is assigned.

In the absence of any well defined standard, it is recommended that local agreements should be made to define allowable and understandable cost value types within a project or region.

X

8 | Condition | IfcLabel | ? | The condition under which a cost value applies. For example, within the context of a bid submission, this may refer to an option that may or may not be elected. |  | X
9 | ArithmeticOperator | IfcArithmeticOperatorEnum | ? | The arithmetic operator applied to component values. |  | X
10 | Components | IfcAppliedValue | ? L[1:?] | Optional component values from which AppliedValue is calculated. |  | X

HasExternalReference

IfcExternalReferenceRelationship
@RelatedResourceObjects

S[0:?]

Reference to an external reference, e.g. library, classification, or document information, that is associated to the IfcAppliedValue.

> IFC4 CHANGE New inverse attribute.

X

##### Formal representations

XML Specification
`<xs:element name="IfcAppliedValue" type="ifc:IfcAppliedValue" substitutionGroup="ifc:Entity" nillable="true"/>
<xs:complexType name="IfcAppliedValue">
<xs:complexContent>
<xs:extension base="ifc:Entity">
<xs:sequence>
<xs:element name="AppliedValue" nillable="true" minOccurs="0">
<xs:complexType>
<xs:group ref="ifc:IfcAppliedValueSelect"/>
</xs:complexType>
</xs:element>
<xs:element name="UnitBasis" type="ifc:IfcMeasureWithUnit" nillable="true" minOccurs="0"/>
<xs:element name="Components" nillable="true" minOccurs="0">
<xs:complexType>
<xs:sequence>
<xs:element ref="ifc:IfcAppliedValue" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute ref="ifc:itemType" fixed="ifc:IfcAppliedValue"/>
<xs:attribute ref="ifc:cType" fixed="list"/>
<xs:attribute ref="ifc:arraySize" use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute name="Name" type="ifc:IfcLabel" use="optional"/>
<xs:attribute name="Description" type="ifc:IfcText" use="optional"/>
<xs:attribute name="ApplicableDate" type="ifc:IfcDate" use="optional"/>
<xs:attribute name="FixedUntilDate" type="ifc:IfcDate" use="optional"/>
<xs:attribute name="Category" type="ifc:IfcLabel" use="optional"/>
<xs:attribute name="Condition" type="ifc:IfcLabel" use="optional"/>
<xs:attribute name="ArithmeticOperator" type="ifc:IfcArithmeticOperatorEnum" use="optional"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
`
EXPRESS Specification
`ENTITY IfcAppliedValue
SUPERTYPE OF(IfcCostValue);
Name : OPTIONAL IfcLabel;
Description : OPTIONAL IfcText;
AppliedValue : OPTIONAL IfcAppliedValueSelect;
UnitBasis : OPTIONAL IfcMeasureWithUnit;
ApplicableDate : OPTIONAL IfcDate;
FixedUntilDate : OPTIONAL IfcDate;
Category : OPTIONAL IfcLabel;
Condition : OPTIONAL IfcLabel;
ArithmeticOperator : OPTIONAL IfcArithmeticOperatorEnum;
Components : OPTIONAL LIST [1:?] OF IfcAppliedValue;
INVERSE
HasExternalReference : SET [0:?] OF IfcExternalReferenceRelationship FOR RelatedResourceObjects;
END_ENTITY;

EXPRESS-G diagram

`

References: IfcConstructionResource IfcConstructionResourceType IfcMetricValueSelect IfcAppliedValue IfcResourceObjectSelect IfcObjectReferenceSelect

Link to this page