Skip to contents

Get opponent-adjusted team season statistics for predicted points added (PPA)

Usage

cfbd_metrics_wepa_team_season(year = NULL, team = NULL, conference = NULL)

Arguments

year

(Integer required): Year, 4 digit format (YYYY)

team

(String optional): D-I Team

conference

(String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

Value

cfbd_metrics_wepa_team_season() - A data frame with 26 variables:

col_nametypesdescription
yearintegerFour-digit season year (e.g. 2019).
team_idintegerCFBD internal team identifier.
teamcharacterFull team name (e.g. "TCU").
conferencecharacterTeam conference name (e.g. "Big 12").
explosivenessnumericOffensive opponent-adjusted explosiveness rate (higher = more big plays).
explosiveness_allowednumericDefensive opponent-adjusted explosiveness rate allowed.
epa_totalnumericOpponent-adjusted total offensive EPA per play (predicted points added).
epa_passingnumericOpponent-adjusted offensive passing EPA per play.
epa_rushingnumericOpponent-adjusted offensive rushing EPA per play.
epa_allowed_totalnumericOpponent-adjusted total defensive EPA per play allowed.
epa_allowed_passingnumericOpponent-adjusted defensive passing EPA per play allowed.
epa_allowed_rushingnumericOpponent-adjusted defensive rushing EPA per play allowed.
success_rate_totalnumericOpponent-adjusted offensive success rate across all plays (proportion 0-1).
success_rate_standard_downsnumericOpponent-adjusted offensive success rate on standard downs (proportion 0-1).
success_rate_passing_downsnumericOpponent-adjusted offensive success rate on passing downs (proportion 0-1).
success_rate_allowed_totalnumericOpponent-adjusted defensive success rate allowed across all plays (proportion 0-1).
success_rate_allowed_standard_downsnumericOpponent-adjusted defensive success rate allowed on standard downs (proportion 0-1).
success_rate_allowed_passing_downsnumericOpponent-adjusted defensive success rate allowed on passing downs (proportion 0-1).
rushing_line_yardsnumericOpponent-adjusted offensive line yards per rush (Football Outsiders methodology).
rushing_second_level_yardsnumericOpponent-adjusted offensive second-level yards per rush (5-10 yards past line of scrimmage).
rushing_open_field_yardsnumericOpponent-adjusted offensive open-field yards per rush (10+ yards past line of scrimmage).
rushing_highlight_yardsnumericOpponent-adjusted offensive highlight yards per opportunity rush.
rushing_allowed_line_yardsnumericOpponent-adjusted defensive line yards per rush allowed.
rushing_allowed_second_level_yardsnumericOpponent-adjusted defensive second-level yards per rush allowed.
rushing_allowed_open_field_yardsnumericOpponent-adjusted defensive open-field yards per rush allowed.
rushing_allowed_highlight_yardsnumericOpponent-adjusted defensive highlight yards per opportunity rush allowed.

Examples

# \donttest{
  try(cfbd_metrics_wepa_team_season(year = 2019, team = "TCU"))
#> ── Opponent-adjusted team season PPA data from CollegeFootballData.com ─────────
#>  Data updated: 2026-06-09 19:57:58 UTC
#> # A tibble: 1 × 26
#>    year team_id team  conference explosiveness explosiveness_allowed epa_total
#>   <int>   <int> <chr> <chr>              <dbl>                 <dbl>     <dbl>
#> 1  2019    2628 TCU   B12                 1.01                 0.987     0.158
#> # ℹ 19 more variables: epa_passing <dbl>, epa_rushing <dbl>,
#> #   epa_allowed_total <dbl>, epa_allowed_passing <dbl>,
#> #   epa_allowed_rushing <dbl>, success_rate_total <dbl>,
#> #   success_rate_standard_downs <dbl>, success_rate_passing_downs <dbl>,
#> #   success_rate_allowed_total <dbl>,
#> #   success_rate_allowed_standard_downs <dbl>,
#> #   success_rate_allowed_passing_downs <dbl>, rushing_line_yards <dbl>, …
# }