Skip to contents

Get player game averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_players_games(
  year = NULL,
  week = NULL,
  season_type = "both",
  team = NULL,
  position = NULL,
  athlete_id = NULL,
  threshold = 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. Required if team not provided.

season_type

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

team

(String optional): D-I Team. Required if week not provided.

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_games() - A data frame with 9 variables:

season: integer.

Season of the game.

week: integer.

Game week of the season.

athlete_id: character.

Athlete referencing id.

name: character.

Athlete name.

position: character.

Athlete position.

team: character.

Team name.

opponent: character.

Team Opponent name.

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).

Examples

# \donttest{
  try(cfbd_metrics_ppa_players_games(year = 2019, week = 3, team = "TCU"))
#> ── Player PPA data from CollegeFootballData.com ────────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-30 00:55:19 UTC
#> # A tibble: 8 × 11
#>   season  week season_type athlete_id name   position team  opponent avg_PPA_all
#>    <int> <int> <chr>       <chr>      <chr>  <chr>    <chr> <chr>          <dbl>
#> 1   2019     3 regular     3886634    Alex … QB       TCU   Purdue        -0.861
#> 2   2019     3 regular     4038533    Dariu… RB       TCU   Purdue         0.629
#> 3   2019     3 regular     4038539    Sewo … RB       TCU   Purdue         0.374
#> 4   2019     3 regular     4241795    Al'Do… WR       TCU   Purdue         3.18 
#> 5   2019     3 regular     4241802    Jalen… WR       TCU   Purdue         0.008
#> 6   2019     3 regular     4362442    Pro W… TE       TCU   Purdue         0.129
#> 7   2019     3 regular     4362478    Emari… RB       TCU   Purdue        -0.08 
#> 8   2019     3 regular     4427105    Max D… QB       TCU   Purdue        -0.184
#> # ℹ 2 more variables: avg_PPA_pass <dbl>, avg_PPA_rush <dbl>
# }