Priority Classification Overview
A four-tier priority system ranks quadrant transitions by urgency using movement velocity, magnitude, and spike detection. Priorities are computed inside plot_transition_timeline(..., movement_df=...) and saved in transition CSVs.
Priority Tiers
| Priority |
Label & Color |
Main Triggers |
Recommended Action |
| 1 – Crisis 🔴 |
Explosion requiring immediate response |
ΔX ≥ 0.40 or ΔY ≥ 0.40 (≈3σ); volume jump ≥ 50 with ≥500 % growth; both axes spiking (*XY) |
Launch crisis playbook, staff war room, monitor daily |
| 2 – Investigate 🟠 |
Rapid escalation needing urgent review |
|ΔX| > 0.15 or |ΔY| > 0.15; entry into Q1 with strong position; ≥100 % growth with ≥5 new complaints |
Trigger early warning, assign analysts, tighten monitoring cadence |
| 3 – Monitor 🟡 |
Borderline movement worth watching |
Position within ±0.10 of quadrant boundary; gentle Q1 entry |
Track trend, document findings, review quarterly |
| 4 – Low 🟢 |
Stable or improving |
No conditions above met |
Maintain routine oversight |
Spike Indicators
| Marker |
Meaning |
Threshold |
*Y |
Growth spike |
ΔY ≥ 0.40 |
*X |
Volume spike |
ΔX ≥ 0.40 |
*XY |
Simultaneous spikes |
ΔX ≥ 0.40 and ΔY ≥ 0.40 |
Threshold Reference
| Metric |
Cut-off |
Notes |
| Crisis spike |
±0.40 |
≈2.74σ, highlights extreme moves |
| Velocity trigger |
±0.15 |
Sustained acceleration worth investigation |
| Growth shock |
≥100 % and ≥5 complaints |
Filters out noise from tiny bases |
| Explosion |
≥500 % and ≥50 complaints |
High-volume surges escalated to Crisis |
| Borderline band |
±0.10 |
Used for Monitor prioritization |
Usage Guidelines
- Always supply movement data:
plot_transition_timeline(transitions, movement_df=movement) is required for priority scoring; omitting it defaults to Priority 2.
- Filter by priority: e.g.
transitions[transitions["priority"] == 1] to summarize crises; risk_level is retained for backward compatibility only.
- Inspect spike markers:
*X, *Y, *XY signal urgent within-quadrant acceleration that may precede cross-quadrant jumps.
- Adjust tracking range deliberately: longer histories surface more transitions; short windows emphasize recent moves.
Changelog
- 2024-11-09 – Introduced priority classification, spike markers, and timeline integration.