Navigation

IfcCostValue

Definition from IAI: An IfcCostValue is an amount to be paid for acquisition, installation, or assembly; associated with a product, process, or resource.

HISTORY: New entity in IFC Release 1.0. This entity has been changed and renamed from IfcCost to IfcCostValue in IFC Release 2x.
ISSUES: See issue and change log for changes made in IFC Release 2x.

EXPRESS specification:

ENTITY IfcCostValue;
BaseCostValue  :  OPTIONAL IfcMonetaryMeasure;
FinalCostValue  :  OPTIONAL IfcMonetaryMeasure;
Currency  :  OPTIONAL IfcCurrencyEnum;
UnitCostBasis  :  OPTIONAL IfcMeasureWithUnit;
CostType  :  OPTIONAL IfcLabel;
CostDate  :  OPTIONAL IfcCalendarDate;
CostModifiers  :  OPTIONAL LIST [1:?] OF UNIQUE IfcCostModifier;
INVERSE
ValueOfComponents  :  SET [0:1] OF IfcCostValueRelationship FOR ComponentOf;
IsComponentIn  :  SET OF IfcCostValueRelationship FOR CostComponents;
CostsReferenced  :  SET OF IfcReferencesCostDocument FOR ReferencingCosts;
WHERE
WR1  :  EXISTS(BaseCostValue) OR EXISTS(FinalCostValue) OR EXISTS(ValueOfComponents[1]);
END_ENTITY;

Attribute definitions:

BaseCostValue  :  Amount of this cost before the application of cost modifiers.
Note: In cases where an amount of a cost is to be given that is not subject to modification, the BaseCostValue attribute should NOT be used.
FinalCostValue  :  Amount of this cost following the application of cost modifiers.
Currency  :  Currency for this cost that can override the global currency setting for the project.
NOTE - Currencies are defined by standard three character designations as used by banks and financial institutions.
UnitCostBasis  :  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).
CostType  :  A description of the type of cost that the cost value expresses.

Note: Examples of cost types could include:
- Basic Cost
- Overhead Cost
- Profit Cost
- Purchase Cost
- Sale Cost
- Plant Cost (i.e. the cost for items of equipment rented or purchased for use on this project but which will not be embodied within the final product)
- Sub Contract Cost (i.e. a cost for work that is done by a third party under contract)
- Preliminaries Cost (i.e. costs that describe work associated with a project but which do not form part of the completed product e.g. site use and facilities, security, temporary construction works: as defined in BS6100 156 3003)
- Prime Cost (i.e. a cost which is an amount to be included for work, services or materials to be executed by or obtained from a nominated actor: as defined in BS6100 156 5011)
- Provisional Cost (i.e. a cost that is allowed for something that is foreseen but that cannot be accurately specified at the time of costing: as defined in BS6100 156 5010)
- Contingency Cost (i.e. a cost that is allowed for something that may be required but that cannot be foreseen with certainty: as defined in BS6100 156 5009)
- Retention Cost (i.e. a cost retained for a certain period to offset costs arising from an inability or failure to comply fully with the contract: as defined in BS6100 156 6031)
- etc.

This attribute takes over the functionality previously expressed by the IfcCostEnum data type.
---
CostDate  :  The date at which the cost is assessed. In an estimate, for example, this is the date at which the estimated cost value was made, while for a report of actual costs, it is the cost that the actual costs are recorded. If the cost value is an estimate of a future cost, the date range for which the cost value is expected to be valued should be described in an associated cost schedule.
CostModifiers  :  Modifiers which may be applied to a cost to change its value.
ValueOfComponents  :  The aggregated value of the components within the cost value relationship expressed as a single cost value.
IsComponentIn  :  The value of the single cost value which is used by the cost value relationship to express expressed a complex cost.
CostsReferenced  :  Pointer to the IfcReferencesCostDocument relationship, which refer to a document from which the cost value is referenced.

Formal Propositions:

WR1  :  Either a basis cost value has to be given, or the final cost value. A third possibility is that the IfcCostValue has cost components from which the cost value can be derived.

References (4):

Name Type Referred through Express-G
IfcCostModifier Entity
Attribute 'ModifiedCost'
Diagram 2
IfcCostValueRelationship Entity
Attribute 'ComponentOf'
Attribute 'CostComponents'
Diagram 1
IfcReferencesCostDocument Entity
Attribute 'ReferencingCosts'
Diagram 1

Inheritance graph

ENTITY IfcCostValue;
ENTITY IfcCostValue;
BaseCostValue  :  OPTIONAL IfcMonetaryMeasure;
FinalCostValue  :  OPTIONAL IfcMonetaryMeasure;
Currency  :  OPTIONAL IfcCurrencyEnum;
UnitCostBasis  :  OPTIONAL IfcMeasureWithUnit;
CostType  :  OPTIONAL IfcLabel;
CostDate  :  OPTIONAL IfcCalendarDate;
CostModifiers  :  OPTIONAL LIST [1:?] OF UNIQUE IfcCostModifier;
INVERSE
ValueOfComponents  :  SET [0:1] OF IfcCostValueRelationship FOR ComponentOf;
IsComponentIn  :  SET OF IfcCostValueRelationship FOR CostComponents;
CostsReferenced  :  SET OF IfcReferencesCostDocument FOR ReferencingCosts;
END_ENTITY;