Basic Prerequisites: Statistics & Inference (maximum likelihood, Gaussian densities) and Probability & Measure Theory (Bayes’ rule, conditional expectation, Markov chains). The econometric twin of this folder lives in Regime Detection - that folder is the Hamilton-filter / Markov-switching / timeseries view; this folder is the machine-learning view: clustering (GMM / K-means), the EM algorithm, HMM as a probabilistic generative model, and regime-conditional supervised learning. (these are the folder-level prerequisites for pages 02–06; page 01 states its own, smaller, entry requirements)


1. Intuition & Practical Objective

Markets spend most of their time in a latent state you never observe directly - calm, low-volatility grind versus panic, spiking-volatility crash. If the data-generating process for returns changes regime, then a single unconditional mean/vol fit is wrong in both regimes, and a strategy tuned on calm data is fragile exactly when turbulence arrives. Regime classification is the ML answer to the same question the econometrician’s filter asks: learn the regimes from the data, and assign each observation (or each day) to the regime it came from.

Where this folder sits in the ML map:

  1. Unsupervised regime detection. If a regime is a cluster in feature space (low vol, positive return vs high vol, negative return), then regime membership is a clustering problem - GMM / K-means on features 02.
  2. The EM algorithm is the workhorse that fits every model in this folder: it is how GMMs are trained and how the HMM’s Baum–Welch step works 03.
  3. HMM as a probabilistic regime model. Regimes are not independent draws - they persist and switch, so a hidden Markov chain over the latent state is the natural generative model; forward–backward + Viterbi give you the posterior state path 04.
  4. Supervised regime labeling. When you have a regime proxy (a VIX threshold, an NBER recession flag, a drawdown rule), you can train a classifier on features instead of clustering - the bridge into regime-conditional supervised ML 06.

The one-sentence essence. “A regime is a latent label; the entire folder is two moves - (i) model the joint probability of observations and hidden regime (GMM: independent, HMM: Markov-persistent), and (ii) fit it by maximum likelihood via EM, then label each point by its posterior (responsibility, filtered, or Viterbi probability).“


2. Mathematical Ground Truth & Quick Lookup

Notation. observation/feature vector; latent regime; mixture weight / initial state prob; regime-conditional mean/covariance; transition; posterior; effective count.

GMM (independent mixture) - likelihood and EM (Dempster–Laird–Rubin 1977; ESL Ch 14.3):

HMM (Markov-persistent mixture) - forward–backward (Rabiner 1989; ESL Ch 14):

QuantityFormulaVerified check (this folder’s runs)
K-means regime labels vs truthnearest-mean assignment on (z-vol, z-return) featuresagreement 78.1% (480 rows, 2 clusters)
GMM (EM) recovered volstate 0 low-vol , state 1 high-vol true , - recovered within sampling error
GMM log-likelihood monotonicity, monotone, last-20
EM 2D-GMM paramsfull-cov two components, 300 ptsLL ; means recovered vs true
HMM (Baum–Welch) transitiontrue
HMM Viterbi path vs truthmax-product decodingagreement 95.8% (600 days)
Label switchinglikelihood symmetric under state permutationrun A vs run B: identical LL , labels swapped
Overfitting (BIC): best; :
Look-ahead in labelssmoothed (uses future) vs filtered (online)smoothed vs filtered - a pt fake edge

Critical caveat. The regime label is arbitrary. The likelihood is exactly invariant under a permutation of the states (label switching), so “state 0” carries no intrinsic meaning. Any downstream system that hard-codes “state 0 = calm” must instead impose an identifiability constraint (e.g. , or ) at fit time - the exact degeneracy exploited in 05 · Failure Modes.


3. Computational Implementation - the whole toolbox in one file

Standard library + numpy only. The index gives the fastest demo of the folder’s central mechanism - EM drives the likelihood up monotonically (the guarantee behind both GMM and HMM training):

The full, working fits - K-means feature clustering, the GMM EM from scratch, the 2-D EM, the Baum–Welch HMM with Viterbi, and the failure-mode experiments - are the verified §3 blocks on the sub-pages, each reproduced byte-for-byte there.


4. Failure Modes & First-Principles Breakdowns (hub signposts)

The full analysis lives in 05 · Failure Modes & Practice. In one line each:

  1. Label switching - the likelihood is symmetric under state permutation, so the same data can yield swapped labels (verified: two EM runs, LL both , labels reversed). Fix: an ordering constraint () or a domain label.
  2. Overfitting - adding a state always raises the likelihood; on genuine 2-regime data a 3-state fit splits a regime into near-clones (verified: LL but BIC prefers , vs ). Fix: penalize with BIC.
  3. Look-ahead in regime labels - smoothed/decoded labels use future observations; using them at time is information leakage (verified: pt agreement). Fix: label with the online filtered posterior, not the full-sample smoothed one.
  4. Hard regime-switching is fragile to label error - with opposite-sign regime models, one wrong hard label flips the coefficient sign and can hurt (verified: hard-switch vs soft-mixture ).

5. References

  • Hamilton, James D.: “A New Approach to the Economic Analysis of Nonstationary Time Series and the Business Cycle,” Econometrica 57(2):357–384, 1989
  • Dempster, Arthur P., Laird, Nan M. & Rubin, Donald B.: “Maximum Likelihood from Incomplete Data via the EM Algorithm,” Journal of the Royal Statistical Society B 39(1):1–38, 1977
  • Rabiner, Lawrence R.: “A Tutorial on Hidden Markov Models and Selected Applications in Speech Recognition,” Proceedings of the IEEE 77(2):257–286, 1989
  • Ang, Andrew & Timmermann, Allan: “Regime Changes and Financial Markets,” Annual Review of Financial Economics 4:313–337, 2012
  • Hastie, Tibshirani & Friedman, The Elements of Statistical Learning (2nd ed., 2009)
  • Tsay, Ruey S., Analysis of Financial Time Series (3rd ed., 2010)

6. Connected Graph Bridges

Beginner: start at 01 · Practitioner: start at 05