Skip to contents

Get game advanced stats

Usage

cfbd_stats_game_advanced(
  year,
  week = NULL,
  team = NULL,
  opponent = NULL,
  excl_garbage_time = FALSE,
  season_type = "both"
)

Arguments

year

(Integer required): Year, 4 digit format(YYYY)

week

(Integer optional): Week - values from 1-15, 1-14 for seasons pre-playoff (i.e. 2013 or earlier)

team

(String optional): D-I Team

opponent

(String optional): Opponent D-I Team

excl_garbage_time

(Logical default FALSE): Select whether to exclude Garbage Time (TRUE/FALSE)

season_type

(String default both): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason

Value

cfbd_stats_game_advanced() - A data frame with 60 variables:

game_id: integer.

Referencing game id.

season: integer.

Season of the game.

week: integer.

Game week of the season.

team: character.

Team name.

opponent: character.

Opponent team name.

off_plays: integer.

Offense plays in the game.

off_drives: integer.

Offense drives in the game.

off_ppa: double.

Offense predicted points added (PPA).

off_total_ppa: double.

Offense total predicted points added (PPA).

off_success_rate: double.

Offense success rate.

off_explosiveness: double.

Offense explosiveness rate.

off_power_success: double.

Offense power success rate.

off_stuff_rate: double.

Opponent stuff rate.

off_line_yds: double.

Offensive line yards.

off_line_yds_total: integer.

Offensive line yards total.

off_second_lvl_yds: double.

Offense second-level yards.

off_second_lvl_yds_total: integer.

Offense second-level yards total.

off_open_field_yds: integer.

Offense open field yards.

off_open_field_yds_total: integer.

Offense open field yards total.

off_standard_downs_ppa: double.

Offense standard downs predicted points added (PPA).

off_standard_downs_success_rate: double.

Offense standard downs success rate.

off_standard_downs_explosiveness: double.

Offense standard downs explosiveness rate.

off_passing_downs_ppa: double.

Offense passing downs predicted points added (PPA).

off_passing_downs_success_rate: double.

Offense passing downs success rate.

off_passing_downs_explosiveness: double.

Offense passing downs explosiveness rate.

off_rushing_plays_ppa: double.

Offense rushing plays predicted points added (PPA).

off_rushing_plays_total_ppa: double.

Offense rushing plays total predicted points added (PPA).

off_rushing_plays_success_rate: double.

Offense rushing plays success rate.

off_rushing_plays_explosiveness: double.

Offense rushing plays explosiveness rate.

off_passing_plays_ppa: double.

Offense passing plays predicted points added (PPA).

off_passing_plays_total_ppa: double.

Offense passing plays total predicted points added (PPA).

off_passing_plays_success_rate: double.

Offense passing plays success rate.

off_passing_plays_explosiveness: double.

Offense passing plays explosiveness rate.

def_plays: integer.

Defense plays in the game.

def_drives: integer.

Defense drives in the game.

def_ppa: double.

Defense predicted points added (PPA).

def_total_ppa: double.

Defense total predicted points added (PPA).

def_success_rate: double.

Defense success rate.

def_explosiveness: double.

Defense explosiveness rate.

def_power_success: double.

Defense power success rate.

def_stuff_rate: double.

Opponent stuff rate.

def_line_yds: double.

Offensive line yards.

def_line_yds_total: integer.

Offensive line yards total.

def_second_lvl_yds: double.

Defense second-level yards.

def_second_lvl_yds_total: integer.

Defense second-level yards total.

def_open_field_yds: integer.

Defense open field yards.

def_open_field_yds_total: integer.

Defense open field yards total.

def_standard_downs_ppa: double.

Defense standard downs predicted points added (PPA).

def_standard_downs_success_rate: double.

Defense standard downs success rate.

def_standard_downs_explosiveness: double.

Defense standard downs explosiveness rate.

def_passing_downs_ppa: double.

Defense passing downs predicted points added (PPA).

def_passing_downs_success_rate: double.

Defense passing downs success rate.

def_passing_downs_explosiveness: double.

Defense passing downs explosiveness rate.

def_rushing_plays_ppa: double.

Defense rushing plays predicted points added (PPA).

def_rushing_plays_total_ppa: double.

Defense rushing plays total predicted points added (PPA).

def_rushing_plays_success_rate: double.

Defense rushing plays success rate.

def_rushing_plays_explosiveness: double.

Defense rushing plays explosiveness rate.

def_passing_plays_ppa: double.

Defense passing plays predicted points added (PPA).

def_passing_plays_total_ppa: double.

Defense passing plays total predicted points added (PPA).

def_passing_plays_success_rate: double.

Defense passing plays success rate.

def_passing_plays_explosiveness: double.

Defense passing plays explosiveness rate.

Examples

# \donttest{
   try(cfbd_stats_game_advanced(year = 2018, week = 12, team = "Texas A&M"))
