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.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>
# }