Skip to content
MVIE Pro
Methodology

A white box, on purpose

Every number the engine reports can be traced back to a published method. This page covers the mathematics inside, why the model refuses to be a black box, how it differs from VaR, and the evidence behind it.

Inside the Brain: how MVIE works

We don't hide the math. Every layer is documented and reproducible.

1. Multi-Window Instability Engine

The MVIE composite score blends three rolling Z-scored metrics—Absorption Ratio (PCA variance concentration), Instability Score (correlation-structure change rate), and Priority Drift (MST centrality rank drift)—across 30/60/90-day windows:

Composite formula · pseudocode

# Pseudocode — MVIE composite pipeline# AR, IS, and PD are each rolling Z-score outputs (30/60/90-day windows)AR = z_score(pca_variance_share(asset_returns, top_components=3))IS = z_score(correlation_structure_change_rate(correlation_matrix, baseline))PD = z_score(network_centrality_drift(min_spanning_tree, window=rolling_window))MVIE = (0.40 * AR) + (0.35 * IS) + (0.25 * PD)

Regime thresholds:

  • 0–50 GREEN — Stable absorption / correlation structure; centrality ranks steady
  • 50–75 AMBER — PCA concentration or correlation drift rising; MST hub order shifting
  • 75–100 RED — Systemic stress band; correlation breakdown and centrality drift elevated

2. Network Topology Analysis

Spearman correlation builds a Minimum Spanning Tree (d_ij = sqrt(2(1 − ρ_ij))). Eigenvector, betweenness, and degree centrality on the MST quantify systemic hubs—and feed Priority Drift when rank order changes across rolling windows:

  • Eigenvector centrality — Hub assets whose stress propagates through the MST (e.g., SPY)
  • Betweenness centrality — Bridge nodes linking otherwise disconnected clusters (contagion paths)
  • Degree centrality — Direct connectivity count; used with rank drift for Priority Drift (PD)

3. Probabilistic Strategy Engine

Composite regime readings (AR · IS · PD) feed a probabilistic scenario layer—illustrative BULLISH / BEARISH / NEUTRAL labels with volatility envelopes, aligned to the same macro-risk stack as the dashboard:

Scenario weights · illustrative output

Composite weights (engine — matches MVIE pipeline):  Absorption Ratio (AR):           40%  Instability Score (IS):          35%  Priority Drift (PD):             25%Output:  Direction:    BULLISH | BEARISH | NEUTRAL  Probability:  P(direction) ∈ [0, 1]  Envelope:     ±2σ volatility band (illustrative)  Horizon:      5 trading days, best / base / worst projections

4. Veto Protocol

The Veto Protocol is a model override rule. When MVIE > 75 (RED regime), all BULLISH scenario labels are reclassified to NEUTRAL or defensive overlays in the published set, regardless of micro-indicator strength. In crisis regimes, the engine treats micro readings as high-noise; the defensive scenario narrative takes precedence in the illustrative output.

5. LLM Analyst Layer

A large language model layer synthesizes the quantitative output into a structured institutional report. The prompt is compliance-locked — no investment advice, only analytical scenarios. Output is markdown-formatted with explicit risk framework sections. The underlying model can be swapped as newer APIs become available.

Transparent Quant · No Black Boxes

Every signal is an auditable differential equation. Not a black box.

MVIE Pro reads markets with transparent mathematics — eigenvalue decomposition, Frobenius norms, and Minimum Spanning Tree centrality. The LLM layer synthesises the quantitative output into institutional language. You can inspect every Z-score, every weight, every threshold.

MVIEComposite MVIE Score

MVIE = 0.40 × AR + 0.35 × IS + 0.25 × PD

Weighted composite of three structural regime indicators, scaled 0–100.

ARAbsorption Ratio

AR = Σλ(top 20%) / Σλ(all)

Share of total variance absorbed by the dominant eigenvectors of the covariance matrix. High AR → correlated, fragile regime.

ISInstability Score

