Package index • PremPredict

Soup to nuts

Find the outcomes that result from a set of simulations, using the model and relevant data

run_simulations(): Assign the model parameters for unplayed games in this Premier League season.

Preparing the data for modelling

get_openData(): Get the latest available results for the Premier League in a given season
get_openData_schedule(): Get the latest available schedule for the Premier League in a given season
get_footballData(): Get the latest available results for the Premier League in a given season
get_results(): Get the Premier League results for the desired seasons
calc_game_latest(): Find the index of the latest game so far in this Premier League season
get_results_filtered(): Get the Premier League results for the desired seasons
calc_table_current(): Calculate the current table for this Premier League season
print_table_current(): Print the current table for this Premier League season

Modelling the data using Firth’s approach

model_prepare_frame(): Prepare the modelframe in order to run the prediction model
model_run(): Run the prediction model
model_extract_parameters(): Run the prediction model
model_parameters_unplayed(): Assign the model parameters for unplayed games in this Premier League season.

Using the model to predict expected outcomes

calc_points_expected_remaining(): Calculate the points expected to be gained by each team in the remainder of this Premier League season
calc_points_expected_total(): Calculate the points expected to be gained by each team across this Premier League season

This is nothing to do with diving! In this section, we simulate many games in order to understand the likelihood of given league outcomes arising

simulate_games(): Assign the model parameters for unplayed games in this Premier League season.
simulate_standings(): Simulate the standings over this Premier League season.
simulate_outcomes(): Show the likelihoods of all possible standings for all clubs over this Premier League season.

Data used in the package

teams: A dataset containing the teams in the latest Premier League season.
previous_seasons: A dataset containing the results of the Premier League from previous seasons.
example_thisSeason: A dataset containing the results of the Premier League from this season so far (as committed on 2025-04-21).
schedule_thisSeason: A dataset containing the schedule of the Premier League this.

Functions used within the package but not exported

calc_points_simulated_match(): Calculate the result of one match, given model parameters and a uniform random variate.
reformat_outcomes(): Reformat the outcomes data for improved presentation.