cfbd_pbp_data: *Get college football play by play data with cfbfastR...
In cfbfastR: Access College Football Play by Play Data
View source: R/cfbd_pbp_data.R
cfbd_pbp_data R Documentation
Get college football play by play data with cfbfastR expected points/win probability added
Description
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,
engine = NULL,
...,
defense = NULL,
offense_conference = NULL,
defense_conference = NULL,
conference = NULL,
division = NULL
)
Arguments
year
Select year, (example: 2018)
Minimum value accepted: 2001
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
engine
(Character optional): which play-by-play engine to run.
One of "v2", "legacy" or "auto"; NULL (default) resolves from
getOption("cfbfastR.pbp_engine"), which itself defaults to "v2" as of this
release. On "v2" this delegates to cfbd_pbp_data_v2(), which adds penalty
enforcement resolution, ESPN-resolved player names, the *_player_id columns
and team attribution. "legacy" reproduces the pre-2.3.0 frame unchanged.
...
Additional arguments passed to cfbd_pbp_data_v2() when the call
delegates – notably output, the "default" / "lean" / "full" modeled
column-set selector. Ignored on the legacy path.
defense
(String optional): Defensive team filter.
offense_conference
(String optional): Offensive team conference filter.
defense_conference
(String optional): Defensive team conference filter.
conference
(String optional): Conference filter (either side of the ball).
division
(String optional): Division/classification filter – fbs, fcs, ii, ii/iii, iii.
Details
# Get play by play data for 2025 regular season week 1
cfbd_pbp_data(year = 2025, week = 1, season_type = 'regular', epa_wpa = TRUE)
Value
A data frame with 368 variables:
col_name types description
season numeric Four-digit season year (e.g. 2024).
wk numeric Season week number (1-15 regular season, 1 for bowl/postseason week).
id_play character Unique CFBD play identifier (concatenates game_id and play index).
game_id integer CFBD-internal game identifier.
game_play_number numeric Sequential play number within the game (excludes timeouts/end markers).
half_play_number numeric Sequential play number within the current half.
drive_play_number numeric Sequential play number within the current drive.
pos_team character Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_team character Team name on defense at the start of the play.
pos_team_score integer Score for the team in possession at the start of the play.
def_pos_team_score integer Score for the defensive team at the start of the play.
half factor Half indicator (1 or 2).
period integer Quarter number (1-4, 5+ for overtime).
clock_minutes integer Minutes remaining on the period clock at the start of the play.
clock_seconds integer Seconds remaining on the period clock at the start of the play.
play_type character CFBD play type label (e.g. "Rush", "Pass Reception", "Field Goal Good").
play_text character Free-text description of the play from CFBD.
down numeric Down number at the start of the play (1-4).
distance numeric Yards to gain for a first down at the start of the play.
yards_to_goal numeric Yards from the offense to the opponent's end zone at the start of the play.
yards_gained numeric Yards gained (or lost) by the offense on the play.
EPA numeric Expected Points Added on the play (cfbfastR EPA model output).
ep_before numeric Expected points value before the play (cfbfastR EPA model).
ep_after numeric Expected points value after the play (cfbfastR EPA model).
wpa numeric Win Probability Added on the play (cfbfastR WP model output).
wp_before numeric Win probability for the possession team before the play (0-1).
wp_after numeric Win probability for the possession team after the play (0-1).
def_wp_before numeric Win probability for the defensive team before the play (0-1).
def_wp_after numeric Win probability for the defensive team after the play (0-1).
penalty_detail character Parsed penalty description extracted from play text.
yds_penalty numeric Yardage assessed on the penalty.
penalty_1st_conv logical TRUE when the penalty resulted in a first down conversion.
new_series numeric Binary flag for the start of a new series of downs.
firstD_by_kickoff numeric Binary flag for a new first down arising from a kickoff.
firstD_by_poss numeric Binary flag for a new first down via change of possession.
firstD_by_penalty numeric Binary flag for a new first down via penalty.
firstD_by_yards numeric Binary flag for a new first down via yards gained.
def_EPA numeric EPA for the defensive team on the play (sign-flipped offense EPA).
home_EPA numeric EPA for the home team on the play.
away_EPA numeric EPA for the away team on the play.
home_EPA_rush numeric Rushing EPA for the home team on the play.
away_EPA_rush numeric Rushing EPA for the away team on the play.
home_EPA_pass numeric Passing EPA for the home team on the play.
away_EPA_pass numeric Passing EPA for the away team on the play.
total_home_EPA numeric Cumulative total EPA for the home team through the play.
total_away_EPA numeric Cumulative total EPA for the away team through the play.
total_home_EPA_rush numeric Cumulative rushing EPA for the home team through the play.
total_away_EPA_rush numeric Cumulative rushing EPA for the away team through the play.
total_home_EPA_pass numeric Cumulative passing EPA for the home team through the play.
total_away_EPA_pass numeric Cumulative passing EPA for the away team through the play.
net_home_EPA numeric Net EPA differential (home minus away) through the play.
net_away_EPA numeric Net EPA differential (away minus home) through the play.
net_home_EPA_rush numeric Net rushing EPA differential for the home team through the play.
net_away_EPA_rush numeric Net rushing EPA differential for the away team through the play.
net_home_EPA_pass numeric Net passing EPA differential for the home team through the play.
net_away_EPA_pass numeric Net passing EPA differential for the away team through the play.
success numeric Binary success-rate flag using the 50/70/100 percent down-state thresholds.
epa_success numeric Binary flag for plays with positive EPA (EPA > 0).
rz_play numeric Binary flag for a red-zone play (yards_to_goal <= 20).
scoring_opp numeric Binary flag for a scoring opportunity (yards_to_goal <= 40).
middle_8 logical TRUE for plays in the middle-8 window (final 4 min of 1H, first 4 min of 2H).
stuffed_run numeric Binary flag for a stuffed run (zero or negative yards gained).
change_of_pos_team numeric Binary flag for change of possession-team on the play.
downs_turnover numeric Binary flag for a turnover on downs.
turnover numeric Binary flag for any turnover on the play.
pos_score_diff_start numeric Score differential for the possession team at the start of the play.
pos_score_pts numeric Points scored on the play attributed to the possession team.
log_ydstogo numeric Natural log of distance-to-go (model feature).
ExpScoreDiff numeric Expected score differential at the start of the play (EPA-adjusted).
ExpScoreDiff_Time_Ratio numeric Expected score differential scaled by share of time remaining.
half_clock_minutes numeric Minutes remaining in the half (15 + clock_minutes when in Q1/Q3).
TimeSecsRem numeric Seconds remaining in the half at the start of the play.
adj_TimeSecsRem numeric Adjusted seconds remaining used by the EPA/WP models.
Goal_To_Go logical TRUE when the offense is in a goal-to-go situation.
Under_two logical TRUE when under two minutes remain in the half.
home character Home team name.
away character Away team name.
home_wp_before numeric Home team win probability before the play (0-1).
away_wp_before numeric Away team win probability before the play (0-1).
home_wp_after numeric Home team win probability after the play (0-1).
away_wp_after numeric Away team win probability after the play (0-1).
end_of_half numeric Binary flag for the last play of a half.
pos_team_receives_2H_kickoff numeric Binary flag indicating possession team receives the second-half kickoff.
lead_pos_team character Possession team on the next play (lead value).
lead_play_type character Play type on the next play (lead value).
lag_pos_team character Possession team on the previous play (lag value).
lag_play_type character Play type on the previous play (lag value).
orig_play_type character Original CFBD play type label before cfbfastR cleaning.
Under_three logical TRUE when under three minutes remain in the half.
down_end factor Down number at the end of the play (post-play state).
distance_end numeric Distance-to-go at the end of the play (post-play state).
log_ydstogo_end numeric Natural log of post-play distance-to-go (model feature).
yards_to_goal_end numeric Yards to opponent end zone at the end of the play.
TimeSecsRem_end numeric Seconds remaining in the half at the end of the play.
Goal_To_Go_end logical TRUE when the post-play state is goal-to-go.
Under_two_end logical TRUE when the post-play state is under two minutes.
offense_score_play numeric Binary flag for an offensive scoring play.
defense_score_play numeric Binary flag for a defensive scoring play.
ppa numeric Predicted Points Added from the CFBD ppa endpoint (CFB-EPA analogue).
yard_line integer Yard line where the play started (raw CFBD yardline field).
scoring logical TRUE when the play resulted in a score (CFBD scoring flag).
pos_team_timeouts_rem_before numeric Possession team timeouts remaining before the play.
def_pos_team_timeouts_rem_before numeric Defensive team timeouts remaining before the play.
pos_team_timeouts integer Possession team timeouts remaining after the play.
def_pos_team_timeouts integer Defensive team timeouts remaining after the play.
pos_score_diff integer Score differential from the possession team's perspective.
pos_score_diff_start_end numeric Score differential aggregated from start to end of the play.
offense_play character Offensive team name as labeled by CFBD on the play.
defense_play character Defensive team name as labeled by CFBD on the play.
offense_receives_2H_kickoff numeric Binary flag indicating offense receives the second-half kickoff.
change_of_poss numeric Binary flag for change of possession on the play (CFBD offense field).
score_pts numeric Points scored on the play.
score_diff_start numeric Score differential at the start of the play.
score_diff integer Score differential (offense_score - defense_score) at the start.
offense_score integer Offense team score at the start of the play.
defense_score integer Defense team score at the start of the play.
offense_conference character Conference name of the offensive team.
defense_conference character Conference name of the defensive team.
off_timeout_called numeric Binary flag for an offensive timeout called during the play.
def_timeout_called numeric Binary flag for a defensive timeout called during the play.
offense_timeouts integer Offense timeouts remaining after the play (CFBD field).
defense_timeouts integer Defense timeouts remaining after the play (CFBD field).
off_timeouts_rem_before numeric Offense timeouts remaining before the play.
def_timeouts_rem_before numeric Defense timeouts remaining before the play.
rusher_player_name character Name of the rusher on a rushing play.
yds_rushed numeric Rushing yards gained on the play.
passer_player_name character Name of the passer on a passing play.
receiver_player_name character Name of the receiver on a passing play.
yds_receiving numeric Receiving yards gained on the play.
yds_sacked numeric Yards lost on the sack.
sack_players character Combined names of all sack participants.
sack_player_name character Primary sack player name.
sack_player_name2 character Secondary sack player name (when split between two defenders).
pass_breakup_player_name character Name of the defender credited with the pass breakup.
interception_player_name character Name of the defender credited with the interception.
yds_int_return numeric Yards gained on an interception return.
fumble_player_name character Name of the player who fumbled.
fumble_forced_player_name character Name of the player who forced the fumble.
fumble_recovered_player_name character Name of the player who recovered the fumble.
yds_fumble_return numeric Yards gained on a fumble return.
punter_player_name character Name of the punter.
yds_punted numeric Yards the ball traveled on the punt.
punt_returner_player_name character Name of the punt returner.
yds_punt_return numeric Yards gained on the punt return.
yds_punt_gained numeric Net yards gained on the punt (punt distance minus return).
punt_block_player_name character Name of the player credited with blocking the punt.
punt_block_return_player_name character Name of the player returning a blocked punt.
fg_kicker_player_name character Name of the field goal kicker.
yds_fg numeric Distance of the field goal attempt in yards.
fg_block_player_name character Name of the player credited with blocking the field goal.
fg_return_player_name character Name of the player returning the blocked/missed field goal.
kickoff_player_name character Name of the kickoff specialist.
yds_kickoff numeric Yards the ball traveled on the kickoff.
kickoff_returner_player_name character Name of the kickoff returner.
yds_kickoff_return numeric Yards gained on the kickoff return.
new_id numeric Numeric play index within the game (id_play with game_id stripped).
orig_drive_number integer Original CFBD drive number for the play.
drive_number integer cfbfastR-cleaned drive number for the play.
drive_result_detailed character Detailed drive result label (e.g. "Punt", "Passing Touchdown", "Downs Turnover").
new_drive_pts numeric Points scored on the drive (signed for offense/defense).
drive_id numeric CFBD drive identifier.
drive_result character CFBD drive result label.
drive_start_yards_to_goal numeric Yards to goal at the start of the drive.
drive_end_yards_to_goal integer Yards to goal at the end of the drive.
drive_yards integer Net yards gained on the drive.
drive_scoring numeric Binary flag for a scoring drive.
drive_pts numeric Points scored on the drive (CFBD/cfbfastR reconciled value).
drive_start_period integer Period (quarter) at the start of the drive.
drive_end_period integer Period (quarter) at the end of the drive.
drive_time_minutes_start integer Minutes on the clock at the start of the drive.
drive_time_seconds_start integer Seconds on the clock at the start of the drive.
drive_time_minutes_end integer Minutes on the clock at the end of the drive.
drive_time_seconds_end integer Seconds on the clock at the end of the drive.
drive_time_minutes_elapsed logical Minutes elapsed during the drive.
drive_time_seconds_elapsed logical Seconds elapsed during the drive.
drive_numbers numeric Binary flag marking the first play of a new drive.
number_of_drives numeric Cumulative count of drives in the game.
pts_scored numeric Points scored on the play, signed by play_type rule.
drive_result_detailed_flag character Pre-fill copy of drive_result_detailed used during drive reconciliation.
drive_result2 character Short-form drive result label (e.g. "TD", "PUNT", "DOWNS").
drive_num numeric Game-scoped drive sequence number.
lag_drive_result_detailed character Drive result detailed on the previous play (lag value).
lead_drive_result_detailed character Drive result detailed on the next play (lead value).
lag_new_drive_pts numeric Drive points on the previous play (lag value).
id_drive character Composite drive identifier (game_id concatenated with drive_num).
rush numeric Binary flag for a rushing play.
rush_td numeric Binary flag for a rushing touchdown.
pass numeric Binary flag for a passing play (includes sacks).
pass_td numeric Binary flag for a passing touchdown.
completion numeric Binary flag for a completed pass.
pass_attempt numeric Binary flag for a pass attempt.
target numeric Binary flag for a targeted receiver on the play.
sack_vec numeric Binary flag for a sack play.
sack numeric Binary flag for a sack (duplicate of sack_vec for downstream use).
int numeric Binary flag for an interception.
int_td numeric Binary flag for an interception returned for a touchdown.
turnover_vec numeric Binary flag for any play classified as a turnover.
turnover_vec_lag numeric Lag of turnover_vec (previous-play turnover flag).
turnover_indicator numeric Composite turnover indicator including failed 4th downs.
kickoff_play numeric Binary flag for a kickoff play.
receives_2H_kickoff numeric Binary flag for the team receiving the second-half kickoff.
missing_yard_flag logical TRUE when post-play yardage had to be imputed.
scoring_play numeric Binary flag for any scoring play.
td_play numeric Binary flag for a touchdown play.
touchdown numeric Binary flag for a touchdown (duplicate of td_play for downstream use).
safety numeric Binary flag for a safety.
fumble_vec numeric Binary flag for a play involving a fumble.
kickoff_tb numeric Binary flag for a kickoff touchback.
kickoff_onside numeric Binary flag for an onside kickoff attempt.
kickoff_oob numeric Binary flag for a kickoff out of bounds.
kickoff_fair_catch numeric Binary flag for a kickoff fair catch.
kickoff_downed numeric Binary flag for a kickoff downed in the field of play.
kickoff_safety numeric Binary flag for a kickoff safety.
kick_play numeric Binary flag for any kicking play (kickoff or field goal).
punt numeric Binary flag for a punt play.
punt_play numeric Binary flag for any punt-related play (includes blocks/returns).
punt_tb numeric Binary flag for a punt touchback.
punt_oob numeric Binary flag for a punt out of bounds.
punt_fair_catch numeric Binary flag for a punt fair catch.
punt_downed numeric Binary flag for a punt downed in the field of play.
punt_safety numeric Binary flag for a punt safety.
punt_blocked numeric Binary flag for a blocked punt.
penalty_safety numeric Binary flag for a safety scored on a penalty.
fg_inds numeric Binary flag for a field goal attempt.
fg_made logical TRUE when the field goal attempt was successful.
fg_make_prob numeric Predicted probability of making the field goal (cfbfastR FG model, 0-1).
No_Score_before numeric Pre-play predicted probability of no score before end of half (cfbfastR EP model, 0-1).
FG_before numeric Pre-play predicted probability of a posteam field goal next (0-1).
Opp_FG_before numeric Pre-play predicted probability of a defteam field goal next (0-1).
Opp_Safety_before numeric Pre-play predicted probability of a defteam safety next (0-1).
Opp_TD_before numeric Pre-play predicted probability of a defteam touchdown next (0-1).
Safety_before numeric Pre-play predicted probability of a posteam safety next (0-1).
TD_before numeric Pre-play predicted probability of a posteam touchdown next (0-1).
No_Score_after numeric Post-play predicted probability of no score before end of half (0-1).
FG_after numeric Post-play predicted probability of a posteam field goal next (0-1).
Opp_FG_after numeric Post-play predicted probability of a defteam field goal next (0-1).
Opp_Safety_after numeric Post-play predicted probability of a defteam safety next (0-1).
Opp_TD_after numeric Post-play predicted probability of a defteam touchdown next (0-1).
Safety_after numeric Post-play predicted probability of a posteam safety next (0-1).
TD_after numeric Post-play predicted probability of a posteam touchdown next (0-1).
penalty_flag logical TRUE when a penalty was flagged on the play.
penalty_declined logical TRUE when the penalty was declined.
penalty_no_play logical TRUE when the penalty nullified the play (no play counted).
penalty_offset logical TRUE when offsetting penalties were called.
penalty_text logical TRUE when penalty information is detectable in the play text.
penalty_play_text character Penalty-related substring extracted from the play text.
lead_wp_before2 numeric Win probability two plays ahead (lead 2 of wp_before).
wpa_half_end numeric WPA contribution from the end-of-half adjustment.
wpa_base numeric Base WPA component used to assemble the final wpa value.
wpa_base_nxt numeric WPA base component looking ahead one play.
wpa_change numeric WPA change-of-possession component for the current play.
wpa_change_nxt numeric WPA change-of-possession component for the next play.
wpa_base_ind numeric Indicator selecting the wpa_base path for the current play.
wpa_base_nxt_ind numeric Indicator selecting the wpa_base_nxt path for the next play.
wpa_change_ind numeric Indicator selecting the wpa_change path for the current play.
wpa_change_nxt_ind numeric Indicator selecting the wpa_change_nxt path for the next play.
lead_wp_before numeric Win probability on the next play (lead of wp_before).
lead_pos_team2 character Possession team two plays ahead (lead 2 of pos_team).
row integer Row index within the game grouping (sequencing helper).
drive_event_number numeric Sequential event number within the current drive.
lag_play_type2 character Play type two plays prior (lag 2 of play_type).
lag_play_type3 character Play type three plays prior (lag 3 of play_type).
lag_play_text character Play text from the previous play (lag value).
lag_play_text2 character Play text from two plays prior (lag 2 value).
lead_play_text character Play text from the next play (lead value).
lag_first_by_penalty numeric First-down-by-penalty flag from the previous play (lag value).
lag_first_by_penalty2 numeric First-down-by-penalty flag from two plays prior (lag 2 value).
lag_first_by_yards numeric First-down-by-yards flag from the previous play (lag value).
lag_first_by_yards2 numeric First-down-by-yards flag from two plays prior (lag 2 value).
first_by_penalty numeric Binary flag for a first down earned by penalty on the play.
first_by_yards numeric Binary flag for a first down earned by yards on the play.
play_after_turnover numeric Binary flag indicating the play immediately following a turnover.
lag_change_of_poss numeric change_of_poss from the previous play (lag value).
lag_change_of_pos_team numeric change_of_pos_team from the previous play (lag value).
lag_change_of_pos_team2 numeric change_of_pos_team from two plays prior (lag 2 value).
lag_kickoff_play numeric kickoff_play flag from the previous play (lag value).
lag_punt numeric punt flag from the previous play (lag value).
lag_punt2 numeric punt flag from two plays prior (lag 2 value).
lag_scoring_play numeric scoring_play flag from the previous play (lag value).
lag_turnover_vec numeric turnover_vec flag from the previous play (lag value).
lag_downs_turnover numeric downs_turnover flag from the previous play (lag value).
lag_defense_score_play numeric defense_score_play flag from the previous play (lag value).
lag_score_diff numeric score_diff from the previous play (lag value).
lag_offense_play character offense_play from the previous play (lag value).
lead_offense_play character offense_play from the next play (lead value).
lead_offense_play2 character offense_play from two plays ahead (lead 2 value).
lag_pos_score_diff numeric pos_score_diff from the previous play (lag value).
lag_off_timeouts numeric offense_timeouts from the previous play (lag value).
lag_def_timeouts numeric defense_timeouts from the previous play (lag value).
lag_TimeSecsRem2 numeric TimeSecsRem from two plays prior (lag 2 value).
lag_TimeSecsRem numeric TimeSecsRem from the previous play (lag value).
lead_TimeSecsRem numeric TimeSecsRem from the next play (lead value).
lead_TimeSecsRem2 numeric TimeSecsRem from two plays ahead (lead 2 value).
lag_yards_to_goal2 integer yards_to_goal from two plays prior (lag 2 value).
lag_yards_to_goal integer yards_to_goal from the previous play (lag value).
lead_yards_to_goal numeric yards_to_goal from the next play (lead value).
lead_yards_to_goal2 integer yards_to_goal from two plays ahead (lead 2 value).
lag_down2 integer Down number two plays prior (lag 2 value).
lag_down integer Down number from the previous play (lag value).
lead_down numeric Down number on the next play (lead value).
lead_down2 numeric Down number two plays ahead (lead 2 value).
lead_distance numeric Distance to go on the next play (lead value).
lead_distance2 integer Distance to go two plays ahead (lead 2 value).
lead_play_type2 character Play type two plays ahead (lead 2 value).
lead_play_type3 character Play type three plays ahead (lead 3 value).
lag_ep_before3 numeric ep_before from three plays prior (lag 3 value).
lag_ep_before2 numeric ep_before from two plays prior (lag 2 value).
lag_ep_before numeric ep_before from the previous play (lag value).
lead_ep_before numeric ep_before on the next play (lead value).
lead_ep_before2 numeric ep_before two plays ahead (lead 2 value).
lag_ep_after numeric ep_after from the previous play (lag value).
lag_ep_after2 numeric ep_after from two plays prior (lag 2 value).
lag_ep_after3 numeric ep_after from three plays prior (lag 3 value).
lead_ep_after numeric ep_after on the next play (lead value).
lead_ep_after2 numeric ep_after two plays ahead (lead 2 value).
play_number integer CFBD-supplied play number within the game.
wallclock character ISO 8601 wall-clock timestamp from CFBD for the play.
provider character Sportsbook provider used for spread/over_under joined onto the play.
spread numeric Pre-game point spread from the selected provider.
formatted_spread character Human-readable formatted spread string from the betting provider.
over_under numeric Pre-game over/under total from the selected provider.
drive_is_home_offense logical TRUE when the home team is on offense for the drive.
drive_start_offense_score integer Offense score at the start of the drive.
drive_start_defense_score integer Defense score at the start of the drive.
drive_end_offense_score integer Offense score at the end of the drive.
drive_end_defense_score integer Defense score at the end of the drive.
play numeric Binary flag indicating the row is a counted play (excludes end markers/timeouts/penalties).
event numeric Binary flag indicating the row is a counted game event (excludes end markers).
game_event_number numeric Sequential event number within the game.
game_row_number integer Row index within the game grouping.
half_play numeric Binary flag indicating a counted play within the half.
half_event numeric Binary flag indicating a counted event within the half.
half_event_number numeric Sequential event number within the half.
half_row_number integer Row index within the half grouping.
lag_distance3 integer distance three plays prior (lag 3 value).
lag_distance2 integer distance two plays prior (lag 2 value).
lag_distance integer distance from the previous play (lag value).
lag_yards_gained3 integer yards_gained three plays prior (lag 3 value).
lag_yards_gained2 integer yards_gained two plays prior (lag 2 value).
lag_yards_gained integer yards_gained from the previous play (lag value).
lead_yards_gained integer yards_gained on the next play (lead value).
lead_yards_gained2 integer yards_gained two plays ahead (lead 2 value).
lag_play_text3 character Play text from three plays prior (lag 3 value).
lead_play_text2 character Play text from two plays ahead (lead 2 value).
lead_play_text3 character Play text from three plays ahead (lead 3 value).
pos_unit character Possession-team unit label (offense or special teams).
def_pos_unit character Defensive possession-team unit label (defense or special teams).
lag_change_of_poss2 numeric change_of_poss from two plays prior (lag 2 value).
lag_change_of_poss3 numeric change_of_poss from three plays prior (lag 3 value).
lag_change_of_pos_team3 numeric change_of_pos_team from three plays prior (lag 3 value).
lag_kickoff_play2 numeric kickoff_play flag from two plays prior (lag 2 value).
lag_kickoff_play3 numeric kickoff_play flag from three plays prior (lag 3 value).
lag_punt3 numeric punt flag from three plays prior (lag 3 value).
lag_scoring_play2 numeric scoring_play flag from two plays prior (lag 2 value).
lag_scoring_play3 numeric scoring_play flag from three plays prior (lag 3 value).
lag_turnover_vec2 numeric turnover_vec flag from two plays prior (lag 2 value).
lag_turnover_vec3 numeric turnover_vec flag from three plays prior (lag 3 value).
lag_downs_turnover2 numeric downs_turnover flag from two plays prior (lag 2 value).
lag_downs_turnover3 numeric downs_turnover flag from three plays prior (lag 3 value).
drive_play numeric Binary flag indicating a counted play within the drive.
drive_event numeric Binary flag indicating a counted event within the drive.
lag_first_by_penalty3 numeric first_by_penalty flag from three plays prior (lag 3 value).
lag_first_by_yards3 numeric first_by_yards flag from three plays prior (lag 3 value).
See Also
Other CFBD PBP:
cfbd_live_plays(),
cfbd_pbp_data_v2(),
cfbd_play_stats_player(),
cfbd_play_stats_types(),
cfbd_play_types(),
cfbd_plays()
cfbfastR documentation built on Aug. 24, 2026, 5:13 p.m.
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
View source: R/cfbd_pbp_data.R
| cfbd_pbp_data | R Documentation |
Get college football play by play data with cfbfastR expected points/win probability added
Description
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,
engine = NULL,
...,
defense = NULL,
offense_conference = NULL,
defense_conference = NULL,
conference = NULL,
division = NULL
)
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 |
engine |
(Character optional): which play-by-play engine to run.
One of |
... |
Additional arguments passed to |
defense |
(String optional): Defensive team filter. |
offense_conference |
(String optional): Offensive team conference filter. |
defense_conference |
(String optional): Defensive team conference filter. |
conference |
(String optional): Conference filter (either side of the ball). |
division |
(String optional): Division/classification filter – |
Details
# Get play by play data for 2025 regular season week 1 cfbd_pbp_data(year = 2025, week = 1, season_type = 'regular', epa_wpa = TRUE)
Value
A data frame with 368 variables:
| col_name | types | description |
| season | numeric | Four-digit season year (e.g. 2024). |
| wk | numeric | Season week number (1-15 regular season, 1 for bowl/postseason week). |
| id_play | character | Unique CFBD play identifier (concatenates game_id and play index). |
| game_id | integer | CFBD-internal game identifier. |
| game_play_number | numeric | Sequential play number within the game (excludes timeouts/end markers). |
| half_play_number | numeric | Sequential play number within the current half. |
| drive_play_number | numeric | Sequential play number within the current drive. |
| pos_team | character | Team name in possession at the start of the play (offense, kickoff-aware). |
| def_pos_team | character | Team name on defense at the start of the play. |
| pos_team_score | integer | Score for the team in possession at the start of the play. |
| def_pos_team_score | integer | Score for the defensive team at the start of the play. |
| half | factor | Half indicator (1 or 2). |
| period | integer | Quarter number (1-4, 5+ for overtime). |
| clock_minutes | integer | Minutes remaining on the period clock at the start of the play. |
| clock_seconds | integer | Seconds remaining on the period clock at the start of the play. |
| play_type | character | CFBD play type label (e.g. "Rush", "Pass Reception", "Field Goal Good"). |
| play_text | character | Free-text description of the play from CFBD. |
| down | numeric | Down number at the start of the play (1-4). |
| distance | numeric | Yards to gain for a first down at the start of the play. |
| yards_to_goal | numeric | Yards from the offense to the opponent's end zone at the start of the play. |
| yards_gained | numeric | Yards gained (or lost) by the offense on the play. |
| EPA | numeric | Expected Points Added on the play (cfbfastR EPA model output). |
| ep_before | numeric | Expected points value before the play (cfbfastR EPA model). |
| ep_after | numeric | Expected points value after the play (cfbfastR EPA model). |
| wpa | numeric | Win Probability Added on the play (cfbfastR WP model output). |
| wp_before | numeric | Win probability for the possession team before the play (0-1). |
| wp_after | numeric | Win probability for the possession team after the play (0-1). |
| def_wp_before | numeric | Win probability for the defensive team before the play (0-1). |
| def_wp_after | numeric | Win probability for the defensive team after the play (0-1). |
| penalty_detail | character | Parsed penalty description extracted from play text. |
| yds_penalty | numeric | Yardage assessed on the penalty. |
| penalty_1st_conv | logical | TRUE when the penalty resulted in a first down conversion. |
| new_series | numeric | Binary flag for the start of a new series of downs. |
| firstD_by_kickoff | numeric | Binary flag for a new first down arising from a kickoff. |
| firstD_by_poss | numeric | Binary flag for a new first down via change of possession. |
| firstD_by_penalty | numeric | Binary flag for a new first down via penalty. |
| firstD_by_yards | numeric | Binary flag for a new first down via yards gained. |
| def_EPA | numeric | EPA for the defensive team on the play (sign-flipped offense EPA). |
| home_EPA | numeric | EPA for the home team on the play. |
| away_EPA | numeric | EPA for the away team on the play. |
| home_EPA_rush | numeric | Rushing EPA for the home team on the play. |
| away_EPA_rush | numeric | Rushing EPA for the away team on the play. |
| home_EPA_pass | numeric | Passing EPA for the home team on the play. |
| away_EPA_pass | numeric | Passing EPA for the away team on the play. |
| total_home_EPA | numeric | Cumulative total EPA for the home team through the play. |
| total_away_EPA | numeric | Cumulative total EPA for the away team through the play. |
| total_home_EPA_rush | numeric | Cumulative rushing EPA for the home team through the play. |
| total_away_EPA_rush | numeric | Cumulative rushing EPA for the away team through the play. |
| total_home_EPA_pass | numeric | Cumulative passing EPA for the home team through the play. |
| total_away_EPA_pass | numeric | Cumulative passing EPA for the away team through the play. |
| net_home_EPA | numeric | Net EPA differential (home minus away) through the play. |
| net_away_EPA | numeric | Net EPA differential (away minus home) through the play. |
| net_home_EPA_rush | numeric | Net rushing EPA differential for the home team through the play. |
| net_away_EPA_rush | numeric | Net rushing EPA differential for the away team through the play. |
| net_home_EPA_pass | numeric | Net passing EPA differential for the home team through the play. |
| net_away_EPA_pass | numeric | Net passing EPA differential for the away team through the play. |
| success | numeric | Binary success-rate flag using the 50/70/100 percent down-state thresholds. |
| epa_success | numeric | Binary flag for plays with positive EPA (EPA > 0). |
| rz_play | numeric | Binary flag for a red-zone play (yards_to_goal <= 20). |
| scoring_opp | numeric | Binary flag for a scoring opportunity (yards_to_goal <= 40). |
| middle_8 | logical | TRUE for plays in the middle-8 window (final 4 min of 1H, first 4 min of 2H). |
| stuffed_run | numeric | Binary flag for a stuffed run (zero or negative yards gained). |
| change_of_pos_team | numeric | Binary flag for change of possession-team on the play. |
| downs_turnover | numeric | Binary flag for a turnover on downs. |
| turnover | numeric | Binary flag for any turnover on the play. |
| pos_score_diff_start | numeric | Score differential for the possession team at the start of the play. |
| pos_score_pts | numeric | Points scored on the play attributed to the possession team. |
| log_ydstogo | numeric | Natural log of distance-to-go (model feature). |
| ExpScoreDiff | numeric | Expected score differential at the start of the play (EPA-adjusted). |
| ExpScoreDiff_Time_Ratio | numeric | Expected score differential scaled by share of time remaining. |
| half_clock_minutes | numeric | Minutes remaining in the half (15 + clock_minutes when in Q1/Q3). |
| TimeSecsRem | numeric | Seconds remaining in the half at the start of the play. |
| adj_TimeSecsRem | numeric | Adjusted seconds remaining used by the EPA/WP models. |
| Goal_To_Go | logical | TRUE when the offense is in a goal-to-go situation. |
| Under_two | logical | TRUE when under two minutes remain in the half. |
| home | character | Home team name. |
| away | character | Away team name. |
| home_wp_before | numeric | Home team win probability before the play (0-1). |
| away_wp_before | numeric | Away team win probability before the play (0-1). |
| home_wp_after | numeric | Home team win probability after the play (0-1). |
| away_wp_after | numeric | Away team win probability after the play (0-1). |
| end_of_half | numeric | Binary flag for the last play of a half. |
| pos_team_receives_2H_kickoff | numeric | Binary flag indicating possession team receives the second-half kickoff. |
| lead_pos_team | character | Possession team on the next play (lead value). |
| lead_play_type | character | Play type on the next play (lead value). |
| lag_pos_team | character | Possession team on the previous play (lag value). |
| lag_play_type | character | Play type on the previous play (lag value). |
| orig_play_type | character | Original CFBD play type label before cfbfastR cleaning. |
| Under_three | logical | TRUE when under three minutes remain in the half. |
| down_end | factor | Down number at the end of the play (post-play state). |
| distance_end | numeric | Distance-to-go at the end of the play (post-play state). |
| log_ydstogo_end | numeric | Natural log of post-play distance-to-go (model feature). |
| yards_to_goal_end | numeric | Yards to opponent end zone at the end of the play. |
| TimeSecsRem_end | numeric | Seconds remaining in the half at the end of the play. |
| Goal_To_Go_end | logical | TRUE when the post-play state is goal-to-go. |
| Under_two_end | logical | TRUE when the post-play state is under two minutes. |
| offense_score_play | numeric | Binary flag for an offensive scoring play. |
| defense_score_play | numeric | Binary flag for a defensive scoring play. |
| ppa | numeric | Predicted Points Added from the CFBD ppa endpoint (CFB-EPA analogue). |
| yard_line | integer | Yard line where the play started (raw CFBD yardline field). |
| scoring | logical | TRUE when the play resulted in a score (CFBD scoring flag). |
| pos_team_timeouts_rem_before | numeric | Possession team timeouts remaining before the play. |
| def_pos_team_timeouts_rem_before | numeric | Defensive team timeouts remaining before the play. |
| pos_team_timeouts | integer | Possession team timeouts remaining after the play. |
| def_pos_team_timeouts | integer | Defensive team timeouts remaining after the play. |
| pos_score_diff | integer | Score differential from the possession team's perspective. |
| pos_score_diff_start_end | numeric | Score differential aggregated from start to end of the play. |
| offense_play | character | Offensive team name as labeled by CFBD on the play. |
| defense_play | character | Defensive team name as labeled by CFBD on the play. |
| offense_receives_2H_kickoff | numeric | Binary flag indicating offense receives the second-half kickoff. |
| change_of_poss | numeric | Binary flag for change of possession on the play (CFBD offense field). |
| score_pts | numeric | Points scored on the play. |
| score_diff_start | numeric | Score differential at the start of the play. |
| score_diff | integer | Score differential (offense_score - defense_score) at the start. |
| offense_score | integer | Offense team score at the start of the play. |
| defense_score | integer | Defense team score at the start of the play. |
| offense_conference | character | Conference name of the offensive team. |
| defense_conference | character | Conference name of the defensive team. |
| off_timeout_called | numeric | Binary flag for an offensive timeout called during the play. |
| def_timeout_called | numeric | Binary flag for a defensive timeout called during the play. |
| offense_timeouts | integer | Offense timeouts remaining after the play (CFBD field). |
| defense_timeouts | integer | Defense timeouts remaining after the play (CFBD field). |
| off_timeouts_rem_before | numeric | Offense timeouts remaining before the play. |
| def_timeouts_rem_before | numeric | Defense timeouts remaining before the play. |
| rusher_player_name | character | Name of the rusher on a rushing play. |
| yds_rushed | numeric | Rushing yards gained on the play. |
| passer_player_name | character | Name of the passer on a passing play. |
| receiver_player_name | character | Name of the receiver on a passing play. |
| yds_receiving | numeric | Receiving yards gained on the play. |
| yds_sacked | numeric | Yards lost on the sack. |
| sack_players | character | Combined names of all sack participants. |
| sack_player_name | character | Primary sack player name. |
| sack_player_name2 | character | Secondary sack player name (when split between two defenders). |
| pass_breakup_player_name | character | Name of the defender credited with the pass breakup. |
| interception_player_name | character | Name of the defender credited with the interception. |
| yds_int_return | numeric | Yards gained on an interception return. |
| fumble_player_name | character | Name of the player who fumbled. |
| fumble_forced_player_name | character | Name of the player who forced the fumble. |
| fumble_recovered_player_name | character | Name of the player who recovered the fumble. |
| yds_fumble_return | numeric | Yards gained on a fumble return. |
| punter_player_name | character | Name of the punter. |
| yds_punted | numeric | Yards the ball traveled on the punt. |
| punt_returner_player_name | character | Name of the punt returner. |
| yds_punt_return | numeric | Yards gained on the punt return. |
| yds_punt_gained | numeric | Net yards gained on the punt (punt distance minus return). |
| punt_block_player_name | character | Name of the player credited with blocking the punt. |
| punt_block_return_player_name | character | Name of the player returning a blocked punt. |
| fg_kicker_player_name | character | Name of the field goal kicker. |
| yds_fg | numeric | Distance of the field goal attempt in yards. |
| fg_block_player_name | character | Name of the player credited with blocking the field goal. |
| fg_return_player_name | character | Name of the player returning the blocked/missed field goal. |
| kickoff_player_name | character | Name of the kickoff specialist. |
| yds_kickoff | numeric | Yards the ball traveled on the kickoff. |
| kickoff_returner_player_name | character | Name of the kickoff returner. |
| yds_kickoff_return | numeric | Yards gained on the kickoff return. |
| new_id | numeric | Numeric play index within the game (id_play with game_id stripped). |
| orig_drive_number | integer | Original CFBD drive number for the play. |
| drive_number | integer | cfbfastR-cleaned drive number for the play. |
| drive_result_detailed | character | Detailed drive result label (e.g. "Punt", "Passing Touchdown", "Downs Turnover"). |
| new_drive_pts | numeric | Points scored on the drive (signed for offense/defense). |
| drive_id | numeric | CFBD drive identifier. |
| drive_result | character | CFBD drive result label. |
| drive_start_yards_to_goal | numeric | Yards to goal at the start of the drive. |
| drive_end_yards_to_goal | integer | Yards to goal at the end of the drive. |
| drive_yards | integer | Net yards gained on the drive. |
| drive_scoring | numeric | Binary flag for a scoring drive. |
| drive_pts | numeric | Points scored on the drive (CFBD/cfbfastR reconciled value). |
| drive_start_period | integer | Period (quarter) at the start of the drive. |
| drive_end_period | integer | Period (quarter) at the end of the drive. |
| drive_time_minutes_start | integer | Minutes on the clock at the start of the drive. |
| drive_time_seconds_start | integer | Seconds on the clock at the start of the drive. |
| drive_time_minutes_end | integer | Minutes on the clock at the end of the drive. |
| drive_time_seconds_end | integer | Seconds on the clock at the end of the drive. |
| drive_time_minutes_elapsed | logical | Minutes elapsed during the drive. |
| drive_time_seconds_elapsed | logical | Seconds elapsed during the drive. |
| drive_numbers | numeric | Binary flag marking the first play of a new drive. |
| number_of_drives | numeric | Cumulative count of drives in the game. |
| pts_scored | numeric | Points scored on the play, signed by play_type rule. |
| drive_result_detailed_flag | character | Pre-fill copy of drive_result_detailed used during drive reconciliation. |
| drive_result2 | character | Short-form drive result label (e.g. "TD", "PUNT", "DOWNS"). |
| drive_num | numeric | Game-scoped drive sequence number. |
| lag_drive_result_detailed | character | Drive result detailed on the previous play (lag value). |
| lead_drive_result_detailed | character | Drive result detailed on the next play (lead value). |
| lag_new_drive_pts | numeric | Drive points on the previous play (lag value). |
| id_drive | character | Composite drive identifier (game_id concatenated with drive_num). |
| rush | numeric | Binary flag for a rushing play. |
| rush_td | numeric | Binary flag for a rushing touchdown. |
| pass | numeric | Binary flag for a passing play (includes sacks). |
| pass_td | numeric | Binary flag for a passing touchdown. |
| completion | numeric | Binary flag for a completed pass. |
| pass_attempt | numeric | Binary flag for a pass attempt. |
| target | numeric | Binary flag for a targeted receiver on the play. |
| sack_vec | numeric | Binary flag for a sack play. |
| sack | numeric | Binary flag for a sack (duplicate of sack_vec for downstream use). |
| int | numeric | Binary flag for an interception. |
| int_td | numeric | Binary flag for an interception returned for a touchdown. |
| turnover_vec | numeric | Binary flag for any play classified as a turnover. |
| turnover_vec_lag | numeric | Lag of turnover_vec (previous-play turnover flag). |
| turnover_indicator | numeric | Composite turnover indicator including failed 4th downs. |
| kickoff_play | numeric | Binary flag for a kickoff play. |
| receives_2H_kickoff | numeric | Binary flag for the team receiving the second-half kickoff. |
| missing_yard_flag | logical | TRUE when post-play yardage had to be imputed. |
| scoring_play | numeric | Binary flag for any scoring play. |
| td_play | numeric | Binary flag for a touchdown play. |
| touchdown | numeric | Binary flag for a touchdown (duplicate of td_play for downstream use). |
| safety | numeric | Binary flag for a safety. |
| fumble_vec | numeric | Binary flag for a play involving a fumble. |
| kickoff_tb | numeric | Binary flag for a kickoff touchback. |
| kickoff_onside | numeric | Binary flag for an onside kickoff attempt. |
| kickoff_oob | numeric | Binary flag for a kickoff out of bounds. |
| kickoff_fair_catch | numeric | Binary flag for a kickoff fair catch. |
| kickoff_downed | numeric | Binary flag for a kickoff downed in the field of play. |
| kickoff_safety | numeric | Binary flag for a kickoff safety. |
| kick_play | numeric | Binary flag for any kicking play (kickoff or field goal). |
| punt | numeric | Binary flag for a punt play. |
| punt_play | numeric | Binary flag for any punt-related play (includes blocks/returns). |
| punt_tb | numeric | Binary flag for a punt touchback. |
| punt_oob | numeric | Binary flag for a punt out of bounds. |
| punt_fair_catch | numeric | Binary flag for a punt fair catch. |
| punt_downed | numeric | Binary flag for a punt downed in the field of play. |
| punt_safety | numeric | Binary flag for a punt safety. |
| punt_blocked | numeric | Binary flag for a blocked punt. |
| penalty_safety | numeric | Binary flag for a safety scored on a penalty. |
| fg_inds | numeric | Binary flag for a field goal attempt. |
| fg_made | logical | TRUE when the field goal attempt was successful. |
| fg_make_prob | numeric | Predicted probability of making the field goal (cfbfastR FG model, 0-1). |
| No_Score_before | numeric | Pre-play predicted probability of no score before end of half (cfbfastR EP model, 0-1). |
| FG_before | numeric | Pre-play predicted probability of a posteam field goal next (0-1). |
| Opp_FG_before | numeric | Pre-play predicted probability of a defteam field goal next (0-1). |
| Opp_Safety_before | numeric | Pre-play predicted probability of a defteam safety next (0-1). |
| Opp_TD_before | numeric | Pre-play predicted probability of a defteam touchdown next (0-1). |
| Safety_before | numeric | Pre-play predicted probability of a posteam safety next (0-1). |
| TD_before | numeric | Pre-play predicted probability of a posteam touchdown next (0-1). |
| No_Score_after | numeric | Post-play predicted probability of no score before end of half (0-1). |
| FG_after | numeric | Post-play predicted probability of a posteam field goal next (0-1). |
| Opp_FG_after | numeric | Post-play predicted probability of a defteam field goal next (0-1). |
| Opp_Safety_after | numeric | Post-play predicted probability of a defteam safety next (0-1). |
| Opp_TD_after | numeric | Post-play predicted probability of a defteam touchdown next (0-1). |
| Safety_after | numeric | Post-play predicted probability of a posteam safety next (0-1). |
| TD_after | numeric | Post-play predicted probability of a posteam touchdown next (0-1). |
| penalty_flag | logical | TRUE when a penalty was flagged on the play. |
| penalty_declined | logical | TRUE when the penalty was declined. |
| penalty_no_play | logical | TRUE when the penalty nullified the play (no play counted). |
| penalty_offset | logical | TRUE when offsetting penalties were called. |
| penalty_text | logical | TRUE when penalty information is detectable in the play text. |
| penalty_play_text | character | Penalty-related substring extracted from the play text. |
| lead_wp_before2 | numeric | Win probability two plays ahead (lead 2 of wp_before). |
| wpa_half_end | numeric | WPA contribution from the end-of-half adjustment. |
| wpa_base | numeric | Base WPA component used to assemble the final wpa value. |
| wpa_base_nxt | numeric | WPA base component looking ahead one play. |
| wpa_change | numeric | WPA change-of-possession component for the current play. |
| wpa_change_nxt | numeric | WPA change-of-possession component for the next play. |
| wpa_base_ind | numeric | Indicator selecting the wpa_base path for the current play. |
| wpa_base_nxt_ind | numeric | Indicator selecting the wpa_base_nxt path for the next play. |
| wpa_change_ind | numeric | Indicator selecting the wpa_change path for the current play. |
| wpa_change_nxt_ind | numeric | Indicator selecting the wpa_change_nxt path for the next play. |
| lead_wp_before | numeric | Win probability on the next play (lead of wp_before). |
| lead_pos_team2 | character | Possession team two plays ahead (lead 2 of pos_team). |
| row | integer | Row index within the game grouping (sequencing helper). |
| drive_event_number | numeric | Sequential event number within the current drive. |
| lag_play_type2 | character | Play type two plays prior (lag 2 of play_type). |
| lag_play_type3 | character | Play type three plays prior (lag 3 of play_type). |
| lag_play_text | character | Play text from the previous play (lag value). |
| lag_play_text2 | character | Play text from two plays prior (lag 2 value). |
| lead_play_text | character | Play text from the next play (lead value). |
| lag_first_by_penalty | numeric | First-down-by-penalty flag from the previous play (lag value). |
| lag_first_by_penalty2 | numeric | First-down-by-penalty flag from two plays prior (lag 2 value). |
| lag_first_by_yards | numeric | First-down-by-yards flag from the previous play (lag value). |
| lag_first_by_yards2 | numeric | First-down-by-yards flag from two plays prior (lag 2 value). |
| first_by_penalty | numeric | Binary flag for a first down earned by penalty on the play. |
| first_by_yards | numeric | Binary flag for a first down earned by yards on the play. |
| play_after_turnover | numeric | Binary flag indicating the play immediately following a turnover. |
| lag_change_of_poss | numeric | change_of_poss from the previous play (lag value). |
| lag_change_of_pos_team | numeric | change_of_pos_team from the previous play (lag value). |
| lag_change_of_pos_team2 | numeric | change_of_pos_team from two plays prior (lag 2 value). |
| lag_kickoff_play | numeric | kickoff_play flag from the previous play (lag value). |
| lag_punt | numeric | punt flag from the previous play (lag value). |
| lag_punt2 | numeric | punt flag from two plays prior (lag 2 value). |
| lag_scoring_play | numeric | scoring_play flag from the previous play (lag value). |
| lag_turnover_vec | numeric | turnover_vec flag from the previous play (lag value). |
| lag_downs_turnover | numeric | downs_turnover flag from the previous play (lag value). |
| lag_defense_score_play | numeric | defense_score_play flag from the previous play (lag value). |
| lag_score_diff | numeric | score_diff from the previous play (lag value). |
| lag_offense_play | character | offense_play from the previous play (lag value). |
| lead_offense_play | character | offense_play from the next play (lead value). |
| lead_offense_play2 | character | offense_play from two plays ahead (lead 2 value). |
| lag_pos_score_diff | numeric | pos_score_diff from the previous play (lag value). |
| lag_off_timeouts | numeric | offense_timeouts from the previous play (lag value). |
| lag_def_timeouts | numeric | defense_timeouts from the previous play (lag value). |
| lag_TimeSecsRem2 | numeric | TimeSecsRem from two plays prior (lag 2 value). |
| lag_TimeSecsRem | numeric | TimeSecsRem from the previous play (lag value). |
| lead_TimeSecsRem | numeric | TimeSecsRem from the next play (lead value). |
| lead_TimeSecsRem2 | numeric | TimeSecsRem from two plays ahead (lead 2 value). |
| lag_yards_to_goal2 | integer | yards_to_goal from two plays prior (lag 2 value). |
| lag_yards_to_goal | integer | yards_to_goal from the previous play (lag value). |
| lead_yards_to_goal | numeric | yards_to_goal from the next play (lead value). |
| lead_yards_to_goal2 | integer | yards_to_goal from two plays ahead (lead 2 value). |
| lag_down2 | integer | Down number two plays prior (lag 2 value). |
| lag_down | integer | Down number from the previous play (lag value). |
| lead_down | numeric | Down number on the next play (lead value). |
| lead_down2 | numeric | Down number two plays ahead (lead 2 value). |
| lead_distance | numeric | Distance to go on the next play (lead value). |
| lead_distance2 | integer | Distance to go two plays ahead (lead 2 value). |
| lead_play_type2 | character | Play type two plays ahead (lead 2 value). |
| lead_play_type3 | character | Play type three plays ahead (lead 3 value). |
| lag_ep_before3 | numeric | ep_before from three plays prior (lag 3 value). |
| lag_ep_before2 | numeric | ep_before from two plays prior (lag 2 value). |
| lag_ep_before | numeric | ep_before from the previous play (lag value). |
| lead_ep_before | numeric | ep_before on the next play (lead value). |
| lead_ep_before2 | numeric | ep_before two plays ahead (lead 2 value). |
| lag_ep_after | numeric | ep_after from the previous play (lag value). |
| lag_ep_after2 | numeric | ep_after from two plays prior (lag 2 value). |
| lag_ep_after3 | numeric | ep_after from three plays prior (lag 3 value). |
| lead_ep_after | numeric | ep_after on the next play (lead value). |
| lead_ep_after2 | numeric | ep_after two plays ahead (lead 2 value). |
| play_number | integer | CFBD-supplied play number within the game. |
| wallclock | character | ISO 8601 wall-clock timestamp from CFBD for the play. |
| provider | character | Sportsbook provider used for spread/over_under joined onto the play. |
| spread | numeric | Pre-game point spread from the selected provider. |
| formatted_spread | character | Human-readable formatted spread string from the betting provider. |
| over_under | numeric | Pre-game over/under total from the selected provider. |
| drive_is_home_offense | logical | TRUE when the home team is on offense for the drive. |
| drive_start_offense_score | integer | Offense score at the start of the drive. |
| drive_start_defense_score | integer | Defense score at the start of the drive. |
| drive_end_offense_score | integer | Offense score at the end of the drive. |
| drive_end_defense_score | integer | Defense score at the end of the drive. |
| play | numeric | Binary flag indicating the row is a counted play (excludes end markers/timeouts/penalties). |
| event | numeric | Binary flag indicating the row is a counted game event (excludes end markers). |
| game_event_number | numeric | Sequential event number within the game. |
| game_row_number | integer | Row index within the game grouping. |
| half_play | numeric | Binary flag indicating a counted play within the half. |
| half_event | numeric | Binary flag indicating a counted event within the half. |
| half_event_number | numeric | Sequential event number within the half. |
| half_row_number | integer | Row index within the half grouping. |
| lag_distance3 | integer | distance three plays prior (lag 3 value). |
| lag_distance2 | integer | distance two plays prior (lag 2 value). |
| lag_distance | integer | distance from the previous play (lag value). |
| lag_yards_gained3 | integer | yards_gained three plays prior (lag 3 value). |
| lag_yards_gained2 | integer | yards_gained two plays prior (lag 2 value). |
| lag_yards_gained | integer | yards_gained from the previous play (lag value). |
| lead_yards_gained | integer | yards_gained on the next play (lead value). |
| lead_yards_gained2 | integer | yards_gained two plays ahead (lead 2 value). |
| lag_play_text3 | character | Play text from three plays prior (lag 3 value). |
| lead_play_text2 | character | Play text from two plays ahead (lead 2 value). |
| lead_play_text3 | character | Play text from three plays ahead (lead 3 value). |
| pos_unit | character | Possession-team unit label (offense or special teams). |
| def_pos_unit | character | Defensive possession-team unit label (defense or special teams). |
| lag_change_of_poss2 | numeric | change_of_poss from two plays prior (lag 2 value). |
| lag_change_of_poss3 | numeric | change_of_poss from three plays prior (lag 3 value). |
| lag_change_of_pos_team3 | numeric | change_of_pos_team from three plays prior (lag 3 value). |
| lag_kickoff_play2 | numeric | kickoff_play flag from two plays prior (lag 2 value). |
| lag_kickoff_play3 | numeric | kickoff_play flag from three plays prior (lag 3 value). |
| lag_punt3 | numeric | punt flag from three plays prior (lag 3 value). |
| lag_scoring_play2 | numeric | scoring_play flag from two plays prior (lag 2 value). |
| lag_scoring_play3 | numeric | scoring_play flag from three plays prior (lag 3 value). |
| lag_turnover_vec2 | numeric | turnover_vec flag from two plays prior (lag 2 value). |
| lag_turnover_vec3 | numeric | turnover_vec flag from three plays prior (lag 3 value). |
| lag_downs_turnover2 | numeric | downs_turnover flag from two plays prior (lag 2 value). |
| lag_downs_turnover3 | numeric | downs_turnover flag from three plays prior (lag 3 value). |
| drive_play | numeric | Binary flag indicating a counted play within the drive. |
| drive_event | numeric | Binary flag indicating a counted event within the drive. |
| lag_first_by_penalty3 | numeric | first_by_penalty flag from three plays prior (lag 3 value). |
| lag_first_by_yards3 | numeric | first_by_yards flag from three plays prior (lag 3 value). |
See Also
Other CFBD PBP:
cfbd_live_plays(),
cfbd_pbp_data_v2(),
cfbd_play_stats_player(),
cfbd_play_stats_types(),
cfbd_play_types(),
cfbd_plays()
R Package Documentation
Browse R Packages
We want your feedback!
Note that we can't provide technical support on individual packages. You should contact the package authors for that.
Embedding an R snippet on your website
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.