This repository contains code and data to accompany FiveThirtyEight's NFL Predictions game. Specifically, it has:

• Historical NFL scores back to 1920 in data/nfl_games.csv, with FiveThirtyEight's Elo win probabilities for each game.
• Code to generate the Elo win probabilities contained in the data.
• Code to evaluate alternative forecasts against Elo using the historical data and the rules of our game.
• Game schedule and results from the 2017-18 season.
• Anonymized reader forecasts for completed 2017-18 games.

Our goal in providing this repository is for people to be able to figure out how FiveThirtyEight's NFL Elo model and NFL predictions game work and to provide a loose framework for evaluating forecasts against historical data. This repository does not include assistance in building a predictive model.

eval.py is the only runnable script, and does the following:

1. Reads in the CSV of historical games. Each row includes a elo_prob1 field, which is the probability that team1 will win the game according to the Elo model.
2. Fills in a my_prob1 field for every game using code in forecast.py. By default, these are filled in using the exact same Elo model.
3. Evaluates the probabilities stored in my_prob1 against the ones in elo_prob1, and shows how those forecasts would have done in our game for every season since 1920.

Jump in by running python eval.py. You should see the following output:

On average, your forecasts would have gotten 642.61 points per season. Elo got 642.61 points per season.

This makes sense — right now it's just running FiveThirtyEight's Elo model against itself, so it gets the same number of points for every game.

Open up forecast.py, change the HFA (home-field advantage) parameter to 100, and rerun python eval.py. You should see:

On average, your forecasts would have gotten 602.78 points per season. Elo got 642.61 points per season.

OK, looks like changing home-field advantage from 65 to 100 points isn't a good idea. With that tweak, our generated probabilities perform worse historically than the official FiveThirtyEight Elo probabilities.

Inside the Util.read_games function, there are three lines you can uncomment to download the 2017 schedule and results to data/nfl_games_2017.csv. If you run python eval.py after uncommenting them, you'll see something like the following in the output:

Forecasts for upcoming games:
2017-09-07	NE vs. KC		69% (Elo)		73% (You)
2017-09-10	CHI vs. ATL		28% (Elo)		31% (You)
2017-09-10	CIN vs. BAL		63% (Elo)		67% (You)

The scripts are now maintaining Elo ratings through the 2017 season, and printing forecasts (both from elo_prob1 and from my_prob1) for upcoming games. Note that our model is more confident in the home team in every game because we've adjusted the HFA parameter to 100.

Have at it! Some ideas for further exploration:

• Tweak the Elo parameters and margin of victory multiplier and see what happens.
• Augment these Elo ratings with data from other sources to improve forecasts.
• Use this code as an example to build your own model using whatever language, framework or approach you'd like.