load_espn_cfb_adv_passing: *Load college football advanced passing from the...

View source: R/load_espn_cfb.R

load_espn_cfb_adv_passingR Documentation

Load college football advanced passing from the SportsDataverse data repo

Description

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_name types description
pos_team_id integer ESPN team id of the team on offense. Present for every season 2004+.
pos_team character
passer_player_name character Display name of the passer -- the FIRST participant in that role on the play.
Comp integer Completed passes recorded in the advanced box score.
Att integer Pass attempts recorded in the advanced box score.
xComp double Expected completions, summed from the per-play completion model.
Yds double Passing yards from the advanced box score.
Pass_TD integer Passing touchdowns.
Int integer Interceptions thrown.
YPA double Yards per pass attempt.
EPA double
EPA_per_Play double EPA per play on the passer's plays.
WPA double
SR double Success rate on the passer's plays.
Sck integer Times the passer was sacked.
CompPct double Completion percentage from the advanced box score.
xCompPct double Expected completion percentage from the per-play completion model.
CPOE double Completion percentage over expected -- actual minus modelled completion rate.
qbr_epa double EPA variant used as an input to the QBR calculation.
sack_epa double EPA credited to the player's sacks taken.
pass_epa double EPA credited to the player's pass plays.
rush_epa double EPA credited to the player's rush plays.
pen_epa double EPA attributable to penalties on the player's plays.
spread double
era0 integer Rule-era indicator for the earliest modelled era.
era1 integer Rule-era indicator for the second modelled era.
era2 integer Rule-era indicator for the third modelled era.
era3 integer Rule-era indicator for the most recent modelled era.
exp_qbr double Expected QBR for the passer.
game_id integer
season integer
week integer

Author(s)

Saiem Gilani

Examples


  try(load_espn_cfb_adv_passing(2004))


cfbfastR documentation built on Aug. 24, 2026, 5:13 p.m.