IS = ‖C_t − C_baseline‖_F

Frobenius norm of the change in Spearman correlation matrix vs. baseline. Captures structural rewiring speed.

PDPriority Drift

PD = Σ |rank_t(i) − rank_0(i)| / N

Mean absolute rank displacement of eigenvector centrality in the Minimum Spanning Tree. Measures leadership rotation in the asset network.

λEigenvalue DecompositionZZ-Score NormalizationΣWeighted Composite

Quantitative output → LLM synthesis → institutional report

LIVE OUTPUT
1# MVIE Analyst Report
2regime: AMBER → RED TRANSITION
3mvie_score: 74.2
4ar_zscore: +2.1σ ← Systemic risk rising
5is_zscore: +1.8σ ← Correlation rewiring
6pd_zscore: +1.4σ ← Centrality rotating
7
8§ MACRO CONTEXT:
9 Eigenvalue dispersion rising across 60d/90d
10 windows. Correlation structure shows early-
11 stage regime transition. SPY eigenvector
12 centrality at 0.68 (+0.11 vs prior week).
13
14veto_protocol: APPROACHING THRESHOLD
15disclaimer: observational only — not advice
16

⚠ All outputs are educational scenario descriptions, not investment advice. The LLM layer is compliance-locked — no price targets, no recommendations.

Traditional approach vs. MVIE Pro

Traditional Risk ToolsMVIE Pro
Single correlation windowMulti-window analysis (30/60/90-day rolling)
Static risk metricsDynamic MVIE score (0-100) with regime classification
Ignores asset network effectsMinimum Spanning Tree topology + centrality metrics
Deterministic buy/sell labelsProbabilistic scenarios with volatility envelopes (illustrative)
No macro override mechanismVeto Protocol — macro risk overrides micro signals
Black-box ML modelsTransparent mathematics — every Z-score is auditable

Historical sample observations (not forecasts)

In a historical sample, MVIE score reached 87.3 on Feb 10, 2020—before the widely observed COVID stress window (illustrative backtest, not a guarantee of future timing)

MVIE ENGINE · 2020-02-10RED REGIME
87.3MVIE COMPOSITE
AR: 91.2IS: 84.7PD: 83.1
⚠ VETO PROTOCOL ENGAGED — all BULLISH signals → NEUTRAL

Network topology output showing SPY as dominant hub (eigenvector 0.68)

MINIMUM SPANNING TREE · CENTRALITY OUTPUT
SPY
0.68
QQQ
0.52
DXY
0.41
GLD
0.29
VIX
0.38
Nodes: 18Edges: 17 (MST)Hub: SPY
DENSITY: 0.42TOPOLOGY: MSTCLUSTERING: HIGH

LLM analyst report sample (structured institutional output)

── MVIE ANALYST REPORT ─────────────────
REGIME: AMBER → RED TRANSITION
Generated: 2024-08-14 · Model: llama-3.3-70b
§1 MACRO CONTEXT
Eigenvalue dispersion rising across 60d/90d windows. Correlation structure shows early-stage regime transition signal...
§2 RISK ASSESSMENT
Network hub SPY eigenvector centrality at 0.61 (+0.09 vs prior week). Betweenness concentration elevated in equity cluster...
§3 SCENARIO SET
BEARISH: 58% · NEUTRAL: 31% · BULLISH: 11% (pre-veto weights)
⚠ Educational output only — not investment advice

Veto Protocol activation log — 2022 bear market

VETO PROTOCOL LOG · 2022-Q1/Q2
2022-01-2476.2VETO ENGAGED
2022-02-2481.5VETO ACTIVE · WAR SHOCK
2022-03-0779.4CORRELATION BREAKDOWN
2022-05-0988.9PEAK STRESS · ALL NEUTRAL
2022-06-1683.1FED +75bps · SUSTAINED
2022-08-2674.8RISK-OFF PERSISTENT
2022-10-1371.4VETO DISENGAGED

[SYSTEM AUDIT SECURE — LOG END]