Load NCAA men's football play-by-play, cfbfastR-shaped from the SportsDataverse data repo

Loads the cfbfastR-schema-shaped variant of the stats.ncaa.org men's football play-by-play – the same plays as load_ncaa_mfb_pbp() reshaped onto cfbfastR pbp column conventions for cross-source binds. Published to the ncaa_mfb_pbp_cfbfastr release tag on the sportsdataverse-data repo.

Usage

load_ncaa_mfb_pbp_cfbfastr(
  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 2013 through the most recent season. Pass seasons = TRUE for every published season. (Min: 2013)

...

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
game_id	integer
id_play	integer
drive_id	integer
game_play_number	integer
half_play_number	integer
drive_play_number	integer
drive_number	integer
season	integer
year	integer
week	integer
period	integer
half	integer
clock.minutes	integer
clock.seconds	integer
TimeSecsRem	integer
Under_two	logical
pos_team	character
def_pos_team	character
offense_play	character
defense_play	character
home	character
away	character
pos_team_score	integer
def_pos_team_score	integer
offense_score	integer
defense_score	integer
pos_score_diff	integer
score_pts	integer
scoring_play	logical
scoring	logical
down	integer
distance	integer
yard_line	character
yards_to_goal	integer
yards_to_goal_end	integer
Goal_To_Go	logical
log_ydstogo	double
yards_gained	integer
play_type	character
orig_play_type	character
play_text	character
rush	logical
rush_td	logical
pass	logical
pass_td	logical
pass_attempt	logical
completion	logical
target	logical
sack	logical
sack_vec	logical
int	logical
int_td	logical
turnover_vec	logical
downs_turnover	logical
touchdown	logical
td_play	logical
safety	logical
fumble_vec	logical
punt	logical
punt_play	logical
kickoff_play	logical
kick_play	logical
fg_inds	logical
fg_made	logical
punt_blocked	logical
punt_fair_catch	logical
firstD_by_yards	logical
firstD_by_penalty	logical
penalty_flag	logical
penalty_no_play	logical
penalty_declined	logical
penalty_offset	logical
penalty_text	character
yds_penalty	integer
rusher_player_name	character
passer_player_name	character
receiver_player_name	character
interception_player_name	character
punter_player_name	character
punt_returner_player_name	character
fg_kicker_player_name	character
kickoff_player_name	character
kickoff_returner_player_name	character
yds_rushed	integer
yds_receiving	integer
yds_sacked	integer
yds_punted	integer
yds_punt_return	integer
yds_kickoff	integer
yds_kickoff_return	integer
yds_int_return	integer
yds_fg	integer
drive_result	character
drive_scoring	logical
ot_synthesized	logical
lag_pos_team	character
lead_pos_team	character
lag_play_type	character
lead_play_type	character
lag_play_text	character
lead_play_text	character
change_of_pos_team	logical
play_after_turnover	logical
n_plays_in_game	integer
espn_game_id	character

Author

Saiem Gilani

Examples

# \donttest{
  try(load_ncaa_mfb_pbp_cfbfastr(2013))
#> ── NCAA men's football play-by-play, cfbfastR-shaped from the SportsDataverse da
#> ℹ Data updated: 2026-08-27 04:23:07 UTC
#> # A tibble: 304,146 × 105
#>    game_id  id_play drive_id game_play_number half_play_number drive_play_number
#>      <int>  <int64>    <int>            <int>            <int>             <int>
#>  1  688871     6.e9 68887101                1                1                 1
#>  2  688871     6.e9 68887101                2                2                 2
#>  3  688871     6.e9 68887101                3                3                 3
#>  4  688871     6.e9 68887101                4                4                 4
#>  5  688871     6.e9 68887102                5                5                 1
#>  6  688871     6.e9 68887102                6                6                 2
#>  7  688871     6.e9 68887102                7                7                 3
#>  8  688871     6.e9 68887102                8                8                 4
#>  9  688871     6.e9 68887102                9                9                 5
#> 10  688871     6.e9 68887102               10               10                 6
#> # ℹ 304,136 more rows
#> # ℹ 99 more variables: drive_number <int>, season <int>, year <int>,
#> #   week <int>, period <int>, half <int>, clock.minutes <int>,
#> #   clock.seconds <int>, TimeSecsRem <int>, Under_two <lgl>, pos_team <chr>,
#> #   def_pos_team <chr>, offense_play <chr>, defense_play <chr>, home <chr>,
#> #   away <chr>, pos_team_score <int>, def_pos_team_score <int>,
#> #   offense_score <int>, defense_score <int>, pos_score_diff <int>, …
# }