game.pred: Print predictions for a future game

View source: R/game.pred.R

game.predR Documentation

Print predictions for a future game

Description

Uses a fitted mvglmmRank object to print predicted scores, win probability, and/or margin of victory for a specified matchup.

Usage

game.pred(res, home, away, neutral.site = FALSE)

Arguments

res

An object of class "mvglmmRank" returned by mvglmmRank.

home

Character string naming the home team. The name should match a team name in the fitted object.

away

Character string naming the away team. The name should match a team name in the fitted object.

neutral.site

Logical. If TRUE and res was fit with home.field = TRUE using data that included neutral-site games, use the neutral-site score mean and omit the binary home-field effect in the printed prediction. If res was fit with home.field = FALSE, this argument has no additional effect because no home-field fixed effect was modeled.

Details

Neutral-site predictions require the training data supplied to mvglmmRank to contain neutral.site = 1 games. If a fitted score model has no neutral-site mean, neutral-site score predictions may be unavailable.

Value

Prints predictions and returns NULL invisibly.

References

Broatch, J.E. and Karl, A.T. (2018). Multivariate Generalized Linear Mixed Models for Joint Estimation of Sporting Outcomes. Italian Journal of Applied Statistics, 30(2), 189-211. Also available from https://arxiv.org/abs/1710.05284.

Karl, A.T., Yang, Y. and Lohr, S. (2014). Computation of Maximum Likelihood Estimates for Multiresponse Generalized Linear Mixed Models with Non-nested, Correlated Random Effects. Computational Statistics & Data Analysis, 73, 146-162. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1016/j.csda.2013.11.019")}.

Karl, A.T. (2012). The Sensitivity of College Football Rankings to Several Modeling Choices. Journal of Quantitative Analysis in Sports, 8(3). \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1515/1559-0410.1471")}.

See Also

mvglmmRank

Examples

data(nfl2012)
fit <- mvglmmRank(nfl2012, method = "PB0", first.order = TRUE,
                  max.iter.EM = 1, verbose = FALSE)
game.pred(fit, home = "Denver Broncos", away = "Green Bay Packers")


mvglmmRank documentation built on June 9, 2026, 5:08 p.m.