Skip to contents

Get player season averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_players_season(
  year = NULL,
  team = NULL,
  conference = NULL,
  position = NULL,
  athlete_id = NULL,
  threshold = NULL,
  excl_garbage_time = FALSE
)

Arguments

year

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

team

(String optional): D-I Team

conference

(String optional): Conference abbreviation - S&P+ information by conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

position

(string optional): Position abbreviation of the player you are searching for. Position Group - options include:

  • Offense: QB, RB, FB, TE, OL, G, OT, C, WR

  • Defense: DB, CB, S, LB, DE, DT, NT, DL

  • Special Teams: K, P, LS, PK

athlete_id

(Integer optional): Athlete ID filter for querying a single athlete Can be found using the cfbd_player_info() function.

threshold

(Integer optional): Minimum threshold of plays.

excl_garbage_time

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

Value

cfbd_metrics_ppa_players_season() - A data frame with 23 variables:

season: integer.

Season.

athlete_id: character.

Athlete referencing id.

name: character.

Athlete name.

position: character.

Athlete Position.

team: character.

Team name.

conference: character.

Team conference.

countable_plays: integer.

Number of plays which can be counted.

avg_PPA_all: double.

Average overall predicted points added (PPA).

avg_PPA_pass: double.

Average passing predicted points added (PPA).

avg_PPA_rush: double.

Average rushing predicted points added (PPA).

avg_PPA_first_down: double.

Average 1st down predicted points added (PPA).

avg_PPA_second_down: double.

Average 2nd down predicted points added (PPA).

avg_PPA_third_down: double.

Average 3rd down predicted points added (PPA).

avg_PPA_standard_downs: double.

Average standard down predicted points added (PPA).

avg_PPA_passing_downs: double.

Average passing down predicted points added (PPA).

total_PPA_all: double.

Total overall predicted points added (PPA).

total_PPA_pass: double.

Total passing predicted points added (PPA).

total_PPA_rush: double.

Total rushing predicted points added (PPA).

total_PPA_first_down: double.

Total 1st down predicted points added (PPA).

total_PPA_second_down: double.

Total 2nd down predicted points added (PPA).

total_PPA_third_down: double.

Total 3rd down predicted points added (PPA).

total_PPA_standard_downs: double.

Total standard down predicted points added (PPA).

total_PPA_passing_downs: double.

Total passing down predicted points added (PPA).

Examples

# \donttest{
  try(cfbd_metrics_ppa_players_season(year = 2019, team = "TCU"))
#> ── Player season PPA data from CollegeFootballData.com ─────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-09-23 03:23:15 UTC
#> # A tibble: 19 × 23
#>    season athlete_id name  posit…¹ team  confe…² count…³ avg_P…⁴ avg_P…⁵ avg_P…⁶
#>     <int> <chr>      <chr> <chr>   <chr> <chr>     <int>   <dbl>   <dbl>   <dbl>
#>  1   2019 4427105    Max … QB      TCU   Big 12      466   0.187   0.092   0.518
#>  2   2019 4038533    Dari… RB      TCU   Big 12      177   0.076  -0.144   0.114
#>  3   2019 4038539    Sewo… RB      TCU   Big 12      164   0.158  -0.104   0.224
#>  4   2019 4241802    Jale… WR      TCU   Big 12       92   0.299   0.347   0.03 
#>  5   2019 3886634    Alex… QB      TCU   Big 12       66   0.022  -0.124   0.565
#>  6   2019 4362430    Taye… WR      TCU   Big 12       49   0.591   0.55    0.958
#>  7   2019 4362442    Pro … TE      TCU   Big 12       28   0.642   0.642  NA    
#>  8   2019 4426635    Darw… RB      TCU   Big 12       23   0.166  -0.881   0.214
#>  9   2019 4362477    Deri… WR      TCU   Big 12       21   0.243   0.296  -0.075
#> 10   2019 4362478    Emar… RB      TCU   Big 12       18  -0.149  NA      -0.149
#> 11   2019 4038556    Arta… TE      TCU   Big 12       16   0.506   0.506  NA    
#> 12   2019 4362489    John… WR      TCU   Big 12       15   0.726   0.726  NA    
#> 13   2019 4038536    Dyla… WR      TCU   Big 12       10   1.18    1.18   NA    
#> 14   2019 4362483    Teva… WR      TCU   Big 12        9   0.385   0.385  NA    
#> 15   2019 3676818    TreV… WR      TCU   Big 12        9   0.462   0.462  NA    
#> 16   2019 4427217    Daim… RB      TCU   Big 12        8   0.365  NA       0.365
#> 17   2019 4426965    Blai… WR      TCU   Big 12        4   1.07    1.07   NA    
#> 18   2019 4259331    Cart… TE      TCU   Big 12        2   0.808   0.808  NA    
#> 19   2019 4241795    Al'D… WR      TCU   Big 12        1   3.18    3.18   NA    
#> # … with 13 more variables: avg_PPA_first_down <dbl>,
#> #   avg_PPA_second_down <dbl>, avg_PPA_third_down <dbl>,
#> #   avg_PPA_standard_downs <dbl>, avg_PPA_passing_downs <dbl>,
#> #   total_PPA_all <dbl>, total_PPA_pass <dbl>, total_PPA_rush <dbl>,
#> #   total_PPA_first_down <dbl>, total_PPA_second_down <dbl>,
#> #   total_PPA_third_down <dbl>, total_PPA_standard_downs <dbl>,
#> #   total_PPA_passing_downs <dbl>, and abbreviated variable names ¹​position, …
# }