load_espn_cfb_adv_specialists: *Load college football advanced specialists from the...

In cfbfastR: Access College Football Play by Play Data

Load college football advanced specialists from the SportsDataverse data repo

Description

Loads season-level specialist stats – one row per kicker/punter/returner with kicking EPA, field-goal profile, and return aggregates. Published to the espn_cfb_adv_specialists release tag on the sportsdataverse-data repo.

Usage

load_espn_cfb_adv_specialists(
  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
player_name	character
field_goals	integer	Number of field-goal attempts.
field_goals_yards	integer	Sum of the field-goal attempt distances parsed out of the play text; it stays at zero when no distance could be parsed from the narrative.
punts	integer	Punts attempted.
punts_yards	integer	Total gross punt yardage parsed from the play text for this punter, working out to roughly 42 yards per punt league-wide.
kick_returns	integer
kick_returns_yards	integer	Total yards the team gained returning kickoffs.
punt_returns	integer
punt_returns_yards	integer	Total punt-return yardage credited to this returner, with fair catches, downed punts, and out-of-bounds punts scored as zero.
game_id	integer
season	integer
week	integer

Author(s)

Saiem Gilani

Examples

  try(load_espn_cfb_adv_specialists(2004))

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