Skip to content

Reference

Insight templates and decomposers

The detection and decomposition methods, by id.

TemplateDetects
period_change.v1Latest period vs baseline
trend.v1Sustained direction (Theil–Sen + Mann–Kendall)
trend_break.v1A level shift
anomaly.v1An unusual period (robust z > 3.5)
top_contributors.v1Members that drove a change
concentration.v1Dependence on few members (top share ≥ 30% or HHI ≥ 0.25)
new_lost.v1Members that appeared or disappeared
mix_shift.v1Share changes ≥ 3 pp
ratio_shift.v1A change in a rate
benchmark_gap.v1Own figure vs an external range
DecomposerSplits
contribution.v1A total into member contributions
pvm.v1Revenue into price, volume, mix, new, lost, unpriced
ratemix.v1A rate into mix, rate, entering, exiting, unattributed (with the Simpson guard)
diff.v1An anomaly into attribute combinations by risk ratio

Formulas and tests: docs/specs/analysis-library.md. Each method is explained with examples in Finding drivers.