load_cfb_pbp: *Load cleaned play-by-play from the data repo*

View source: R/load_cfb_pbp.R

load_cfb_pbpR Documentation

Load cleaned play-by-play from the data repo

Description

helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots

This is the classic cfbfastR EPA/WPA play-by-play (FBS, 2014+). For the ESPN-derived pbp with deeper history (2004+) see load_espn_cfb_pbp(); for stats.ncaa.org pbp covering FCS and lower divisions (2013+) see load_ncaa_mfb_pbp().

Usage

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

Arguments

seasons

A vector of 4-digit years associated with given College Football seasons.

...

Additional arguments passed to an underlying function that writes the season data into a database (used by update_cfb_db())

dbConnection

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

tablename

The name of the play by play data table within the database

Value

Returns a tibble with play-by-play data

Source

CFB Play-by-Play Data releases can be found here: https://github.com/sportsdataverse/sportsdataverse-data/releases/tag/cfbfastR_cfb_pbp

See Also

Issues with this data should be filed here: https://github.com/sportsdataverse/cfbfastR-data

update_cfb_db()

Other loaders: load_cfb_rosters(), load_cfb_schedules(), load_cfb_teams(), update_cfb_db()


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