
Get player game averages for predicted points added (PPA)
Source:R/cfbd_metrics.R
cfbd_metrics_ppa_players_games.Rd
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).
See also
Other CFBD Metrics:
cfbd_metrics_fg_ep()
,
cfbd_metrics_ppa_games()
,
cfbd_metrics_ppa_players_season()
,
cfbd_metrics_ppa_predicted()
,
cfbd_metrics_ppa_teams()
,
cfbd_metrics_wepa_players_kicking()
,
cfbd_metrics_wepa_players_passing()
,
cfbd_metrics_wepa_players_rushing()
,
cfbd_metrics_wepa_team_season()
,
cfbd_metrics_wp()
,
cfbd_metrics_wp_pregame()
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>
# }