Expand description
Totalling a cost tree.
§Direct versus rolled-up totals
A cost item may state its own values AND nest children that state theirs. Adding both double-counts if the parent’s value is a summary of the children, and under-counts if it is not – and IFC does not say which.
So both readings are offered explicitly and neither is called “the total”:
direct_total: this item’s own values only.rolled_up_total: the sum over descendants, ignoring the parent’s own stated value.
A caller who knows their authoring convention picks one. A caller who does
not can compare them: when a parent’s direct total equals its rolled-up
total, the file is self-consistent and either reading works. When they
differ, that difference is information, and consistency reports it
rather than hiding it behind a chosen default.
Structs§
- Consistency
- How an item’s own stated total compares with the sum of its children.
Functions§
- consistency
- Compare an item’s direct total against its rolled-up total.
- direct_
total - Total the direct cost values of one item.
- grand_
total - Total the direct cost values of every item in the model.
- rolled_
up_ total - Total the direct values of every descendant, excluding the item itself.
- roots
- Cost items that are not nested under any other item.