Skip to contents

Extract college football (D-I) play by play Data - for plays

Usage

cfbd_pbp_data(
  year,
  season_type = "regular",
  week = 1,
  team = NULL,
  play_type = NULL,
  epa_wpa = FALSE,
  ...
)

Arguments

year

Select year, (example: 2018)

season_type

(String default regular): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason

week

Select week, this is optional (also numeric)

team

Select team name (example: Texas, Texas A&M, Clemson)

play_type

Select play type (example: see the cfbd_play_type_df)

epa_wpa

Logical parameter (TRUE/FALSE) to return the Expected Points Added/Win Probability Added variables

...

Additional arguments passed to an underlying function.

Value

A data frame with 368 variables:

col_nametypes
seasonnumeric
wknumeric
id_playcharacter
game_idinteger
game_play_numbernumeric
half_play_numbernumeric
drive_play_numbernumeric
pos_teamcharacter
def_pos_teamcharacter
pos_team_scoreinteger
def_pos_team_scoreinteger
halffactor
periodinteger
clock_minutesinteger
clock_secondsinteger
play_typecharacter
play_textcharacter
downnumeric
distancenumeric
yards_to_goalnumeric
yards_gainednumeric
EPAnumeric
ep_beforenumeric
ep_afternumeric
wpanumeric
wp_beforenumeric
wp_afternumeric
def_wp_beforenumeric
def_wp_afternumeric
penalty_detailcharacter
yds_penaltynumeric
penalty_1st_convlogical
new_seriesnumeric
firstD_by_kickoffnumeric
firstD_by_possnumeric
firstD_by_penaltynumeric
firstD_by_yardsnumeric
def_EPAnumeric
home_EPAnumeric
away_EPAnumeric
home_EPA_rushnumeric
away_EPA_rushnumeric
home_EPA_passnumeric
away_EPA_passnumeric
total_home_EPAnumeric
total_away_EPAnumeric
total_home_EPA_rushnumeric
total_away_EPA_rushnumeric
total_home_EPA_passnumeric
total_away_EPA_passnumeric
net_home_EPAnumeric
net_away_EPAnumeric
net_home_EPA_rushnumeric
net_away_EPA_rushnumeric
net_home_EPA_passnumeric
net_away_EPA_passnumeric
successnumeric
epa_successnumeric
rz_playnumeric
scoring_oppnumeric
middle_8logical
stuffed_runnumeric
change_of_pos_teamnumeric
downs_turnovernumeric
turnovernumeric
pos_score_diff_startnumeric
pos_score_ptsnumeric
log_ydstogonumeric
ExpScoreDiffnumeric
ExpScoreDiff_Time_Rationumeric
half_clock_minutesnumeric
TimeSecsRemnumeric
adj_TimeSecsRemnumeric
Goal_To_Gological
Under_twological
homecharacter
awaycharacter
home_wp_beforenumeric
away_wp_beforenumeric
home_wp_afternumeric
away_wp_afternumeric
end_of_halfnumeric
pos_team_receives_2H_kickoffnumeric
lead_pos_teamcharacter
lead_play_typecharacter
lag_pos_teamcharacter
lag_play_typecharacter
orig_play_typecharacter
Under_threelogical
down_endfactor
distance_endnumeric
log_ydstogo_endnumeric
yards_to_goal_endnumeric
TimeSecsRem_endnumeric
Goal_To_Go_endlogical
Under_two_endlogical
offense_score_playnumeric
defense_score_playnumeric
ppanumeric
yard_lineinteger
scoringlogical
pos_team_timeouts_rem_beforenumeric
def_pos_team_timeouts_rem_beforenumeric
pos_team_timeoutsinteger
def_pos_team_timeoutsinteger
pos_score_diffinteger
pos_score_diff_start_endnumeric
offense_playcharacter
defense_playcharacter
offense_receives_2H_kickoffnumeric
change_of_possnumeric
score_ptsnumeric
score_diff_startnumeric
score_diffinteger
offense_scoreinteger
defense_scoreinteger
offense_conferencecharacter
defense_conferencecharacter
off_timeout_callednumeric
def_timeout_callednumeric
offense_timeoutsinteger
defense_timeoutsinteger
off_timeouts_rem_beforenumeric
def_timeouts_rem_beforenumeric
rusher_player_namecharacter
yds_rushednumeric
passer_player_namecharacter
receiver_player_namecharacter
yds_receivingnumeric
yds_sackednumeric
sack_playerscharacter
sack_player_namecharacter
sack_player_name2character
pass_breakup_player_namecharacter
interception_player_namecharacter
yds_int_returnnumeric
fumble_player_namecharacter
fumble_forced_player_namecharacter
fumble_recovered_player_namecharacter
yds_fumble_returnnumeric
punter_player_namecharacter
yds_puntednumeric
punt_returner_player_namecharacter
yds_punt_returnnumeric
yds_punt_gainednumeric
punt_block_player_namecharacter
punt_block_return_player_namecharacter
fg_kicker_player_namecharacter
yds_fgnumeric
fg_block_player_namecharacter
fg_return_player_namecharacter
kickoff_player_namecharacter
yds_kickoffnumeric
kickoff_returner_player_namecharacter
yds_kickoff_returnnumeric
new_idnumeric
orig_drive_numberinteger
drive_numberinteger
drive_result_detailedcharacter
new_drive_ptsnumeric
drive_idnumeric
drive_resultcharacter
drive_start_yards_to_goalnumeric
drive_end_yards_to_goalinteger
drive_yardsinteger
drive_scoringnumeric
drive_ptsnumeric
drive_start_periodinteger
drive_end_periodinteger
drive_time_minutes_startinteger
drive_time_seconds_startinteger
drive_time_minutes_endinteger
drive_time_seconds_endinteger
drive_time_minutes_elapsedlogical
drive_time_seconds_elapsedlogical
drive_numbersnumeric
number_of_drivesnumeric
pts_scorednumeric
drive_result_detailed_flagcharacter
drive_result2character
drive_numnumeric
lag_drive_result_detailedcharacter
lead_drive_result_detailedcharacter
lag_new_drive_ptsnumeric
id_drivecharacter
rushnumeric
rush_tdnumeric
passnumeric
pass_tdnumeric
completionnumeric
pass_attemptnumeric
targetnumeric
sack_vecnumeric
sacknumeric
intnumeric
int_tdnumeric
turnover_vecnumeric
turnover_vec_lagnumeric
turnover_indicatornumeric
kickoff_playnumeric
receives_2H_kickoffnumeric
missing_yard_flaglogical
scoring_playnumeric
td_playnumeric
touchdownnumeric
safetynumeric
fumble_vecnumeric
kickoff_tbnumeric
kickoff_onsidenumeric
kickoff_oobnumeric
kickoff_fair_catchnumeric
kickoff_downednumeric
kickoff_safetynumeric
kick_playnumeric
puntnumeric
punt_playnumeric
punt_tbnumeric
punt_oobnumeric
punt_fair_catchnumeric
punt_downednumeric
punt_safetynumeric
punt_blockednumeric
penalty_safetynumeric
fg_indsnumeric
fg_madelogical
fg_make_probnumeric
No_Score_beforenumeric
FG_beforenumeric
Opp_FG_beforenumeric
Opp_Safety_beforenumeric
Opp_TD_beforenumeric
Safety_beforenumeric
TD_beforenumeric
No_Score_afternumeric
FG_afternumeric
Opp_FG_afternumeric
Opp_Safety_afternumeric
Opp_TD_afternumeric
Safety_afternumeric
TD_afternumeric
penalty_flaglogical
penalty_declinedlogical
penalty_no_playlogical
penalty_offsetlogical
penalty_textlogical
penalty_play_textcharacter
lead_wp_before2numeric
wpa_half_endnumeric
wpa_basenumeric
wpa_base_nxtnumeric
wpa_changenumeric
wpa_change_nxtnumeric
wpa_base_indnumeric
wpa_base_nxt_indnumeric
wpa_change_indnumeric
wpa_change_nxt_indnumeric
lead_wp_beforenumeric
lead_pos_team2character
rowinteger
drive_event_numbernumeric
lag_play_type2character
lag_play_type3character
lag_play_textcharacter
lag_play_text2character
lead_play_textcharacter
lag_first_by_penaltynumeric
lag_first_by_penalty2numeric
lag_first_by_yardsnumeric
lag_first_by_yards2numeric
first_by_penaltynumeric
first_by_yardsnumeric
play_after_turnovernumeric
lag_change_of_possnumeric
lag_change_of_pos_teamnumeric
lag_change_of_pos_team2numeric
lag_kickoff_playnumeric
lag_puntnumeric
lag_punt2numeric
lag_scoring_playnumeric
lag_turnover_vecnumeric
lag_downs_turnovernumeric
lag_defense_score_playnumeric
lag_score_diffnumeric
lag_offense_playcharacter
lead_offense_playcharacter
lead_offense_play2character
lag_pos_score_diffnumeric
lag_off_timeoutsnumeric
lag_def_timeoutsnumeric
lag_TimeSecsRem2numeric
lag_TimeSecsRemnumeric
lead_TimeSecsRemnumeric
lead_TimeSecsRem2numeric
lag_yards_to_goal2integer
lag_yards_to_goalinteger
lead_yards_to_goalnumeric
lead_yards_to_goal2integer
lag_down2integer
lag_downinteger
lead_downnumeric
lead_down2numeric
lead_distancenumeric
lead_distance2integer
lead_play_type2character
lead_play_type3character
lag_ep_before3numeric
lag_ep_before2numeric
lag_ep_beforenumeric
lead_ep_beforenumeric
lead_ep_before2numeric
lag_ep_afternumeric
lag_ep_after2numeric
lag_ep_after3numeric
lead_ep_afternumeric
lead_ep_after2numeric
play_numberinteger
wallclockcharacter
providercharacter
spreadnumeric
formatted_spreadcharacter
over_undernumeric
drive_is_home_offenselogical
drive_start_offense_scoreinteger
drive_start_defense_scoreinteger
drive_end_offense_scoreinteger
drive_end_defense_scoreinteger
playnumeric
eventnumeric
game_event_numbernumeric
game_row_numberinteger
half_playnumeric
half_eventnumeric
half_event_numbernumeric
half_row_numberinteger
lag_distance3integer
lag_distance2integer
lag_distanceinteger
lag_yards_gained3integer
lag_yards_gained2integer
lag_yards_gainedinteger
lead_yards_gainedinteger
lead_yards_gained2integer
lag_play_text3character
lead_play_text2character
lead_play_text3character
pos_unitcharacter
def_pos_unitcharacter
lag_change_of_poss2numeric
lag_change_of_poss3numeric
lag_change_of_pos_team3numeric
lag_kickoff_play2numeric
lag_kickoff_play3numeric
lag_punt3numeric
lag_scoring_play2numeric
lag_scoring_play3numeric
lag_turnover_vec2numeric
lag_turnover_vec3numeric
lag_downs_turnover2numeric
lag_downs_turnover3numeric
drive_playnumeric
drive_eventnumeric
lag_first_by_penalty3numeric
lag_first_by_yards3numeric

Details

 # Get play by play data for 2018 regular season week 1
 cfbd_pbp_data(year = 2024, week = 1, season_type = 'regular', epa_wpa = TRUE)