Skip to contents

Loads weekly team power ratings – one row per team-week, the as-of- week snapshots behind the season-end ratings. Published to the cfb_ratings_weekly release tag on the sportsdataverse-data repo.

Usage

load_cfb_ratings_weekly(
  seasons = most_recent_cfb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given college football seasons. Published coverage runs 2004 through the most recent season. Pass seasons = TRUE for every published season. (Min: 2004)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a cfbfastR_data tibble.

col_nametypesdescription
seasoninteger
team_idinteger
adj_off_epadoubleOpponent-adjusted offensive EPA per play as of the snapshot week: raw per-game EPA on pass and rush plays net of each opponent's ridge-fitted defensive strength.
adj_def_epadoubleOpponent-adjusted EPA per play allowed as of the snapshot week, netted the same way as the offensive rating, so lower is better.
adj_st_epadoubleSpecial-teams composite in EPA units as of the snapshot week, summing the league-centered per-play EPA of the field goal, punt, and kick-return units.
adj_netdoubleadj_off_epa minus adj_def_epa at the snapshot week, the team's overall efficiency rating in EPA per play with special teams excluded.
fei_offdoubleDrive-level offensive rating at the snapshot week, from a ridge fit on per-drive EPA.
fei_defdoubleDrive-level defensive rating at the snapshot week, from the same per-drive ridge fit and on the same scale as fei_off.
fei_netdoublefei_off minus fei_def at the snapshot week, the team's overall drive-efficiency rating.
gamesinteger
off_pacedoubleScrimmage plays per game through the snapshot week, the tempo input consumed by the totals model.
off_rankintegerDense rank of adj_off_epa in descending order within the snapshot week, so rank 1 is the most efficient offense at that point.
def_rankintegerDense rank of adj_def_epa in ascending order within the snapshot week, so rank 1 is the stingiest defense at that point.
net_rankintegerDense rank of adj_net in descending order within the snapshot week, so rank 1 is the strongest overall team at that point.
net_zdoubleadj_net restated as a z-score against the mean and standard deviation of adj_net across the teams rated in that snapshot week.
through_weekintegerRegular-season week the snapshot runs through; the ratings were refit using only games kicking off on or before that week's final kickoff date.

Author

Saiem Gilani

Examples

# \donttest{
  try(load_cfb_ratings_weekly(2004))
#> ── college football weekly power ratings from the SportsDataverse data repo ────
#> ℹ Data updated: 2026-11-09 21:14:08 UTC
#> # A tibble: 1,585 × 19
#>    season team_id adj_off_epa adj_def_epa adj_st_epa  adj_net fei_off fei_def
#>     <int> <chr>         <dbl>       <dbl>      <dbl>    <dbl>   <dbl>   <dbl>
#>  1   2004 30           0.0516     -0.159      -1.16   0.210    0.131  -0.298 
#>  2   2004 259         -0.0760     -0.0310      1.11  -0.0451  -0.0832 -0.0832
#>  3   2004 2628         0.177       0.159      -1.21   0.0177   0.0894  0.485 
#>  4   2004 2117         0.161       0.0982      0.223  0.0631  -0.575   0.283 
#>  5   2004 264         -0.0807     -0.0719     -2.08  -0.00878 -0.947  -0.711 
#>  6   2004 356          0.127       0.0209      0.889  0.106    0.562  -0.158 
#>  7   2004 151          0.213       0.127       0.213  0.0863  -0.378   0.102 
#>  8   2004 328         -0.0834      0.191       1.67  -0.275   -0.246   0.219 
#>  9   2004 9           -0.0162     -0.0490      0.464  0.0327  -0.378  -0.665 
#> 10   2004 2649         0.142      -0.0509     -0.453  0.193    0.0931  0.856 
#> # ℹ 1,575 more rows
#> # ℹ 11 more variables: fei_net <dbl>, games <int>, off_pace <dbl>,
#> #   off_rank <int>, def_rank <int>, net_rank <int>, net_z <dbl>,
#> #   fei_off_rank <int>, fei_def_rank <int>, fei_net_rank <int>,
#> #   through_week <int>
# }