Get player season averages for predicted points added (PPA)
Source:R/cfbd_metrics.R
cfbd_metrics_ppa_players_season.Rd
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.5 ──
#> ℹ Data updated: 2024-09-10 01:23:27 UTC
#> # A tibble: 19 × 23
#> season athlete_id name position team conference countable_plays avg_PPA_all
#> <int> <chr> <chr> <chr> <chr> <chr> <int> <dbl>
#> 1 2019 4427105 Max … QB TCU Big 12 466 0.187
#> 2 2019 4038533 Dari… RB TCU Big 12 177 0.076
#> 3 2019 4038539 Sewo… RB TCU Big 12 164 0.158
#> 4 2019 4241802 Jale… WR TCU Big 12 92 0.299
#> 5 2019 3886634 Alex… QB TCU Big 12 66 0.022
#> 6 2019 4362430 Taye… WR TCU Big 12 49 0.591
#> 7 2019 4362442 Pro … TE TCU Big 12 28 0.642
#> 8 2019 4426635 Darw… RB TCU Big 12 23 0.166
#> 9 2019 4362477 Deri… WR TCU Big 12 21 0.243
#> 10 2019 4362478 Emar… RB TCU Big 12 18 -0.149
#> 11 2019 4038556 Arta… TE TCU Big 12 16 0.506
#> 12 2019 4362489 John… WR TCU Big 12 15 0.726
#> 13 2019 4038536 Dyla… WR TCU Big 12 10 1.18
#> 14 2019 4362483 Teva… WR TCU Big 12 9 0.385
#> 15 2019 3676818 TreV… WR TCU Big 12 9 0.462
#> 16 2019 4427217 Daim… RB TCU Big 12 8 0.365
#> 17 2019 4426965 Blai… WR TCU Big 12 4 1.07
#> 18 2019 4259331 Cart… TE TCU Big 12 2 0.808
#> 19 2019 4241795 Al'D… WR TCU Big 12 1 3.18
#> # ℹ 15 more variables: avg_PPA_pass <dbl>, avg_PPA_rush <dbl>,
#> # 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>
# }