Research note
Composite & lens system
How six weighted lenses become one −100 to +100 regime score: the formula, the weights, the Direction conventions, and hysteresis.
The composite score is a weighted sum of six lens scores, scaled to [-100, +100]:
composite = Σ (lens_score × lens_weight) × 100
Default lens weights
| Lens | Weight |
|---|---|
| macro | 20% |
| credit | 20% |
| breadth | 15% |
| volatility | 20% |
| crossasset | 10% |
| sentiment | 15% |
The weights sum to 1.0.
Each lens score is itself a weighted average of its indicators' regime contributions in [-1, +1]. At the shipped setting, that blend winsorizes them at their mean ± 2.5σ when at least nine weighted contributions are present, so a print beyond that band cannot dominate the lens; a print inside ±2.5σ is left alone. The per-indicator contributions themselves stay raw, so a clipped lens score can differ from them when a clip binds (docs/DATA_QUALITY.md). An indicator's regime contribution is its percentile rank within a 3-year lookback, mapped to [-1, +1] via its Direction:
HIGHER_IS_BULLISH— high percentile → +1 (bullish); e.g. high HY OAS, high VIX (after our May 2026 polarity flip).LOWER_IS_BULLISH— low percentile → +1; e.g. falling DXY.HIGHER_IS_BEARISH_CONTRARIAN— high percentile → −1; e.g. AAII bull-bear at extreme highs (crowded long is bearish input).LOWER_IS_BEARISH_CONTRARIAN— low → −1; capitulation = bullish input (the framework already inverts contrarian indicators internally so "positive contribution = bullish" is always the convention).
Regime classification thresholds
| Composite | Label |
|---|---|
| >= +60 | Strong Bull |
| >= +20 | Bull |
| >= -20 | Neutral |
| >= -60 | Bear |
| < -60 | Strong Bear |
| plumbing trip | Defensive — Plumbing Stress (overrides all of above) |
The headline label is then run through hysteresis: a flip only sticks if the new label has held for at least 3 consecutive raw classifications. This stops the regime label from oscillating on noise. Plumbing trips bypass hysteresis (they're step-changes that demand action immediately).
This article is also a chapter of the Education page.