Skip to contents

Loads season-level advanced passing stats – one row per qualifying passer with EPA, CPOE, air-yards, and pressure splits. Published to the espn_cfb_adv_passing release tag on the sportsdataverse-data repo.

Usage

load_espn_cfb_adv_passing(
  seasons = most_recent_cfb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given college football seasons. Published coverage runs 2004 through the most recent season. Pass seasons = TRUE for every published season. (Min: 2004)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a cfbfastR_data tibble.

col_nametypesdescription
pos_team_idintegerESPN team id of the team on offense. Present for every season 2004+.
pos_teamcharacter
passer_player_namecharacterDisplay name of the passer – the FIRST participant in that role on the play.
CompintegerCompleted passes recorded in the advanced box score.
AttintegerPass attempts recorded in the advanced box score.
xCompdoubleExpected completions, summed from the per-play completion model.
YdsdoublePassing yards from the advanced box score.
Pass_TDintegerPassing touchdowns.
IntintegerInterceptions thrown.
YPAdoubleYards per pass attempt.
EPAdouble
EPA_per_PlaydoubleEPA per play on the passer's plays.
WPAdouble
SRdoubleSuccess rate on the passer's plays.
SckintegerTimes the passer was sacked.
CompPctdoubleCompletion percentage from the advanced box score.
xCompPctdoubleExpected completion percentage from the per-play completion model.
CPOEdoubleCompletion percentage over expected – actual minus modelled completion rate.
qbr_epadoubleEPA variant used as an input to the QBR calculation.
sack_epadoubleEPA credited to the player's sacks taken.
pass_epadoubleEPA credited to the player's pass plays.
rush_epadoubleEPA credited to the player's rush plays.
pen_epadoubleEPA attributable to penalties on the player's plays.
spreaddouble
era0integerRule-era indicator for the earliest modelled era.
era1integerRule-era indicator for the second modelled era.
era2integerRule-era indicator for the third modelled era.
era3integerRule-era indicator for the most recent modelled era.
exp_qbrdoubleExpected QBR for the passer.
game_idinteger
seasoninteger
weekinteger

Author

Saiem Gilani

Examples

# \donttest{
  try(load_espn_cfb_adv_passing(2004))
#> ── college football advanced passing from the SportsDataverse data repo ────────
#>  Data updated: 2026-09-10 05:49:38 UTC
#> # A tibble: 1,506 × 37
#>    pos_team_id pos_team passer_player_name  Comp   Att xComp   Yds Pass_TD   Int
#>          <int> <chr>    <chr>              <int> <int> <dbl> <dbl>   <int> <int>
#>  1         259 Virgini… Bryan Randall         12    27 18.1    102       1     1
#>  2          30 USC Tro… Matt Leinart          17    27 16.6     96       3     0
#>  3         245 Texas A… Reggie McNeal         11    32 16.9    154       0     0
#>  4         254 Utah Ut… Alex Smith            20    28 17.2    218       3     0
#>  5         245 Texas A… Ty Branyon             4     6  2.91    34       0     0
#>  6         254 Utah Ut… Brian Johnson          1     2  1.24    11       0     0
#>  7        2050 Ball St… Joey Lynch            16    30 19.0    109       0     0
#>  8         103 Boston … Paul Peterson         11    22 13.0     97       1     1
#>  9          77 Northwe… Brett Basanez         35    57 30.1    323       4     1
#> 10        2628 TCU Hor… Tye Gunn              19    36 21.2    196       4     1
#> # ℹ 1,496 more rows
#> # ℹ 28 more variables: YPA <dbl>, EPA <dbl>, EPA_per_Play <dbl>, WPA <dbl>,
#> #   SR <dbl>, Sck <int>, CompPct <dbl>, xCompPct <dbl>, CPOE <dbl>,
#> #   AirYds <lgl>, aDOT <lgl>, CompAirYds <lgl>, YAC <lgl>, AirYdsPct <lgl>,
#> #   qbr_epa <dbl>, sack_epa <dbl>, pass_epa <dbl>, rush_epa <dbl>,
#> #   pen_epa <lgl>, spread <dbl>, era0 <int>, era1 <int>, era2 <int>,
#> #   era3 <int>, exp_qbr <dbl>, game_id <int>, season <int>, week <int>
# }