Decomposition Tree Component
The Decomposition Tree component breaks a top-level metric down through a sequence of dimension fields to identify the drivers of the result. Starting from a single root value (e.g., total schedule variance), the tree expands through user-selected or automatically chosen branches to show which groups, phases, disciplines, or contractors are contributing the most to the outcome.
When to use
Use the decomposition tree when:
- A metric needs to be attributed to a root cause dimension (e.g., which discipline is driving the cost overrun).
- The audience needs to explore variance drivers interactively.
- A hierarchical explanation of a KPI is needed in an executive briefing.
For a static multi-level analysis in a fixed report, a grouped bar chart or matrix may be more appropriate than the interactive decomposition tree.
Data binding
| Property | Description |
|---|---|
| Root metric | The top-level numeric value that is decomposed. |
| Root label | The label shown at the root node (e.g., "Total SV"). |
| Decomposition fields | Ordered list of fields the user can drill through. The report designer sets the available fields; the consumer (or auto mode) decides which to expand. |
| Section | The data section providing the rows for decomposition calculations. |
Modes
| Mode | Description |
|---|---|
| Manual | The report consumer clicks which branch to expand at each level. Suitable for interactive reports where the consumer wants to explore. |
| AI-assisted | The component automatically selects the branch with the highest contribution (positive or negative, depending on analysis type) to highlight the top driver path. Suitable for formal reports where the key driver path should be pre-selected. |
| Fixed path | The decomposition follows a pre-set path defined by the report designer. The consumer cannot change the expanded branches. Suitable for PDF exports. |
Contribution bars
Enable contribution bars to add a mini horizontal bar inside each node showing the node's share of the parent value:
| Property | Description |
|---|---|
| Show contribution bars | Toggle on/off. |
| Bar color | Color for positive contributions. |
| Negative bar color | Color for negative contributions (values moving away from the target direction). |
| Show percentage | Display the contribution percentage alongside the bar. |
Max depth and children limits
| Property | Description |
|---|---|
| Max depth | The maximum number of levels the tree can be expanded (1–6). |
| Max children per node | Limit the number of child branches shown per node. Remaining children are collapsed into an "Others" node. |
| Others label | Custom text for the collapsed Others node. |
Saved paths
Define named saved paths that can be loaded by the report consumer from a dropdown:
- In Properties → Saved Paths, add a path.
- Name it (e.g., "Critical path drivers", "Top cost overruns by phase").
- Define which field to expand at each level.
Saved paths appear as a dropdown above the tree in interactive mode, allowing quick switching between common analysis views.
Layout options
| Option | Description |
|---|---|
| Layout direction | Left-to-right (default) or top-to-bottom. |
| Node color scheme | Fixed color, value-based gradient, or classification-based. |
| Connector style | Straight lines, curved (bezier), or orthogonal (right-angle). |
| Node shape | Rectangle (default) or rounded rectangle. |
Export behavior
In PDF export mode, the decomposition tree renders at the current expanded state. For fixed-path mode, the pre-set path is used. For manual and AI-assisted modes, ensure you have expanded the tree to the desired state before exporting.
Related
- Advanced Charts — overview of all advanced chart types
- Waterfall Component — variance bridge alternative
- KPI Card — headline values alongside the tree