#> ── Advanced game stats from CollegeFootballData.com ────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-25 19:41:29 UTC
#> # A tibble: 1 × 61
#>   game_id season  week team  opponent off_plays off_drives off_ppa off_total_ppa
#>     <int>  <int> <int> <chr> <chr>        <int>      <int>   <dbl>         <dbl>
#> 1  4.01e8   2018    12 Texa… UAB             56         11   0.408          22.9
#> # ℹ 52 more variables: off_success_rate <dbl>, off_explosiveness <dbl>,
#> #   off_power_success <dbl>, off_stuff_rate <dbl>, off_line_yds <dbl>,
#> #   off_line_yds_total <int>, off_second_lvl_yds <dbl>,
#> #   off_second_lvl_yds_total <int>, off_open_field_yds <dbl>,
#> #   off_open_field_yds_total <int>, off_standard_downs_ppa <dbl>,
#> #   off_standard_downs_success_rate <dbl>,
#> #   off_standard_downs_explosiveness <dbl>, off_passing_downs_ppa <dbl>, …

   try(cfbd_stats_game_advanced(2019, team = "LSU"))
#> ── Advanced game stats from CollegeFootballData.com ────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-25 19:41:29 UTC
#> # A tibble: 15 × 61
#>      game_id season  week team  opponent           off_plays off_drives off_ppa
#>        <int>  <int> <int> <chr> <chr>                  <int>      <int>   <dbl>
#>  1 401110725   2019     1 LSU   Georgia Southern          73         13   0.377
#>  2 401110778   2019     2 LSU   Texas                     70         12   0.484
#>  3 401110790   2019     3 LSU   Northwestern State        69         12   0.598
#>  4 401110805   2019     4 LSU   Vanderbilt                74         17   0.286
#>  5 401110813   2019     6 LSU   Utah State                90         13   0.331
#>  6 401110819   2019     7 LSU   Florida                   48         11   0.736
#>  7 401110828   2019     8 LSU   Mississippi State         63         13   0.215
#>  8 401110833   2019     9 LSU   Auburn                    88         15   0.119
#>  9 401110842   2019    11 LSU   Alabama                   82         14   0.285
#> 10 401110850   2019    12 LSU   Ole Miss                  83         14   0.493
#> 11 401110859   2019    13 LSU   Arkansas                  48         12   0.796
#> 12 401110869   2019    14 LSU   Texas A&M                 77         13   0.422
#> 13 401132981   2019    15 LSU   Georgia                   77         11   0.323
#> 14 401135278   2019     1 LSU   Oklahoma                  73         12   0.632
#> 15 401135295   2019     1 LSU   Clemson                   80         15   0.423
#> # ℹ 53 more variables: off_total_ppa <dbl>, off_success_rate <dbl>,
#> #   off_explosiveness <dbl>, off_power_success <dbl>, off_stuff_rate <dbl>,
#> #   off_line_yds <dbl>, off_line_yds_total <int>, off_second_lvl_yds <dbl>,
#> #   off_second_lvl_yds_total <int>, off_open_field_yds <dbl>,
#> #   off_open_field_yds_total <int>, off_standard_downs_ppa <dbl>,
#> #   off_standard_downs_success_rate <dbl>,
#> #   off_standard_downs_explosiveness <dbl>, off_passing_downs_ppa <dbl>, …

   try(cfbd_stats_game_advanced(2013, team = "Florida State"))
#> ── Advanced game stats from CollegeFootballData.com ────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-25 19:41:30 UTC
#> # A tibble: 14 × 61
#>      game_id season  week team          opponent   off_plays off_drives  off_ppa
#>        <int>  <int> <int> <chr>         <chr>          <int>      <int>    <dbl>
#>  1 332450221   2013     1 Florida State Pittsburgh        58         10  4.46e-1
#>  2 332570052   2013     3 Florida State Nevada            56         12  4.37e-1
#>  3 332640052   2013     4 Florida State Bethune-C…        55         11  3.34e-1
#>  4 332710103   2013     5 Florida State Boston Co…        56         12  2.23e-1
#>  5 332780052   2013     6 Florida State Maryland          72         12  2.76e-1
#>  6 332920228   2013     8 Florida State Clemson           68         12  2.40e-1
#>  7 332990052   2013     9 Florida State NC State          58         14  3.53e-1
#>  8 333060052   2013    10 Florida State Miami             69         11  3.07e-1
#>  9 333130154   2013    11 Florida State Wake Fore…        64         14 -4.27e-4
#> 10 333200052   2013    12 Florida State Syracuse          36         10  4.50e-1
#> 11 333270052   2013    13 Florida State Idaho             68         14  2.12e-1
#> 12 333340057   2013    14 Florida State Florida           60         11  2.12e-1
#> 13 333410052   2013    15 Florida State Duke              69         15  2.31e-1
#> 14 340060002   2013     1 Florida State Auburn            61         12  2.20e-1
#> # ℹ 53 more variables: off_total_ppa <dbl>, off_success_rate <dbl>,
#> #   off_explosiveness <dbl>, off_power_success <dbl>, off_stuff_rate <dbl>,
#> #   off_line_yds <dbl>, off_line_yds_total <int>, off_second_lvl_yds <dbl>,
#> #   off_second_lvl_yds_total <int>, off_open_field_yds <dbl>,
#> #   off_open_field_yds_total <int>, off_standard_downs_ppa <dbl>,
#> #   off_standard_downs_success_rate <dbl>,
#> #   off_standard_downs_explosiveness <dbl>, off_passing_downs_ppa <dbl>, …
# }