Get team game averages for predicted points added (PPA)

Get team game averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_games(
  year,
  week = NULL,
  season_type = "both",
  team = NULL,
  conference = NULL,
  excl_garbage_time = FALSE
)

Arguments

year: (Integer required): Year, 4 digit format (YYYY)
week: (Integer optional): Week - values range from 1-15, 1-14 for seasons pre-playoff, i.e. 2013 or earlier
season_type: (String default both): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason
team: (String optional): D-I Team
conference: (String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC
excl_garbage_time: (Logical default FALSE): Select whether to exclude Garbage Time (TRUE or FALSE)

Value

cfbd_metrics_ppa_games() - A data frame with 18 variables:

game_id: integer.: Referencing game id.
season: integer.: Season of the game.
week: integer.: Game week of the season.
season_type: character.: Season Type (regular, postseason, etc.
conference: character.: Conference of the team.
team: character.: Team name.
opponent: character.: Team Opponent.
off_overall: character.: Offense overall predicted points added (PPA).
off_passing: character.: Offense passing predicted points added (PPA).
off_rushing: character.: Offense rushing predicted points added (PPA).
off_first_down: character.: Offense 1st down predicted points added (PPA).
off_second_down: character.: Offense 2nd down predicted points added (PPA).
off_third_down: character.: Offense 3rd down predicted points added (PPA).
def_overall: character.: Defense overall predicted points added (PPA).
def_passing: character.: Defense passing predicted points added (PPA).
def_rushing: character.: Defense rushing predicted points added (PPA).
def_first_down: character.: Defense 1st down predicted points added (PPA).
def_second_down: character.: Defense 2nd down predicted points added (PPA).
def_third_down: character.: Defense 3rd down predicted points added (PPA).

Examples

# \donttest{
  try(cfbd_metrics_ppa_games(year = 2019, team = "TCU"))
#> ── PPA data from CollegeFootballData.com ───────────────────── cfbfastR 2.0.0 ──
#> ℹ Data updated: 2025-08-30 00:55:18 UTC
#> # A tibble: 12 × 19
#>      game_id season  week season_type team  conference opponent      off_overall
#>        <int>  <int> <int> <chr>       <chr> <chr>      <chr>               <dbl>
#>  1 401112129   2019     1 regular     TCU   Big 12     Arkansas-Pin…        0.07
#>  2 401112130   2019     3 regular     TCU   Big 12     Purdue               0.08
#>  3 401112131   2019     4 regular     TCU   Big 12     SMU                  0.13
#>  4 401112100   2019     5 regular     TCU   Big 12     Kansas               0.39
#>  5 401112088   2019     6 regular     TCU   Big 12     Iowa State           0.23
#>  6 401112109   2019     8 regular     TCU   Big 12     Kansas State         0.16
#>  7 401112132   2019     9 regular     TCU   Big 12     Texas                0.21
#>  8 401112127   2019    10 regular     TCU   Big 12     Oklahoma Sta…        0.12
#>  9 401112081   2019    11 regular     TCU   Big 12     Baylor              -0.06
#> 10 401112133   2019    12 regular     TCU   Big 12     Texas Tech           0.2 
#> 11 401112120   2019    13 regular     TCU   Big 12     Oklahoma            -0.03
#> 12 401112134   2019    14 regular     TCU   Big 12     West Virginia        0.01
#> # ℹ 11 more variables: off_passing <dbl>, off_rushing <dbl>,
#> #   off_first_down <dbl>, off_second_down <dbl>, off_third_down <dbl>,
#> #   def_overall <dbl>, def_passing <dbl>, def_rushing <dbl>,
#> #   def_first_down <dbl>, def_second_down <dbl>, def_third_down <dbl>
# }

Usage

Arguments

Value

See also

Examples