Skip to contents

Get team averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_teams(
  year = NULL,
  team = NULL,
  conference = NULL,
  excl_garbage_time = FALSE
)

Arguments

year

(Integer optional): Year, 4 digit format (YYYY). Required if team not provided

team

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

conference

(String optional): Conference name - select a valid FBS conference Conference names P5: ACC, Big 12, Big Ten, SEC, Pac-12 Conference names G5 and FBS Independents: Conference USA, Mid-American, Mountain West, FBS Independents, American Athletic

excl_garbage_time

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

Value

cfbd_metrics_ppa_teams() - A data frame with 21 variables:

col_nametypesdescription
seasonintegerFour-digit season year.
conferencecharacterTeam conference name.
teamcharacterTeam name.
off_overallnumericOffense overall predicted points added (PPA).
off_passingnumericOffense passing predicted points added (PPA).
off_rushingnumericOffense rushing predicted points added (PPA).
off_first_downnumericOffense 1st down predicted points added (PPA).
off_second_downnumericOffense 2nd down predicted points added (PPA).
off_third_downnumericOffense 3rd down predicted points added (PPA).
off_cumulative_totalnumericOffense cumulative total predicted points added (PPA).
off_cumulative_passingnumericOffense cumulative total passing predicted points added (PPA).
off_cumulative_rushingnumericOffense cumulative total rushing predicted points added (PPA).
def_overallnumericDefense overall predicted points added (PPA).
def_passingnumericDefense passing predicted points added (PPA).
def_rushingnumericDefense rushing predicted points added (PPA).
def_first_downnumericDefense 1st down predicted points added (PPA).
def_second_downnumericDefense 2nd down predicted points added (PPA).
def_third_downnumericDefense 3rd down predicted points added (PPA).
def_cumulative_totalnumericDefense cumulative total predicted points added (PPA).
def_cumulative_passingnumericDefense cumulative total passing predicted points added (PPA).
def_cumulative_rushingnumericDefense cumulative total rushing predicted points added (PPA).

Examples

# \donttest{
  try(cfbd_metrics_ppa_teams(year = 2019, team = "TCU"))
#> ── Team PPA data from CollegeFootballData.com ──────────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-13 04:18:15 UTC
#> # A tibble: 1 × 21
#>   season conference team  off_overall off_passing off_rushing off_first_down
#>    <int> <chr>      <chr>       <dbl>       <dbl>       <dbl>          <dbl>
#> 1   2019 Big 12     TCU          0.13        0.06        0.23           0.01
#> # ℹ 14 more variables: off_second_down <dbl>, off_third_down <dbl>,
#> #   off_cumulative_total <dbl>, off_cumulative_passing <dbl>,
#> #   off_cumulative_rushing <dbl>, def_overall <dbl>, def_passing <dbl>,
#> #   def_rushing <dbl>, def_first_down <dbl>, def_second_down <dbl>,
#> #   def_third_down <dbl>, def_cumulative_total <dbl>,
#> #   def_cumulative_passing <int>, def_cumulative_rushing <dbl>
# }