How jpmouracodex/football-mle works
football_mle is a football-score MLE library with a Streamlit interface for club leagues and World Cup scenarios. The main workflow loads match data, canonicalizes it and applies time weights, fits Maher or Dixon–Coles parameters, then predicts scores and 1X2 outcomes or evaluates forecasts. A separate tournament branch reconstructs groups and simulates the knockout competition. README capabilities are retained; edges reflect only README or indexed-source relationships, since several implementation details were not excerpted.
Main entry points: streamlit_app.py Streamlit interface · fitting.py MLE and uncertainty · simulation.py Tournament simulation · leagues.py League loaders
Components 19
Streamlit app
- Streamlit interface
app/streamlit_app.py - Team flags
app/flags.py - Translations
app/i18n.py - Team names
app/team_names.py
Match data
- League loaders
football_mle/sources/leagues.py - International loaders
football_mle/sources/international.py - HTTP helpers
football_mle/sources/_http.py - Canonical data and weights
football_mle/data.py
Model fitting
- Likelihood and rates
football_mle/likelihood.py - MLE and uncertainty
football_mle/fitting.py - Maher model
football_mle/maher.py - Dixon–Coles model
football_mle/dixon_coles.py
Predictions and evaluation
- Score prediction
football_mle/prediction.py - Forecast validation
football_mle/validation.py
Tournament simulation
- Fixture sampler
football_mle/simulation.py - Tournament simulation
football_mle/simulation.py
Other components
- User
- League results
- International results and fixtures
Connections 26
- User → Streamlit interface: uses
README.md - Streamlit interface → Team flags: uses
app/streamlit_app.py - Streamlit interface → Translations: uses
app/streamlit_app.py - Streamlit interface → Team names: uses
app/streamlit_app.py - Streamlit interface → League loaders: loads leagues
app/streamlit_app.py - Streamlit interface → International loaders: loads internationals
app/streamlit_app.py - League loaders → HTTP helpers: fetches via
football_mle/sources/leagues.py - International loaders → HTTP helpers: fetches via
football_mle/sources/international.py - League loaders → Canonical data and weights: standardizes
football_mle/sources/leagues.py - League results → League loaders: provides results
README.md - International results and fixtures → International loaders: provides results
README.md - Streamlit interface → Canonical data and weights: prepares matches
app/streamlit_app.py - Canonical data and weights → Maher model: provides match data
football_mle/maher.py - Canonical data and weights → Dixon–Coles model: provides match data
football_mle/dixon_coles.py - Maher model → MLE and uncertainty: delegates fitting
football_mle/maher.py - Dixon–Coles model → MLE and uncertainty: delegates fitting
football_mle/dixon_coles.py - MLE and uncertainty → Likelihood and rates: optimizes objective
football_mle/fitting.py - Streamlit interface → Score prediction: predicts fixtures
README.md - MLE and uncertainty → Score prediction: supplies fitted model
football_mle/prediction.py - Streamlit interface → Forecast validation: evaluates forecasts
- Forecast validation → Score prediction: scores predictions
football_mle/validation.py - Streamlit interface → Tournament simulation: runs tournament
app/streamlit_app.py - Tournament simulation → Fixture sampler: samples fixtures
football_mle/simulation.py - Fixture sampler → Score prediction: builds score distributions
football_mle/simulation.py - Tournament simulation → International loaders: uses World Cup fixtures
README.md - Tournament simulation → MLE and uncertainty: uses team ratings
football_mle/simulation.py