Navigation
Navigate Navigate Navigate Navigate Navigate Navigate Navigate Navigate

IfcAppliedValue

Definition from IAI: An IfcAppliedValue is an abstract supertype that specifies the common attributes for cost and environmental values that may be applied to objects within the IFC model.

HISTORY: New Entity in IFC Release 2x2

Use Definitions

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. It should be noted that the datatype for IfcAppliedValue.ApplicableDate is IfcDateTimeSelect. This enables either a calendar date or a date and time to be selected. The option of selecting a time only without a date is also possible through this select mechanism but should not be used in the case of an applied value.

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 IFC schema and thus needs to be controlled within an application.

EXPRESS specification:

ENTITY IfcAppliedValue
ABSTRACT SUPERTYPE OF (ONEOF(IfcCostValue, IfcEnvironmentalImpactValue));
Name  :  OPTIONAL IfcLabel;
Description  :  OPTIONAL IfcText;
AppliedValue  :  OPTIONAL IfcAppliedValueSelect;
UnitBasis  :  OPTIONAL IfcMeasureWithUnit;
ApplicableDate  :  OPTIONAL IfcDateTimeSelect;
FixedUntilDate  :  OPTIONAL IfcDateTimeSelect;
INVERSE
ValuesReferenced  :  SET OF IfcReferencesValueDocument FOR ReferencingValues;
ValueOfComponents  :  SET OF IfcAppliedValueRelationship FOR ComponentOfTotal;
IsComponentIn  :  SET OF IfcAppliedValueRelationship FOR Components;
WHERE
WR1  :  EXISTS (AppliedValue) OR EXISTS (ValueOfComponents);
END_ENTITY;

Attribute definitions:

Name  :  A name or additional clarification given to a cost (or impact) value.
Description  :  The description that may apply additional information about a cost (or impact) value. The description may be from purpose generated text, specification libraries, standards etc.
AppliedValue  :  The extent or quantity or amount of an applied value.
UnitBasis  :  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).
ApplicableDate  :  The date on or from which an applied value is applicable.
FixedUntilDate  :  The date until which applied value is applicable.
ValuesReferenced  :  Pointer to the IfcReferencesCostDocument relationship, which refer to a document from which the cost value is referenced.
ValueOfComponents  :  The total (or subtotal) value of the components within the applied value relationship expressed as a single applied value.
IsComponentIn  :  The value of the single applied value which is used by the applied value relationship to express a complex applied value.

Inheritance graph

ENTITY IfcAppliedValue;
ENTITY IfcAppliedValue;
Name  :  OPTIONAL IfcLabel;
Description  :  OPTIONAL IfcText;
AppliedValue  :  OPTIONAL IfcAppliedValueSelect;
UnitBasis  :  OPTIONAL IfcMeasureWithUnit;
ApplicableDate  :  OPTIONAL IfcDateTimeSelect;
FixedUntilDate  :  OPTIONAL IfcDateTimeSelect;
INVERSE
ValuesReferenced  :  SET OF IfcReferencesValueDocument FOR ReferencingValues;
ValueOfComponents  :  SET OF IfcAppliedValueRelationship FOR ComponentOfTotal;
IsComponentIn  :  SET OF IfcAppliedValueRelationship FOR Components;
END_ENTITY;