Skip to main content
Version: 0.0.75

CFB dataset loaders

flowchart LR
raw["scrape / raw"] --> enrich["enrich"] --> rel["release asset"] --> load["load_*()"]

Automation status

DatasetRelease tagPipeline
load_cfb_pbpespn_cfb_pbp
load_cfb_ratingscfb_ratings
load_cfb_recruiting_projcfb_recruiting_proj
load_cfb_rosterscfbfastR-data
load_cfb_schedulecfbfastR-data
load_cfb_team_infocfbfastR-data
load_cfb_teams_crosswalkcfb_crosswalk
load_cfb_schedule_crosswalkcfb_crosswalk
load_cfb_team_boxespn_cfb_team_box
load_cfb_player_boxespn_cfb_player_box
load_cfb_drivesespn_cfb_drives
load_cfb_play_participantsespn_cfb_play_participants
load_cfb_game_rostersespn_cfb_game_rosters
load_cfb_linescoresespn_cfb_linescores
load_cfb_bettingespn_cfb_betting
load_cfb_fpi_weeklycfb_fpi_weekly
load_cfb_power_indexespn_cfb_power_index
load_cfb_adv_teamespn_cfb_adv_team
load_cfb_adv_passingespn_cfb_adv_passing
load_cfb_adv_rushingespn_cfb_adv_rushing
load_cfb_adv_receivingespn_cfb_adv_receiving
load_cfb_adv_defensiveespn_cfb_adv_defensive
load_cfb_adv_defensive_playersespn_cfb_adv_defensive_players
load_cfb_adv_drivesespn_cfb_adv_drives
load_cfb_adv_situationalespn_cfb_adv_situational
load_cfb_adv_specialistsespn_cfb_adv_specialists
load_cfb_adv_turnoverespn_cfb_adv_turnover
load_cfb_model_pbpespn_cfb_model_pbp
load_cfb_passingespn_cfb_passing
load_cfb_percentilesespn_cfb_percentiles
load_cfb_receivingespn_cfb_receiving
load_cfb_rushingespn_cfb_rushing
load_cfb_team_summariesespn_cfb_team_summaries
load_cfb_adv_team_gamelogespn_cfb_adv_team_gamelog
load_cfb_ratings_weeklycfb_ratings_weekly
load_cfb_team_summaries_weeklycfb_team_summaries_weekly
load_cfb_pbp_rcfbfastR_cfb_pbp

load_cfb_pbp

Release: espn_cfb_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_pbp/play_by_play_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
game_idInt64ESPN game identifier.
game_play_numberInt64Sequential play number within the game (excludes timeouts/end markers).
pos_teamInt64Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_teamInt64Team name on defense at the start of the play.
pos_team_scoreInt64Score for the team in possession at the start of the play.
def_pos_team_scoreInt64Score for the defensive team at the start of the play.
halfInt64Half indicator (1 or 2).
periodInt64Period (quarter) number.
downInt64Down of the play (1-4).
distanceInt64Yards to gain for a first down (or to the goal line in goal-to-go situations).
EPAFloat64Expected Points Added on the play (cfbfastR EPA model output).
wpaFloat64Win Probability Added on the play (cfbfastR WP model output).
wp_beforeFloat64Win probability for the possession team before the play (0-1).
wp_afterFloat64Win probability for the possession team after the play (0-1).
def_wp_beforeFloat64Win probability for the defensive team before the play (0-1).
def_wp_afterFloat64Win probability for the defensive team after the play (0-1).
penalty_detailStringParsed penalty description extracted from play text.
yds_penaltyStringYardage assessed on the penalty.
penalty_1st_convBooleanTRUE when the penalty resulted in a first down conversion.
def_EPAFloat64EPA for the defensive team on the play (sign-flipped offense EPA).
rz_playBooleanBinary flag for a red-zone play (yards_to_goal <= 20).
scoring_oppBooleanBinary flag for a scoring opportunity (yards_to_goal <= 40).
middle_8BooleanTRUE for plays in the middle-8 window (final 4 min of 1H, first 4 min of 2H).
stuffed_runBooleanBinary flag for a stuffed run (zero or negative yards gained).
change_of_pos_teamBooleanBinary flag for change of possession-team on the play.
downs_turnoverBooleanBinary flag for a turnover on downs.
pos_score_diff_startInt64Score differential for the possession team at the start of the play.
pos_score_ptsInt64Points scored on the play attributed to the possession team.
home_wp_beforeFloat64Home team win probability before the play (0-1).
away_wp_beforeFloat64Away team win probability before the play (0-1).
home_wp_afterFloat64Home team win probability after the play (0-1).
away_wp_afterFloat64Away team win probability after the play (0-1).
end_of_halfBooleanBinary flag for the last play of a half.
lead_pos_teamInt64Value of pos_team on the next play, used for sequence-aware derivations.
lead_play_typeStringValue of play_type on the next play, used for sequence-aware derivations.
lag_pos_teamInt64Value of pos_team on the previous play, used for sequence-aware derivations.
orig_play_typeStringOriginal CFBD play type label before cfbfastR cleaning.
offense_score_playBooleanBinary flag for an offensive scoring play.
defense_score_playBooleanBinary flag for a defensive scoring play.
pos_score_diffInt64Score differential from the possession team's perspective.
change_of_possBooleanBinary flag for change of possession on the play (CFBD offense field).
rusher_player_nameStringName of the rusher on a rushing play.
yds_rushedInt64Rushing yards gained on the play.
passer_player_nameStringName of the passer on a passing play.
receiver_player_nameStringName of the receiver on a passing play.
yds_receivingInt64Receiving yards gained on the play.
yds_sackedInt64Yards lost on the sack.
sack_playersStringCombined names of all sack participants.
sack_player_nameStringPrimary sack player name.
sack_player_name2StringSecondary sack player name (when split between two defenders).
pass_breakup_player_nameStringName of the defender credited with the pass breakup.
interception_player_nameStringName of the defender credited with the interception.
yds_int_returnInt64Yards gained on an interception return.
fumble_player_nameStringName of the player who fumbled.
fumble_forced_player_nameStringName of the player who forced the fumble.
fumble_recovered_player_nameStringName of the player who recovered the fumble.
yds_fumble_returnInt64Yards gained on a fumble return.
punter_player_nameStringName of the punter.
yds_puntedInt64Yards the ball traveled on the punt.
yds_punt_returnInt64Yards gained on the punt return.
yds_punt_gainedInt64Net yards gained on the punt (punt distance minus return).
punt_block_player_nameStringName of the player credited with blocking the punt.
punt_block_return_player_nameStringName of the player returning a blocked punt.
fg_kicker_player_nameStringName of the field goal kicker.
yds_fgInt64Distance of the field goal attempt in yards.
fg_block_player_nameStringName of the player credited with blocking the field goal.
fg_return_player_nameStringName of the player returning the blocked/missed field goal.
kickoff_player_nameStringName of the kickoff specialist.
yds_kickoffInt64Yards the ball traveled on the kickoff.
yds_kickoff_returnInt64Yards gained on the kickoff return.
rushBooleanBinary flag for a rushing play.
rush_tdBooleanBinary flag for a rushing touchdown.
passBooleanBinary flag for a passing play (includes sacks).
pass_tdBooleanBinary flag for a passing touchdown.
completionBooleanBinary flag for a completed pass.
pass_attemptBooleanBinary flag for a pass attempt.
targetBooleanBinary flag for a targeted receiver on the play.
sack_vecBooleanBinary flag for a sack play.
sackBooleanBinary flag for a sack (duplicate of sack_vec for downstream use).
intBooleanBinary flag for an interception.
int_tdBooleanBinary flag for an interception returned for a touchdown.
turnover_vecBooleanBinary flag for any play classified as a turnover.
kickoff_playBooleanBinary flag for a kickoff play.
scoring_playBooleanTRUE if the play resulted in a score.
td_playBooleanBinary flag for a touchdown play.
touchdownBooleanBinary flag for a touchdown (duplicate of td_play for downstream use).
safetyBooleanBinary flag for a safety.
fumble_vecBooleanBinary flag for a play involving a fumble.
kickoff_tbBooleanBinary flag for a kickoff touchback.
kickoff_onsideBooleanBinary flag for an onside kickoff attempt.
kickoff_oobBooleanBinary flag for a kickoff out of bounds.
kickoff_fair_catchBooleanBinary flag for a kickoff fair catch.
kickoff_downedBooleanBinary flag for a kickoff downed in the field of play.
kickoff_safetyBooleanBinary flag for a kickoff safety.
kick_playBooleanBinary flag for any kicking play (kickoff or field goal).
puntBooleanBinary flag for a punt play.
punt_playBooleanBinary flag for any punt-related play (includes blocks/returns).
punt_tbBooleanBinary flag for a punt touchback.
punt_oobBooleanBinary flag for a punt out of bounds.
punt_fair_catchBooleanBinary flag for a punt fair catch.
punt_downedBooleanBinary flag for a punt downed in the field of play.
punt_safetyBooleanBinary flag for a punt safety.
punt_blockedBooleanBinary flag for a blocked punt.
penalty_safetyBooleanBinary flag for a safety scored on a penalty.
fg_madeBooleanTRUE when the field goal attempt was successful.
fg_make_probFloat64Predicted probability of making the field goal (cfbfastR FG model, 0-1).
penalty_flagBooleanTRUE when a penalty was flagged on the play.
penalty_declinedBooleanTRUE when the penalty was declined.
penalty_no_playBooleanTRUE when the penalty nullified the play (no play counted).
penalty_offsetBooleanTRUE when offsetting penalties were called.
penalty_textStringTRUE when penalty information is detectable in the play text.
lead_wp_before2Float64Value of wp_before 2 plays ahead, used for sequence-aware derivations.
lead_wp_beforeFloat64Value of wp_before on the next play, used for sequence-aware derivations.
lead_pos_team2Int64Value of pos_team 2 plays ahead, used for sequence-aware derivations.
lag_change_of_pos_teamBooleanValue of change_of_pos_team on the previous play, used for sequence-aware derivations.
lag_pos_score_diffInt64Value of pos_score_diff on the previous play, used for sequence-aware derivations.
idInt64247Sports referencing id for the recruit.
sequenceNumberInt64Broadcast sequence order number.
textStringFull play description.
awayScoreInt64Away team score after the goal.
homeScoreInt64Home team score after the goal.
scoringPlayBooleanESPN flag marking the play as a scoring play.
priorityBooleanTRUE if ESPN flags the play as a priority highlight.
modifiedStringISO timestamp the play record was last modified.
wallclockStringReal-world ISO timestamp of the play.
teamParticipantsString
isPenaltyBoolean
statYardageInt64Yardage ESPN credits to the play for statistical purposes.
isTurnoverBoolean
type.idStringESPN's numeric identifier for the play type.
type.textStringESPN's text label for the play type.
type.abbreviationStringESPN's abbreviation for the play type.
period.numberInt64Period (quarter) number in which the play occurred.
clock.displayValueStringGame clock at the play, as the displayed mm:ss string.
start.downInt64ESPN's down value for the play state at the start of the play.
start.distanceInt64ESPN's distance value for the play state at the start of the play.
start.yardLineInt64ESPN's yardLine value for the play state at the start of the play.
start.yardsToEndzoneInt64ESPN's yardsToEndzone value for the play state at the start of the play.
start.team.idInt64ESPN's team.id value for the play state at the start of the play.
end.downInt64ESPN's down value for the play state at the end of the play.
end.distanceInt64ESPN's distance value for the play state at the end of the play.
end.yardLineInt64ESPN's yardLine value for the play state at the end of the play.
end.yardsToEndzoneInt64ESPN's yardsToEndzone value for the play state at the end of the play.
end.downDistanceTextStringESPN's downDistanceText value for the play state at the end of the play.
end.shortDownDistanceTextStringESPN's shortDownDistanceText value for the play state at the end of the play.
end.possessionTextStringESPN's possessionText value for the play state at the end of the play.
end.team.idInt64ESPN's team.id value for the play state at the end of the play.
start.downDistanceTextStringESPN's downDistanceText value for the play state at the start of the play.
start.shortDownDistanceTextStringESPN's shortDownDistanceText value for the play state at the start of the play.
start.possessionTextStringESPN's possessionText value for the play state at the start of the play.
scoringType.nameStringESPN's name for the scoring type (e.g. touchdown, field goal).
scoringType.displayNameStringESPN's display label for the scoring type.
scoringType.abbreviationStringESPN's abbreviation for the scoring type.
pointAfterAttempt.idFloat64
pointAfterAttempt.textString
pointAfterAttempt.abbreviationString
pointAfterAttempt.valueFloat64
drive.idStringESPN's id field for the drive containing this play.
drive.displayResultStringESPN's displayResult field for the drive containing this play.
drive.isScoreBooleanESPN's isScore field for the drive containing this play.
drive.team.shortDisplayNameStringESPN's team.shortDisplayName field for the drive containing this play.
drive.team.displayNameStringESPN's team.displayName field for the drive containing this play.
drive.team.nameStringESPN's team.name field for the drive containing this play.
drive.team.abbreviationStringESPN's team.abbreviation field for the drive containing this play.
drive.yardsInt64ESPN's yards field for the drive containing this play.
drive.offensivePlaysInt64ESPN's offensivePlays field for the drive containing this play.
drive.resultStringESPN's result field for the drive containing this play.
drive.descriptionStringESPN's description field for the drive containing this play.
drive.shortDisplayResultStringESPN's shortDisplayResult field for the drive containing this play.
drive.timeElapsed.displayValueStringESPN's timeElapsed.displayValue field for the drive containing this play.
drive.start.period.numberInt64ESPN's start.period.number field for the drive containing this play.
drive.start.period.typeStringESPN's start.period.type field for the drive containing this play.
drive.start.yardLineInt64ESPN's start.yardLine field for the drive containing this play.
drive.start.clock.displayValueStringESPN's start.clock.displayValue field for the drive containing this play.
drive.start.textStringESPN's start.text field for the drive containing this play.
drive.end.period.numberInt64ESPN's end.period.number field for the drive containing this play.
drive.end.period.typeStringESPN's end.period.type field for the drive containing this play.
drive.end.yardLineInt64ESPN's end.yardLine field for the drive containing this play.
drive.end.clock.displayValueStringESPN's end.clock.displayValue field for the drive containing this play.
seasonTypeInt64ESPN season type for the game (2 = regular season, 3 = postseason).
weekInt64Game week of the season.
status_type_completedBooleanWhether the game is complete.
homeTeamIdInt64ESPN's home-team Id for the game, stamped on every play.
awayTeamIdInt64ESPN's away-team Id for the game, stamped on every play.
homeTeamNameStringESPN's home-team Name for the game, stamped on every play.
awayTeamNameStringESPN's away-team Name for the game, stamped on every play.
homeTeamMascotStringESPN's home-team Mascot for the game, stamped on every play.
awayTeamMascotStringESPN's away-team Mascot for the game, stamped on every play.
homeTeamAbbrevStringESPN's home-team Abbrev for the game, stamped on every play.
awayTeamAbbrevStringESPN's away-team Abbrev for the game, stamped on every play.
homeTeamNameAltStringESPN's home-team NameAlt for the game, stamped on every play.
awayTeamNameAltStringESPN's away-team NameAlt for the game, stamped on every play.
gameSpreadFloat64Point spread used as an input to the win-probability model.
homeFavoriteBooleanTrue when the home team was favoured by the spread.
gameSpreadAvailableBooleanTrue when a spread was available for the game.
overUnderFloat64Over/under total used as a model input.
homeTeamSpreadFloat64ESPN's home-team Spread for the game, stamped on every play.
clock.minutesInt64Minutes remaining on the game clock at the play.
clock.secondsInt64Seconds component of the game clock at the play.
lag_halfInt64Value of half on the previous play, used for sequence-aware derivations.
lead_halfInt64Value of half on the next play, used for sequence-aware derivations.
start.TimeSecsRemInt64ESPN's TimeSecsRem value for the play state at the start of the play.
start.adj_TimeSecsRemInt64ESPN's adj_TimeSecsRem value for the play state at the start of the play.
lead_textStringValue of text on the next play, used for sequence-aware derivations.
lead_start_teamStringValue of start_team on the next play, used for sequence-aware derivations.
lead_start_yardsToEndzoneInt64Value of start_yardsToEndzone on the next play, used for sequence-aware derivations.
lead_start_downInt64Value of start_down on the next play, used for sequence-aware derivations.
lead_start_distanceInt64Value of start_distance on the next play, used for sequence-aware derivations.
lead_scoringPlayBooleanValue of scoringPlay on the next play, used for sequence-aware derivations.
text_dupeBooleanTrue when the play description duplicates the previous row's text.
end_state_missingBoolean
start.pos_team.idInt64ESPN's pos_team.id value for the play state at the start of the play.
start.def_pos_team.idInt64ESPN's def_pos_team.id value for the play state at the start of the play.
end.def_pos_team.idInt64ESPN's def_pos_team.id value for the play state at the end of the play.
end.pos_team.idInt64ESPN's pos_team.id value for the play state at the end of the play.
start.pos_team.nameStringESPN's pos_team.name value for the play state at the start of the play.
start.def_pos_team.nameStringESPN's def_pos_team.name value for the play state at the start of the play.
end.pos_team.nameStringESPN's pos_team.name value for the play state at the end of the play.
end.def_pos_team.nameStringESPN's def_pos_team.name value for the play state at the end of the play.
start.is_homeBooleanESPN's is_home value for the play state at the start of the play.
end.is_homeBooleanESPN's is_home value for the play state at the end of the play.
homeTimeoutCalledBooleanTrue when the home team called a timeout on the play.
awayTimeoutCalledBooleanTrue when the away team called a timeout on the play.
end.homeTeamTimeoutsInt64ESPN's homeTeamTimeouts value for the play state at the end of the play.
end.awayTeamTimeoutsInt64ESPN's awayTeamTimeouts value for the play state at the end of the play.
start.homeTeamTimeoutsInt64ESPN's homeTeamTimeouts value for the play state at the start of the play.
start.awayTeamTimeoutsInt64ESPN's awayTeamTimeouts value for the play state at the start of the play.
end.TimeSecsRemInt64ESPN's TimeSecsRem value for the play state at the end of the play.
end.adj_TimeSecsRemInt64ESPN's adj_TimeSecsRem value for the play state at the end of the play.
start.posTeamTimeoutsInt64ESPN's posTeamTimeouts value for the play state at the start of the play.
start.defPosTeamTimeoutsInt64ESPN's defPosTeamTimeouts value for the play state at the start of the play.
end.posTeamTimeoutsInt64ESPN's posTeamTimeouts value for the play state at the end of the play.
end.defPosTeamTimeoutsInt64ESPN's defPosTeamTimeouts value for the play state at the end of the play.
firstHalfKickoffTeamIdInt64ESPN id of the team that received the opening kickoff.
start.yardInt64ESPN's yard value for the play state at the start of the play.
end.yardInt64ESPN's yard value for the play state at the end of the play.
lag_scoringPlayBooleanValue of scoringPlay on the previous play, used for sequence-aware derivations.
down_1BooleanTrue when it is 1st down at the start of the play.
down_2BooleanTrue when it is 2nd down at the start of the play.
down_3BooleanTrue when it is 3rd down at the start of the play.
down_4BooleanTrue when it is 4th down at the start of the play.
down_1_endBooleanTrue when it is 1st down at the end of the play.
down_2_endBooleanTrue when it is 2nd down at the end of the play.
down_3_endBooleanTrue when it is 3rd down at the end of the play.
down_4_endBooleanTrue when it is 4th down at the end of the play.
td_checkBooleanInternal flag used while reconciling whether the play produced a touchdown.
forced_fumbleBooleanTrue when the defense forced a fumble on the play.
is_homeBooleanWhether the subject team was the home team.
lag_HA_score_diffInt64Value of HA_score_diff on the previous play, used for sequence-aware derivations.
HA_score_diffInt64Home score minus away score for the play.
net_HA_score_ptsInt64Net points the play added to the home-minus-away score margin.
H_score_diffInt64Home team's score minus the away team's, from the home perspective.
A_score_diffInt64Away team's score minus the home team's, from the away perspective.
lag_homeScoreInt64Value of homeScore on the previous play, used for sequence-aware derivations.
lag_awayScoreInt64Value of awayScore on the previous play, used for sequence-aware derivations.
start.homeScoreInt64ESPN's homeScore value for the play state at the start of the play.
start.awayScoreInt64ESPN's awayScore value for the play state at the start of the play.
end.homeScoreInt64ESPN's homeScore value for the play state at the end of the play.
end.awayScoreInt64ESPN's awayScore value for the play state at the end of the play.
start.pos_team_scoreInt64ESPN's pos_team_score value for the play state at the start of the play.
start.def_pos_team_scoreInt64ESPN's def_pos_team_score value for the play state at the start of the play.
start.pos_score_diffInt64ESPN's pos_score_diff value for the play state at the start of the play.
end.pos_team_scoreInt64ESPN's pos_team_score value for the play state at the end of the play.
end.def_pos_team_scoreInt64ESPN's def_pos_team_score value for the play state at the end of the play.
end.pos_score_diffInt64ESPN's pos_score_diff value for the play state at the end of the play.
start.pos_team_receives_2H_kickoffBooleanESPN's pos_team_receives_2H_kickoff value for the play state at the start of the play.
end.pos_team_receives_2H_kickoffBooleanESPN's pos_team_receives_2H_kickoff value for the play state at the end of the play.
penalty_in_textBooleanTrue when the play description mentions a penalty.
pass_breakupBooleanTrue when a defender broke up the pass.
pass_depthString
pass_directionString
rush_directionString
qb_hurryBoolean
fg_attemptBooleanTrue when the play was a field-goal attempt.
pos_unitStringPossession-team unit label (offense or special teams).
def_pos_unitStringDefensive possession-team unit label (defense or special teams).
spBooleanBinary indicator for whether or not a score occurred on the play.
playBooleanBinary flag indicating the row is a counted play (excludes end markers/timeouts/penalties).
cleaned_textString
kneel_downBoolean
scrimmage_playBooleanTrue when the play is a play from scrimmage rather than a special-teams or administrative row.
pos_score_diff_endInt64Score differential from the possessing team's perspective at the end of the play.
fumble_lostBooleanBinary indicator for if the fumble was lost.
fumble_recoveredBooleanTrue when a fumble on the play was recovered.
field_goal_resultStringString indicator for result of field goal attempt: made, missed, or blocked.
extra_point_resultStringString indicator for the result of the extra point attempt: good, failed, blocked, safety (touchback in defensive endzone is 1 point apparently), or aborted.
two_point_conv_resultStringString indicator for result of two point conversion attempt: success, failure, safety (touchback in defensive endzone is 1 point apparently), or return.
air_yardsToEndzoneInt64
air_yardsInt64Numeric value for distance in yards perpendicular to the line of scrimmage at where the targeted receiver either caught or didn't catch the ball.
yards_after_catchInt64Numeric value for distance in yards perpendicular to the yard line where the receiver made the reception to where the play ended.
kicking_teamInt64
return_teamInt64String abbreviation of the return team. Returns may occur on any of: interception, fumble, kickoff, punt, or blocked kicks.
fumble_or_muffBoolean
recovery_teamInt64
recovery_team_2Int64
fumbling_teamInt64
int_turnoverBoolean
pos_fumble_lostBoolean
def_fumble_lostBoolean
is_pos_team_turnoverBoolean
is_def_pos_team_turnoverBoolean
is_turnoverBooleanTRUE if the play was a turnover.
turnover_teamInt64
is_st_turnoverBoolean
is_blocked_punt_turnoverBoolean
is_blocked_fg_turnoverBoolean
sack_teamInt64
interception_teamInt64
pass_breakup_teamInt64
forced_fumble_teamInt64
fumble_recovery_teamInt64
punt_return_teamInt64
kick_return_teamInt64
fg_teamInt64
punt_teamInt64
penalized_teamInt64
penalty_yards_signedInt64
new_downInt64Down after the play, including any penalty enforcement.
new_distanceInt64Distance to go after the play, including any penalty enforcement.
under_2Boolean
goal_to_goBooleanBinary indicator for whether or not the posteam is in a goal down situation.
stopped_runBooleanTrue when the rush was stopped at or behind the line of scrimmage.
opportunity_runBooleanTrue when a rush reached 4 yards -- the carries on which the blocking did its job. Matches cfbfastR's espn_cfb_15 definition. Assets published before the 2026-08 fix carry the inverted (4 yards or fewer) flag.
highlight_runBooleanTrue when the rush gained 8 or more yards.
adj_rush_yardageInt64Rushing yards capped at 8, the input to the line-yards decomposition.
line_yardsFloat64Yards credited to the offensive line on a rush, using the standard sliding scale: 1.2x the capped yardage on a loss, all of it through 3 yards, half of each yard from 4 to 8, and a 5.5-yard ceiling beyond that.
second_level_yardsFloat64Rushing yards earned from 4 to 8, split evenly between line and carrier under the line-yards decomposition.
open_field_yardsInt64Rushing yards gained beyond 8, credited to the ball carrier rather than the line.
highlight_yardsFloat64Second-level plus open-field yards -- the yardage credited to the carrier.
opp_highlight_yardsFloat64Highlight yards earned on opportunity runs, isolating carrier production on carries where the blocking succeeded. Assets published before the 2026-08 fix are identically 0 here, because the inverted opportunity_run gate could never co-occur with non-zero highlight yards.
short_rush_successBooleanTrue when a short-yardage rush gained the yardage needed.
short_rush_attemptBooleanTrue when the play is a rush in a short-yardage situation.
power_rush_successBooleanTrue when a power rushing attempt gained the yardage needed.
power_rush_attemptBooleanTrue when the play is a short-yardage power rushing attempt.
early_downBooleanTrue when the play is a scrimmage play on first or second down.
late_downBooleanTrue when the play is a scrimmage play on third or fourth down.
early_down_passBooleanTrue when the play is a pass on an early down.
early_down_rushBooleanTrue when the play is a rush on an early down.
late_down_passBooleanTrue when the play is a pass on a late down.
late_down_rushBooleanTrue when the play is a rush on a late down.
standard_downBooleanTrue when the offense is on schedule for the series -- first down, second down needing fewer than 8, or third/fourth down needing fewer than 5.
passing_downBooleanTrue when the offense is behind schedule for the series -- second down needing 8 or more, or third/fourth down needing 5 or more.
TFLBooleanTrue when the play was a tackle for loss.
TFL_passBooleanTrue when the play was a tackle for loss on a pass play (a sack).
TFL_rushBooleanTrue when the play was a tackle for loss on a rush play.
havocBooleanTrue when the defense disrupted the play: a pass breakup, tackle for loss, interception or forced fumble.
start.pos_team_spreadFloat64ESPN's pos_team_spread value for the play state at the start of the play.
start.elapsed_shareFloat64ESPN's elapsed_share value for the play state at the start of the play.
start.spread_timeFloat64ESPN's spread_time value for the play state at the start of the play.
end.pos_team_spreadFloat64ESPN's pos_team_spread value for the play state at the end of the play.
end.elapsed_shareFloat64ESPN's elapsed_share value for the play state at the end of the play.
end.spread_timeFloat64ESPN's spread_time value for the play state at the end of the play.
penalty_assessed_on_kickoffBoolean
start.yardsToEndzone.touchbackInt64ESPN's yardsToEndzone.touchback value for the play state at the start of the play.
EP_start_touchbackFloat64Expected points the offense would have had from a touchback on this play.
EP_startFloat64Expected points for the offense at the start of the play.
EP_endFloat64Expected points for the offense at the end of the play.
lag_EP_endFloat64Value of EP_end on the previous play, used for sequence-aware derivations.
EP_betweenFloat64Change in expected points across the play, before penalty adjustment.
EPA_scrimmageFloat64EPA credited to the play on plays from scrimmage.
EPA_rushFloat64EPA credited to the play on rush plays.
EPA_passFloat64EPA credited to the play on pass plays.
EPA_explosiveBooleanTrue when the play was explosive.
EPA_non_explosiveFloat64EPA credited to the play on non-explosive plays.
EPA_explosive_passBooleanTrue when the pass play was explosive.
EPA_explosive_rushBooleanTrue when the rush play was explosive.
first_down_createdBooleanTrue when the play produced a first down for the offense.
EPA_successBooleanTrue when the play was successful by EPA.
EPA_success_early_downBooleanTrue when the play on an early down was successful by EPA.
EPA_success_early_down_passBooleanTrue when the pass play on an early down was successful by EPA.
EPA_success_early_down_rushBooleanTrue when the rush play on an early down was successful by EPA.
EPA_success_late_downBooleanTrue when the play on a late down was successful by EPA.
EPA_success_late_down_passBooleanTrue when the pass play on a late down was successful by EPA.
EPA_success_late_down_rushBooleanTrue when the rush play on a late down was successful by EPA.
EPA_success_standard_downBooleanTrue when the play on a standard down was successful by EPA.
EPA_success_passing_downBooleanTrue when the play on a passing down was successful by EPA.
EPA_success_passBooleanTrue when the pass play was successful by EPA.
EPA_success_rushBooleanTrue when the rush play was successful by EPA.
EPA_success_EPAFloat64EPA on successful plays.
EPA_success_standard_down_EPAFloat64EPA on successful plays on a standard down.
EPA_success_passing_down_EPAFloat64EPA on successful plays on a passing down.
EPA_success_pass_EPAFloat64EPA on successful pass plays.
EPA_success_rush_EPAFloat64EPA on successful rush plays.
EPA_middle_8_successBooleanTrue when the play in the middle eight was successful by EPA.
EPA_middle_8_success_passBooleanTrue when the pass play in the middle eight was successful by EPA.
EPA_middle_8_success_rushBooleanTrue when the rush play in the middle eight was successful by EPA.
EPA_penaltyFloat64EPA credited to the play attributable to penalties.
EPA_spFloat64EPA credited to the play on special-teams plays.
EPA_fgFloat64EPA credited to the play on field-goal attempts.
EPA_puntFloat64EPA credited to the play on punt plays.
EPA_kickoffFloat64EPA credited to the play on kickoff plays.
start.ExpScoreDiff_touchbackFloat64ESPN's ExpScoreDiff_touchback value for the play state at the start of the play.
start.ExpScoreDiffFloat64ESPN's ExpScoreDiff value for the play state at the start of the play.
start.ExpScoreDiff_Time_Ratio_touchbackFloat64ESPN's ExpScoreDiff_Time_Ratio_touchback value for the play state at the start of the play.
start.ExpScoreDiff_Time_RatioFloat64ESPN's ExpScoreDiff_Time_Ratio value for the play state at the start of the play.
end.ExpScoreDiffFloat64ESPN's ExpScoreDiff value for the play state at the end of the play.
end.ExpScoreDiff_Time_RatioFloat64ESPN's ExpScoreDiff_Time_Ratio value for the play state at the end of the play.
wp_touchbackFloat64Win probability the offense would have had starting from a touchback.
wp_before_naiveFloat64
wp_touchback_naiveFloat64
wp_after_naiveFloat64
def_wp_before_naiveFloat64
home_wp_before_naiveFloat64
away_wp_before_naiveFloat64
lead_wp_before_naiveFloat64
lead_wp_before2_naiveFloat64
def_wp_after_naiveFloat64
home_wp_after_naiveFloat64
away_wp_after_naiveFloat64
wpa_naiveFloat64
cpFloat64Numeric value indicating the probability for a complete pass based on comparable game situations.
cpoeFloat64For a single pass play this is 1 - cp when the pass was completed or 0 - cp when the pass was incomplete. Analyzed for a whole game or season an indicator for the passer how much over or under expectation his completion percentage was.
eraInt64one of pre2018 (2006-2017) or post2018 (2018+)
xpassFloat64Probability of dropback scaled from 0 to 1.
pass_oeFloat64Dropback percent over expected on a given play scaled from 0 to 100.
drive_startFloat64Yard line at which the drive began.
drive_stoppedBooleanTrue when the play ended the drive.
drive_play_indexInt64Sequence number of the play within its drive.
drive_offense_playsInt64Offensive plays run on the drive.
prog_drive_EPAFloat64Cumulative EPA accrued by the drive up to and including this play.
prog_drive_WPAFloat64Cumulative win-probability added by the drive up to and including this play.
drive_offense_yardsInt64Offensive yards gained on the drive.
drive_total_yardsInt64Total yards gained on the drive.
qbr_epaFloat64EPA variant used as an input to the QBR calculation.
weightFloat64Listed weight (lbs).
non_fumble_sackBooleanTrue when the play was a sack that did not produce a fumble.
sack_epaFloat64EPA credited to the play when it is a sack.
pass_epaFloat64EPA credited to the play when it is a pass.
rush_epaFloat64EPA credited to the play when it is a rush.
pen_epaFloat64EPA attributable to a penalty on the play.
sack_weightFloat64Weighting applied to the sack component of the play.
pass_weightFloat64Weighting applied to the pass component of the play.
rush_weightFloat64Weighting applied to the rush component of the play.
pen_weightFloat64Weighting applied to the penalty component of the play.
action_playBooleanTrue when the play advanced the game state -- excludes timeouts, end-of-period markers and other non-action rows.
athlete_nameStringPlayer full name.
rusher_player_idInt64Unique identifier for the player that attempted the run.
passer_player_idInt64Unique identifier for the player that attempted the pass.
receiver_player_idInt64Unique identifier for the receiver that was targeted on the pass.
fumble_player_idInt64CFBD athlete_id of the player who fumbled.
sack_player_idInt64Comma-separated CFBD athlete_id(s) of the sacking defender(s).
sack_player_id2Int64
interception_player_idInt64CFBD athlete_id of the defender credited with an interception.
pass_breakup_player_idInt64CFBD athlete_id of the defender credited with the pass breakup (PBU).
fumble_forced_player_idInt64CFBD athlete_id of the defender credited with forcing the fumble.
fumble_recovered_player_idInt64CFBD athlete_id of the player recovering the fumble.
fg_kicker_player_idInt64
punter_player_idInt64Unique identifier for the punter.
kickoff_player_idInt64
kickoff_return_player_idInt64
punt_return_player_idInt64
fg_block_player_idInt64
punt_block_player_idInt64
fg_return_player_idInt64
punt_block_return_player_idNull
go_wpFloat64
first_down_probFloat64
wp_succeedFloat64
wp_failFloat64
make_fg_wpFloat64
miss_fg_wpFloat64
fg_wpFloat64
punt_wpFloat64
go_boostFloat64
go_wp_diffFloat64
fg_wp_diffFloat64
punt_wp_diffFloat64
fourth_down_recommendationString
two_pt_wpFloat64
xp_wpFloat64
prob_2ptFloat64
two_pt_recommendationString
two_pt_wp_diffFloat64
load_cfb_pbp(seasons=2024)

load_cfb_ratings

Release: cfb_ratings · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_ratings/cfb_ratings_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
team_idInt64ESPN team id.
adj_off_epaFloat64Opponent-adjusted offensive EPA per play: the team's raw per-game EPA on pass and rush plays net of each opponent's ridge-fitted defensive strength, averaged over its games.
adj_def_epaFloat64Opponent-adjusted EPA per play allowed, netted the same way as the offensive rating, so lower is better because it measures EPA surrendered.
adj_st_epaFloat64Special-teams composite in EPA units: per-play mean EPA on field goals, punts, and kick returns, each centered on that unit's league mean and summed across the three units.
adj_netFloat64adj_off_epa minus adj_def_epa, the team's overall efficiency rating in EPA per play; special teams is deliberately excluded.
fei_offFloat64Drive-level offensive rating from a ridge fit on per-drive EPA, the Fremeau-style drive-efficiency counterpart to adj_off_epa.
fei_defFloat64Drive-level defensive rating from the same per-drive ridge fit, on the same scale as fei_off.
fei_netFloat64fei_off minus fei_def, the team's overall drive-efficiency rating, with the ridge's dropped reference team pinned at zero.
gamesInt64Number of games included in the ATS summary.
off_paceFloat64Tempo measure: scrimmage plays (pass plus rush) per game, centering near 65 and used as the pace input to the totals model.
off_rankInt64Dense rank of adj_off_epa in descending order, so rank 1 is the season's most efficient offense.
def_rankInt64Dense rank of adj_def_epa in ascending order, so rank 1 is the season's stingiest defense.
net_rankInt64Dense rank of adj_net in descending order, so rank 1 is the season's strongest overall team.
net_zFloat64adj_net restated as a z-score against the mean and standard deviation of adj_net across the rated teams that season.
load_cfb_ratings(seasons=2024)

load_cfb_recruiting_proj

Release: cfb_recruiting_proj · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_recruiting_proj/cfb_recruiting_proj_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
team_idInt64ESPN team id.
pred_winsFloat64Ridge projection of the team's season win total, fit strictly on prior seasons from talent composite, blue-chip ratio, offensive and defensive returning production, and prior wins.
pred_marginFloat64Ridge projection of the team's average per-game scoring margin, from the same preseason-known feature set as pred_wins.
pred_net_epaFloat64Reserved slot for a projected adjusted net EPA; it ships all-null because the adjusted-EPA training target is not currently loadable.
load_cfb_recruiting_proj(seasons=2024)

load_cfb_rosters

Release: cfbfastR-data · asset https://raw.githubusercontent.com/sportsdataverse/cfbfastR-data/main/rosters/parquet/cfb_rosters_{season}.parquet

Returns

col_nametypedescription
athlete_idStringESPN athlete id.
first_nameStringAthlete first name.
last_nameStringAthlete last name.
teamStringTeam name.
weightInt32Listed weight (lbs).
heightInt32Listed height (inches).
jerseyInt32Jersey number.
yearInt32Four-digit season year (e.g. 2019).
positionStringAthlete position.
home_cityStringHometown of the athlete.
home_stateStringHometown state of the athlete.
home_countryStringHometown country of the athlete.
home_latitudeFloat64Hometown latitude.
home_longitudeFloat64Hometown longitude.
home_county_fipsStringHometown FIPS code.
recruit_idsList(Int32)List of recruiting-database profile ids matched to the player; real ids run in the six-figure range and a lone 0 entry means no recruiting profile was matched.
headshot_urlStringPlayer ESPN headshot url.
seasonFloat64Season (4-digit year).
load_cfb_rosters(seasons=2024)

load_cfb_schedule

Release: cfbfastR-data · asset https://raw.githubusercontent.com/sportsdataverse/cfbfastR-data/main/schedules/parquet/cfb_schedules_{season}.parquet

Returns

col_nametypedescription
game_idInt32ESPN game identifier.
seasonInt32Season (4-digit year).
weekInt32Game week of the season.
season_typeStringESPN season type (2 = regular, 3 = postseason).
start_dateStringSeason start timestamp (ISO 8601, UTC).
start_time_tbdBooleanTRUE/FALSE flag for if the game's start time is to be determined.
completedBooleanTRUE if the game is complete.
neutral_siteBooleanTRUE/FALSE flag for if the game took place at a neutral site.
conference_gameBooleanTRUE/FALSE flag for this game qualifying as a conference game.
attendanceBooleanReported attendance at the game.
venue_idInt32Referencing venue id.
venueStringVenue name.
home_idInt32Home team referencing id.
home_teamStringHome team name.
home_divisionStringHome team division.
home_conferenceStringHome team conference.
home_pointsInt32Home team total points scored in the game so far.
home_post_win_probFloat64Home team post-game win probability.
home_pregame_eloInt32Home team pre-game ELO rating.
home_postgame_eloInt32Home team post-game ELO rating.
away_idInt32Away team referencing id.
away_teamStringAway team name.
away_divisionStringAway team division.
away_conferenceStringAway team conference.
away_pointsInt32Away team total points scored in the game so far.
away_post_win_probFloat64Away team post-game win probability.
away_pregame_eloInt32Away team pre-game ELO rating.
away_postgame_eloInt32Away team post-game ELO rating.
excitement_indexFloat64Game excitement index.
highlightsStringGame highlight urls.
notesStringGame notes.
load_cfb_schedule(seasons=2024)

load_cfb_team_info

Release: cfbfastR-data · asset https://raw.githubusercontent.com/sportsdataverse/cfbfastR-data/main/team_info/parquet/cfb_team_info_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
schoolStringTeam name.
mascotStringTeam mascot.
abbreviationStringMetric abbreviation.
alt_name1StringTeam alternate name 1 (as it appears in play_text).
alt_name2StringTeam alternate name 2 (as it appears in play_text).
alt_name3StringTeam alternate name 3 (as it appears in play_text).
conferenceStringConference of the team.
divisionStringDivision in the conference for the team.
classificationStringConference classification (fbs, fcs, ii, iii).
colorStringPrimary team color (hex, no #).
alt_colorStringTeam color (alternate).
logoStringTeam or league logo URL.
logo_2StringURL of the team's alternate dark-background 500-pixel logo on ESPN's CDN, null for programs with no dark variant.
twitterStringThe football program's Twitter/X handle including the leading at sign, populated for only a minority of listed teams.
venue_idInt32Referencing venue id.
venue_nameStringFull name of the franchise's venue.
cityStringVenue city.
stateStringVenue state.
zipStringTeam/venue zip code.
country_codeStringTeam/venue country code.
timezoneStringTime zone in which the venue resides (i.e. Eastern Time -> "America/New_York").
latitudeFloat64Venue latitude in decimal degrees.
longitudeFloat64Venue longitude in decimal degrees.
elevationStringVenue elevation above sea level.
capacityInt32Stadium capacity.
year_constructedInt32Year in which the venue was constructed.
grassBooleanTRUE/FALSE response on whether the field is grass or not.
domeBooleanTRUE/FALSE response to whether the venue has a dome or not.
load_cfb_team_info(seasons=2024)

load_cfb_teams_crosswalk

Release: cfb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_crosswalk/cfb_teams_crosswalk_{season}.parquet

Returns

col_nametypedescription
norm_keyStringShared join key across providers: the team name lowercased, ASCII-folded, stripped of punctuation, whitespace-collapsed, and alias-mapped.
espn_team_idInt64ESPN team id for the crosswalk row.
espn_teamStringESPN's full team display name, school plus mascot, null when the row was anchored on a non-ESPN provider.
espn_abbreviationStringESPN abbreviation.
fox_team_idStringFox Sports team id for the same team.
fox_teamStringFox Sports' team name, which that feed ships in all capitals.
fox_abbreviationStringFox Sports' short team code, which frequently differs from the ESPN abbreviation for the same school.
yahoo_team_idStringYahoo Sports team id for the same team.
yahoo_teamStringYahoo Sports' team display name, school plus mascot.
yahoo_abbreviationStringYahoo Sports' short team code for the school.
matched_sourcesStringPlus-joined provenance tag naming which of espn, fox, and yahoo contributed a directory row for this team.
load_cfb_teams_crosswalk(seasons=2024)

load_cfb_schedule_crosswalk

Release: cfb_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_crosswalk/cfb_schedule_crosswalk_{season}.parquet

Returns

col_nametypedescription
matchup_keyStringOrder-independent key for the game: the two normalized team names sorted alphabetically and joined with a pipe.
espn_game_idInt64ESPN game id for the crosswalk row.
fox_game_idStringFox Sports game id for the same game.
yahoo_game_idStringYahoo Sports game id for the same game.
yahoo_global_game_idStringYahoo's cross-season global game key in ncaaf.g. form, distinct from the date-encoded yahoo_game_id.
home_teamStringHome team name.
away_teamStringAway team name.
espn_dateStringKickoff date as YYYY-MM-DD taken from ESPN's schedule, null on games that matched no ESPN row.
fox_dateStringKickoff date as YYYY-MM-DD taken from the Fox Sports schedule, null on games that matched no Fox row.
yahoo_dateStringKickoff date as YYYY-MM-DD, parsed from Yahoo's RFC-2822 start_time string.
matched_sourcesStringPlus-joined provenance tag naming which of espn, fox, and yahoo actually supplied a row for this game.
load_cfb_schedule_crosswalk(seasons=2024)

load_cfb_team_box

Release: espn_cfb_team_box · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_team_box/team_box_{season}.parquet

Returns

col_nametypedescription
firstDownsStringTotal first downs ESPN credits the team, carried verbatim from the box score as a string.
thirdDownEffStringThird-down efficiency as ESPN's conversions-attempts string, for example 5-15.
fourthDownEffStringFourth-down efficiency as a conversions-attempts string, for example 3-4.
totalYardsStringTotal offensive yards for the team, matching rushingYards plus netPassingYards in about 99.8 percent of games.
netPassingYardsStringPassing yards after yardage lost to sacks is deducted, the numerator behind yardsPerPass.
completionAttemptsStringCompletions and pass attempts as a slash-separated string, for example 23/41.
yardsPerPassStringNet passing yards per pass attempt, netPassingYards divided by the attempt count in completionAttempts and rounded to one decimal.
rushingYardsStringNet rushing yards gained.
rushingAttemptsStringRushing attempts.
yardsPerRushAttemptStringYards gained per rushing attempt.
totalPenaltiesYardsStringPenalties and penalty yards as a hyphen-separated string, for example 7-64.
turnoversStringTurnovers total.
fumblesLostStringNumber of fumbles the team lost to the opponent, carried as a string.
interceptionsStringPassing interceptions.
possessionTimeStringTime of possession as mm:ss; the two teams' values add up to 60 minutes in a regulation game.
team_idInt64ESPN team id.
team_abbreviationStringTeam abbreviation; team_detail = TRUE only.
team_nameStringTeam nickname; team_detail = TRUE only.
home_awayStringhome or away.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
load_cfb_team_box(seasons=2024)

load_cfb_player_box

Release: espn_cfb_player_box · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_player_box/player_box_{season}.parquet

Returns

col_nametypedescription
stat_1StringFirst value of ESPN's raw athlete stats array, written only when the category's key list does not line up with the stats list; on those rows the named per-category columns are all null.
stat_2StringSecond value of ESPN's raw athlete stats array, written only on rows where the category keys did not line up and the named columns could not be filled.
stat_3StringThird value of ESPN's raw athlete stats array, written only on rows where the category keys did not line up and the named columns could not be filled.
stat_4StringFourth value of ESPN's raw athlete stats array, written only on rows where the category keys did not line up and the named columns could not be filled.
stat_5StringFifth value of ESPN's raw athlete stats array, written only on rows where the category keys did not line up and the named columns could not be filled.
categoryStringCFBD stats category name (e.g. passing, rushing, defensive).
athlete_idInt64ESPN athlete id.
athlete_nameStringPlayer full name.
jerseyStringJersey number.
team_idInt64ESPN team id.
rushingAttemptsStringRushing attempts.
rushingYardsStringNet rushing yards gained.
yardsPerRushAttemptStringYards gained per rushing attempt.
rushingTouchdownsStringRushing touchdowns.
longRushingStringLongest rush of the game, in yards.
receptionsStringThe number of pass receptions. Lateral receptions officially don't count as reception.
receivingYardsStringReceiving yards gained.
yardsPerReceptionStringYards gained per reception.
receivingTouchdownsStringReceiving touchdowns.
longReceptionStringLongest reception of the game, in yards.
fumblesString
fumblesLostString
fumblesRecoveredString
kickReturnsString
kickReturnYardsString
yardsPerKickReturnString
longKickReturnString
kickReturnTouchdownsString
puntReturnsStringPunt returns attempted.
puntReturnYardsStringYards gained on punt returns.
yardsPerPuntReturnStringYards gained per punt return.
longPuntReturnStringLongest punt return of the game, in yards.
puntReturnTouchdownsStringTouchdowns scored on punt returns.
fieldGoalsMade/fieldGoalAttemptsStringField goals made and attempted, as ESPN's combined string.
fieldGoalPctStringField-goal percentage.
longFieldGoalMadeStringLongest field goal made, in yards.
extraPointsMade/extraPointAttemptsStringExtra points made and attempted, as ESPN's combined string.
totalKickingPointsStringTotal points scored by kicking.
puntsStringPunts attempted.
puntYardsStringTotal punt yards.
grossAvgPuntYardsStringGross average yards per punt, before return yardage.
touchbacksStringPunts or kickoffs that resulted in a touchback.
puntsInside20StringPunts downed inside the opponent 20-yard line.
longPuntStringLongest punt of the game, in yards.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
interceptionsStringPassing interceptions.
interceptionYardsStringYards returned on interceptions.
interceptionTouchdownsStringTouchdowns scored on interception returns.
totalTacklesString
soloTacklesString
sacksStringTeam sacks.
tacklesForLossString
passesDefendedString
hurriesString
defensiveTouchdownsString
completions/passingAttemptsStringCompletions and pass attempts, as ESPN's combined string.
passingYardsStringNet passing yards gained.
yardsPerPassAttemptStringYards gained per pass attempt.
passingTouchdownsStringPassing touchdowns.
adjQBRStringAdjusted Total QBR for the quarterback.
load_cfb_player_box(seasons=2024)

load_cfb_drives

Release: espn_cfb_drives · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_drives/drives_{season}.parquet

Returns

col_nametypedescription
drive_idStringCFBD drive identifier the play belongs to.
team_idInt64ESPN team id.
resultStringDrive result code (e.g. PUNT, TD).
display_resultStringDrive-result label (e.g. Punt, Touchdown).
short_display_resultStringShort drive-result label.
descriptionStringESPN's description of the stat.
yardsInt64Total yards gained on the drive.
offensive_playsInt64Number of offensive plays on the drive.
is_scoreBooleanTRUE if the drive resulted in a score.
start_periodInt64Period (quarter) in which the drive starts.
start_yard_lineInt64Yard line at the start of the play.
start_clockStringGame clock display value at the start of the drive.
start_textStringField-position text at the start of the drive.
end_periodInt64Period (quarter) in which the drive ends.
end_yard_lineInt64Yard line at the end of the play.
end_clockStringGame clock display value at the end of the drive.
time_elapsedStringElapsed game time for the drive (MM:SS).
n_playsInt64Number of entries in ESPN's raw plays array for the drive, which is generally at least offensive_plays because it also counts penalties and other non-offensive snaps.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
load_cfb_drives(seasons=2024)

load_cfb_play_participants

Release: espn_cfb_play_participants · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_play_participants/play_participants_{season}.parquet

Returns

col_nametypedescription
game_idInt64ESPN game identifier.
play_idInt64ESPN play id.
kicker_player_nameStringDisplay name of the kicker -- the FIRST participant in that role on the play.
tackler_player_nameStringDisplay name of a defender credited with the tackle -- the FIRST participant in that role on the play.
returner_player_nameStringDisplay name of the player returning the kick or punt -- the FIRST participant in that role on the play.
rusher_player_nameStringDisplay name of the ball carrier on a rush -- the FIRST participant in that role on the play.
passer_player_nameStringDisplay name of the passer -- the FIRST participant in that role on the play.
receiver_player_nameStringDisplay name of the targeted receiver -- the FIRST participant in that role on the play.
punter_player_nameStringDisplay name of the punter -- the FIRST participant in that role on the play.
assisted_by_player_nameStringDisplay name of a defender credited with an assisted tackle -- the FIRST participant in that role on the play.
penalized_player_nameStringDisplay name of the penalized player -- the FIRST participant in that role on the play.
scorer_player_nameStringDisplay name of the player credited with the score -- the FIRST participant in that role on the play.
pat_scorer_player_nameStringDisplay name of the player credited with the point-after score -- the FIRST participant in that role on the play.
sacked_by_player_nameStringDisplay name of a defender credited with the sack -- the FIRST participant in that role on the play.
kicker_player_idStringESPN athlete id of the kicker -- the FIRST participant in that role on the play.
tackler_player_idStringESPN athlete id of a defender credited with the tackle -- the FIRST participant in that role on the play.
returner_player_idStringESPN athlete id of the player returning the kick or punt -- the FIRST participant in that role on the play.
rusher_player_idStringESPN athlete id of the ball carrier on a rush -- the FIRST participant in that role on the play.
passer_player_idStringESPN athlete id of the passer -- the FIRST participant in that role on the play.
receiver_player_idStringESPN athlete id of the targeted receiver -- the FIRST participant in that role on the play.
punter_player_idStringESPN athlete id of the punter -- the FIRST participant in that role on the play.
assisted_by_player_idStringESPN athlete id of a defender credited with an assisted tackle -- the FIRST participant in that role on the play.
penalized_player_idStringESPN athlete id of the penalized player -- the FIRST participant in that role on the play.
scorer_player_idStringESPN athlete id of the player credited with the score -- the FIRST participant in that role on the play.
pat_scorer_player_idStringESPN athlete id of the player credited with the point-after score -- the FIRST participant in that role on the play.
sacked_by_player_idStringESPN athlete id of a defender credited with the sack -- the FIRST participant in that role on the play.
kicker_player_namesStringList of the display names of EVERY participant credited as the kicker on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
tackler_player_namesStringList of the display names of EVERY participant credited as a defender credited with the tackle on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
returner_player_namesStringList of the display names of EVERY participant credited as the player returning the kick or punt on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
rusher_player_namesStringList of the display names of EVERY participant credited as the ball carrier on a rush on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
passer_player_namesStringList of the display names of EVERY participant credited as the passer on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
receiver_player_namesStringList of the display names of EVERY participant credited as the targeted receiver on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
punter_player_namesStringList of the display names of EVERY participant credited as the punter on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
assisted_by_player_namesStringList of the display names of EVERY participant credited as a defender credited with an assisted tackle on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
penalized_player_namesStringList of the display names of EVERY participant credited as the penalized player on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
scorer_player_namesStringList of the display names of EVERY participant credited as the player credited with the score on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
pat_scorer_player_namesStringList of the display names of EVERY participant credited as the player credited with the point-after score on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
sacked_by_player_namesStringList of the display names of EVERY participant credited as a defender credited with the sack on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
kicker_player_idsStringList of the athlete ids of EVERY participant credited as the kicker on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
tackler_player_idsStringList of the athlete ids of EVERY participant credited as a defender credited with the tackle on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
returner_player_idsStringList of the athlete ids of EVERY participant credited as the player returning the kick or punt on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
rusher_player_idsStringList of the athlete ids of EVERY participant credited as the ball carrier on a rush on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
passer_player_idsStringList of the athlete ids of EVERY participant credited as the passer on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
receiver_player_idsStringList of the athlete ids of EVERY participant credited as the targeted receiver on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
punter_player_idsStringList of the athlete ids of EVERY participant credited as the punter on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
assisted_by_player_idsStringList of the athlete ids of EVERY participant credited as a defender credited with an assisted tackle on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
penalized_player_idsStringList of the athlete ids of EVERY participant credited as the penalized player on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
scorer_player_idsStringList of the athlete ids of EVERY participant credited as the player credited with the score on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
pat_scorer_player_idsStringList of the athlete ids of EVERY participant credited as the player credited with the point-after score on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
sacked_by_player_idsStringList of the athlete ids of EVERY participant credited as a defender credited with the sack on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
pass_defender_player_nameStringDisplay name of the defender credited with defending the pass -- the FIRST participant in that role on the play.
pass_defender_player_idStringESPN athlete id of the defender credited with defending the pass -- the FIRST participant in that role on the play.
pass_defender_player_namesStringList of the display names of EVERY participant credited as the defender credited with defending the pass on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
pass_defender_player_idsStringList of the athlete ids of EVERY participant credited as the defender credited with defending the pass on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
recoverer_player_nameStringDisplay name of the player who recovered the fumble -- the FIRST participant in that role on the play.
fumbler_player_nameString
recoverer_player_idStringESPN athlete id of the player who recovered the fumble -- the FIRST participant in that role on the play.
fumbler_player_idString
recoverer_player_namesStringList of the display names of EVERY participant credited as the player who recovered the fumble on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
fumbler_player_namesString
recoverer_player_idsStringList of the athlete ids of EVERY participant credited as the player who recovered the fumble on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
fumbler_player_idsString
forced_by_player_nameStringDisplay name of the defender who forced the fumble -- the FIRST participant in that role on the play.
forced_by_player_idStringESPN athlete id of the defender who forced the fumble -- the FIRST participant in that role on the play.
forced_by_player_namesStringList of the display names of EVERY participant credited as the defender who forced the fumble on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
forced_by_player_idsStringList of the athlete ids of EVERY participant credited as the defender who forced the fumble on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
pat_passer_player_nameStringDisplay name of the passer on the point-after attempt -- the FIRST participant in that role on the play.
pat_passer_player_idStringESPN athlete id of the passer on the point-after attempt -- the FIRST participant in that role on the play.
pat_passer_player_namesStringList of the display names of EVERY participant credited as the passer on the point-after attempt on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
pat_passer_player_idsStringList of the athlete ids of EVERY participant credited as the passer on the point-after attempt on the play, so multi-entry roles such as split sacks or gang tackles are not collapsed to one.
load_cfb_play_participants(seasons=2024)

load_cfb_game_rosters

Release: espn_cfb_game_rosters · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_game_rosters/game_rosters_{season}.parquet

Returns

col_nametypedescription
athlete_idInt64ESPN athlete id.
athlete_uidStringESPN athlete UID (universal identifier).
athlete_guidStringESPN athlete GUID.
athlete_typeStringAthlete type / class.
first_nameStringAthlete first name.
last_nameStringAthlete last name.
full_nameStringVenue full name (e.g. Tenney Stadium).
athlete_display_nameStringPlayer display name; athlete_detail = TRUE only.
short_nameStringRanking source short name (e.g. AP Poll).
weightFloat64Listed weight (lbs).
display_weightStringHuman-readable weight (e.g. 205 lbs).
heightFloat64Listed height (inches).
display_heightStringHuman-readable height (e.g. 6' 1").
slugStringURL slug for the team.
jerseyStringJersey number.
linkedBooleanTRUE if the record is linked to a related entity.
activeBooleanTRUE if the player was active for the game.
alternate_ids_sdrStringAlternate ids sdr.
birth_place_cityStringBirth place city.
birth_place_stateStringBirth place state.
birth_place_countryStringBirth place country.
birth_country_alternate_idStringESPN's internal alternate identifier for the athlete's birth country, paired with birth_place_country and the flag fields.
birth_country_abbreviationStringBirth country abbreviation.
headshot_hrefStringURL of the athlete headshot image.
headshot_altStringAlternative-text label for the headshot.
hand_typeStringHand type.
hand_abbreviationStringHand abbreviation.
hand_display_valueStringHand display value.
flag_hrefStringURL of the birth-country flag image hosted on ESPN's CDN under teamlogos/countries.
flag_altStringAlt text ESPN attaches to the birth-country flag image, which is the country's name spelled out.
flag_relStringStringified relationship list ESPN ships with the flag image; the only non-null value observed is a single country-flag entry.
experience_yearsFloat64Years of experience.
experience_display_valueStringExperience display value.
experience_abbreviationStringExperience abbreviation.
status_idStringESPN commitment status id.
status_nameStringStatus-type key (e.g. STATUS_FINAL).
status_typeStringStatus type.
status_abbreviationStringStatus abbreviation.
middle_nameStringMiddle name of the player.
starterBooleanTRUE if the athlete started the game.
jersey_rightString
validBooleanTRUE if the roster entry is flagged valid by ESPN.
did_not_playBooleanTRUE if the athlete did not play.
display_nameStringHuman-readable metric name.
athlete_hrefStringESPN Core v2 API reference URL for the athlete's season record, ending in the athlete id.
position_hrefStringESPN Core v2 API reference URL for the position resource ESPN lists the athlete at.
statistics_hrefStringESPN Core v2 API reference URL for this athlete's stat line in this game, null for the roughly 71 percent of listed players who recorded no stats.
team_idInt64ESPN team id.
orderInt64Team order within the competition (0 = first).
home_awayStringhome or away.
winnerBooleanTRUE if this team won the game.
team_guidStringESPN team GUID.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringTeam slug for the stat row.
team_locationStringTeam location / school name; team_detail = TRUE only.
team_nameStringTeam nickname; team_detail = TRUE only.
team_nicknameStringTeam nickname label; team_detail = TRUE only.
team_abbreviationStringTeam abbreviation; team_detail = TRUE only.
team_display_nameStringFull team display name; team_detail = TRUE only.
team_short_display_nameStringShort team display name; team_detail = TRUE only.
team_colorStringPrimary team color; team_detail = TRUE only.
team_alternate_colorStringAlternate team color; team_detail = TRUE only.
is_activeBooleanWhether the team is currently active.
is_all_starBooleanWhether the team is an all-star team.
team_alternate_ids_sdrStringThe team's Sportradar alternate identifier, which maps one-to-one with team_id.
logo_hrefStringURL of the default team logo.
logo_dark_hrefStringURL of the dark-variant team logo.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
ageFloat64Age as of last pipeline build, rounded to one decimal. Pipeline is built on a weekly basis.
date_of_birthStringPlayer date of birth (if published).
citizenshipStringCitizenship.
draft_display_textStringDraft display text.
draft_roundFloat64Round that player was drafted in
draft_yearFloat64Year that player was drafted
draft_selectionFloat64Draft selection.
draft_team_hrefStringAPI link to the team that drafted the player. Sparse: absent entirely from the 2023 and 2024 assets and populated on only a small share of 2025 rows.
load_cfb_game_rosters(seasons=2024)

load_cfb_linescores

Release: espn_cfb_linescores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_linescores/linescores_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
periodInt64Period (quarter) number.
valueStringMetric value.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
load_cfb_linescores(seasons=2024)

load_cfb_betting

Release: espn_cfb_betting · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_betting/betting_{season}.parquet

Returns

col_nametypedescription
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
game_spreadFloat64Game spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns
over_underFloat64Pre-game over/under total from the selected provider.
home_favoriteBooleanTRUE if the home team is the favorite.
home_team_spreadFloat64The game spread with respect to the home team
game_spread_availableBooleanLogical (TRUE/FALSE) indicating whether the spread was available from ESPN. Basically, I would just not recommend using any of the spread information, I think I defaulted a lot of them to -2.5 for the home team. Most games probably do not have spread information. This column should really be listed first
odds_sourceStringProvenance of the spread and over/under used for the game: summary_pickcenter when ESPN's own pickcenter carried them, core_odds_api when they came from the live odds endpoint, default when neither resolved, injected when supplied by an offline rebuild.
load_cfb_betting(seasons=2024)

load_cfb_fpi_weekly

Release: cfb_fpi_weekly · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_fpi_weekly/cfb_fpi_weekly_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
season_typeInt64ESPN season type (2 = regular, 3 = postseason).
weekInt64Game week of the season.
team_idInt64ESPN team id.
last_updatedStringTimestamp ESPN last refreshed the power index.
run_date_time_keyInt64ESPN's run key for the snapshot, as an integer timestamp (e.g. 20241021040000). This is the AS-OF date the snapshot represents, which is not the same as last_updated (when ESPN computed it); the gap between the two is what snapshot_is_contemporaneous flags.
snapshot_out_of_sequenceBooleanTrue when this snapshot was computed AFTER one belonging to a later week of the same season type -- so it cannot be read as an as-of-that-week rating. Almost always the week-1 slot, which ESPN overwrites with a late-season computation (2024 week 1 is stamped 2024-12-15). Filter these out for any point-in-time or backtest use.
fpiFloat64Football Power Index that measures team's true strength on net points scale; expected point margin vs average opponent on neutral field.
fpirankFloat64ESPN's FPI rank field. Agrees with rank on 99.4% of rows; on the ~0.6% where they differ it is stale -- it never matches the rank implied by the published fpi, while rank always does. Prefer rank.
projectedwFloat64Projected overall W-L, accounting for results to date and FPI-based projections for remaining scheduled games (and potential conference championship games). May not sum to a whole number because of differing number of games played in each simulation.
projectedlFloat64Projected overall Losses, accounting for results to date and FPI-based projections for remaining scheduled games (including potential conference championship games). May not sum to a whole number because of differing number of games played in each simulation.
projectedtNullProjected ties. Always null -- college football abolished ties in 1996, and ESPN emits the key beside projectedw/projectedl without ever populating it. Retained so the column set matches the upstream payload.
projectedwpctrankFloat64Rank among FBS teams by projected win percentage. ESPN publishes the rank without the underlying percentage; derive it from projectedw and projectedl.
probwinoutFloat64Percent of season simulations in which team won all remaining scheduled games as well as conference championship game (if applicable).
probwinconfFloat64Percent of season simulations in which team won its conference, incorporating chance of getting to and winning conference championship game (if applicable). Accounts for shared conference titles in conferences that allow them.
sosremainingrankFloat64Rank among all FBS teams of remaining schedule strength, from perspective of an average FBS team.
accomplishmentFloat64Reflects chance that an average Top 25 team would have team's record or better, given the schedule. On a 0 to 100 scale, where 100 is best.
accomplishmentrankFloat64Strength of Record rank. Reflects chance that an average Top 25 team would have team's record or better, given the schedule.
adjwinsFloat64Team's Wins adjusted for chance an average FBS team would have team's record or better, given the schedule.
adjlossesFloat64Team's Losses adjusted for chance an average FBS team would have team's record or better, given the schedule.
adjwinpctrankFloat64Rank among FBS teams by adjusted win percentage. ESPN publishes the rank without the underlying percentage; derive it from adjwins and adjlosses. 0 is an unranked placeholder, not a rank -- it appears where the underlying value is null.
gamecontrolFloat64Reflects chance that an average Top 25 team would control games from start to end the way this team did, given the schedule. On a 0 to 100 scale, where 100 is best.
gamecontrolrankFloat64Game Control rank. Reflects chance that an average Top 25 team would control games from start to end the way this team did, given the schedule.
adjavgingamewpFloat64Team's average in-game win probability adjusted for chance that an average FBS team would control games from start to end the way this team did, given the schedule.
adjavgingamewprankFloat64Rank among FBS teams by adjavgingamewp (average in-game win probability adjusted for opponent). Null for most pre-2019 snapshots. 0 is an unranked placeholder, not a rank.
avgingamewpFloat64Team's average in-game win probability across all plays of all games played, not adjusted for site or opponent.
avgingamewprankFloat64Team's average in-game win probability rank adjusted for chance that an average FBS team would control games from start to end the way this team did, given the schedule.
avgsosrankFloat64Rank among all FBS teams of games already played schedule strength, from perspective of an average Top 25 team.
topsosrankFloat64Rank among all FBS teams of games already played schedule strength, from perspective of an top FBS team.
epaoffenseFloat64Offensive component of FPI. Offensive contribution to expected point margin vs average opponent on neutral field.
epadefenseFloat64Defensive component of FPI. Defensive contribution to expected point margin vs average opponent on neutral field.
epaspecialteamsFloat64Special teams component of FPI. Special teams contribution to expected point margin vs average opponent on neutral field.
probwindivFloat64Percent of season simulations in which team won its conference division, for those conferences that have divisions.
probmakeplayoffsFloat64Chance to make the CFB Playoff, according to the Playoff Predictor.
probmaketitlegameFloat64Chance to make the CFB Playoff National Championship game, according to the Playoff Predictor.
numwinsFloat64Actual wins to date at the time of the snapshot. Distinct from projectedw (full-season projection) and adjwins (opponent-adjusted).
numlossesFloat64Actual losses to date at the time of the snapshot. Distinct from projectedl (full-season projection) and adjlosses (opponent-adjusted).
numtiesFloat64Actual ties to date. Never nonzero -- college football abolished ties in 1996; the column is null or 0 in every published row.
probwintitleFloat64Chance to win the CFB Playoff National Championship, according to the Playoff Predictor.
rankchange7daysFloat64FPI Rank change from previous week.
prob6winsFloat64Percent of season simulations in which a team won at least 6 games (typically bowl-eligible).
rankFloat64FPI rank among FBS teams for this snapshot (1 = best). Prefer this over fpirank: the two agree on 99.4% of rows, and on the ~0.6% where they differ, rank is always the one consistent with the published fpi value.
offefficiencyFloat64Offensive efficiency on 0-100 scale; based on offense's contribution to scoring margin on per-play basis, adjusted for strength of opposing defenses faced.
offefficiencyrankFloat64Team's offensive efficiency rank among all FBS teams.
defefficiencyFloat64Defensive efficiency on 0-100 scale; based on defense's contribution to scoring margin on per-play basis, adjusted for strength of opposing offenses faced.
defefficiencyrankFloat64Team's defensive efficiency rank among all FBS teams.
stefficiencyFloat64Special teams efficiency on 0-100 scale; based on special teams' contribution to scoring margin on per-play basis, adjusted for strength of opposing special teams faced.
stefficiencyrankFloat64Team's special teams efficiency rank among all FBS teams.
totefficiencyFloat64Net efficiency on 0-100 scale; incorporates offense, defense and special teams efficiencies into a single schedule-adjusted measure of per-play efficiency.
totefficiencyrankFloat64Team's overall efficiency rank among all FBS teams.
snapshot_is_contemporaneousBooleanTrue when the snapshot was computed inside its own season's window (August of the season year through February of the next), i.e. it is a live weekly run rather than a retrospective backfill. False for every row before 2015, which ESPN computed in one pass afterwards. A retrospective row is a reconstruction, not an as-of-week rating.
load_cfb_fpi_weekly(seasons=2024)

load_cfb_power_index

Release: espn_cfb_power_index · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_power_index/power_index_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
game_idInt64ESPN game identifier.
team_idInt64ESPN team id.
teampredptdiffFloat64Expected margin of victory for the FPI favorite.
gameprojectionFloat64Team's predicted win percentage in this game at time of given BPI run.
matchupqualityFloat64A measure of projected competitiveness and excitement in the game, using a 0 to 100 scale, with 100 as the most exciting.
teamadjgamescoreFloat64A measure of how well a team performed compared to their expected performance and the expected performance of a typical top 25 team.
load_cfb_power_index(seasons=2024)

load_cfb_adv_team

Release: espn_cfb_adv_team · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_team/adv_team_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
rushing_highlight_yards_per_oppFloat64Highlight yards per rushing opportunity.
total_pen_yardsInt64Total penalty yards assessed.
EPA_penaltyFloat64Total EPA attributed to penalties.
penalty_first_downs_createdInt64Number of first downs the team gained via opponent penalty.
penalty_first_downs_created_rateFloat64Share of the team's first downs that came via opponent penalty.
penaltiesInt64Number of penalties assessed against the team.
penalty_yardsInt64Net penalty yardage assessed against the team; can be negative when enforcement moved the team forward on balance.
special_teams_playsInt64Number of special-teams plays.
EPA_spFloat64Total special-teams EPA, ESPN's abbreviated field for the same phase.
EPA_special_teamsFloat64Total EPA generated on special-teams plays.
field_goalsInt64Number of field-goal attempts.
EPA_fgFloat64Total EPA on field-goal attempts.
punt_playsInt64Number of punt plays.
EPA_puntFloat64Total EPA on punt plays.
kickoff_playsInt64Number of kickoff plays.
EPA_kickoffFloat64Total EPA on kickoff plays.
rushesInt64Number of rushing attempts.
rush_yardsFloat64Total yards the team gained on rush plays.
yards_per_rushFloat64Yards gained per rushing attempt.
rushing_power_rateFloat64Share of carries that were power rushing attempts.
rushing_first_downs_createdInt64Number of first downs created on rush plays.
rushing_first_downs_created_rateFloat64Share of rush plays that created a first down.
EPA_rushing_overallFloat64Total EPA on rush plays.
EPA_rushing_per_playFloat64EPA per rush play.
EPA_explosive_rushingInt64Count of explosive rush plays. A play count, not an EPA total.
EPA_explosive_rushing_rateFloat64Explosive-play rate on rush plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_rushingFloat64Total EPA on rush plays with explosive plays excluded.
EPA_non_explosive_rushing_per_playFloat64EPA per rush play with explosive plays excluded.
passesInt64Number of pass plays the team ran.
pass_yardsFloat64Total yards the team gained on pass plays.
yards_per_passFloat64Team game yards per pass.
passing_first_downs_createdInt64Number of first downs created on pass plays.
passing_first_downs_created_rateFloat64Share of pass plays that created a first down.
EPA_passing_overallFloat64Total EPA on pass plays.
EPA_passing_per_playFloat64EPA per pass play.
EPA_explosive_passingInt64Count of explosive pass plays. A play count, not an EPA total.
EPA_explosive_passing_rateFloat64Explosive-play rate on pass plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_passingFloat64Total EPA on pass plays with explosive plays excluded.
EPA_non_explosive_passing_per_playFloat64EPA per pass play with explosive plays excluded.
scrimmage_playsInt64Number of plays from scrimmage (rushes plus passes), excluding special teams.
EPA_overall_offFloat64Total offensive EPA for the team. Duplicated exactly by EPA_overall_offense in every published season checked -- prefer one and ignore the other.
EPA_overall_offenseFloat64Total offensive EPA. An exact duplicate of EPA_overall_off.
EPA_per_playFloat64Offensive EPA per play.
EPA_non_explosiveFloat64Total EPA with explosive plays excluded, isolating the team's routine-down production.
EPA_non_explosive_per_playFloat64EPA per play with explosive plays excluded.
EPA_explosiveInt64Count of explosive plays, per ESPN's advanced box score. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_explosive_rateFloat64Explosive-play rate. Note this is NOT EPA_explosive divided by EPA_plays -- ESPN divides by its own smaller qualifying-play count, so deriving it yourself will not reproduce this value.
passes_rateFloat64Share of the team's plays from scrimmage that were pass plays.
off_yardsInt64Offensive yards gained from scrimmage.
total_off_yardsInt64Total offensive yards across all plays.
yards_per_playFloat64Yards gained per play.
EPA_playsInt64Number of plays ESPN's advanced box score scored for the team.
total_yardsInt64Total yards the team gained across all plays.
EPA_overall_totalFloat64Total EPA across all phases, which is why it differs from the offense-only EPA_overall_off.
rushes_rateFloat64Share of the team's plays from scrimmage that were rush plays.
first_downs_createdInt64Number of first downs the team created.
first_downs_created_rateFloat64Share of the team's plays that created a first down.
EPA_rushing_powerFloat64Total EPA on power rushing situations, as classified by ESPN's advanced box score.
EPA_rushing_power_per_playFloat64EPA per play on power rushing situations.
rushing_power_successInt64Count of power rushing attempts that gained the yardage needed. An integer count, not a rate -- the rate is published separately as rushing_power_success_rate.
rushing_power_success_rateFloat64Share of power rushing attempts that succeeded.
rushing_powerInt64Count of power rushing attempts, in short-yardage situations as classified by ESPN's advanced box score.
rushing_stuffInt64Count of stuffed rushing attempts.
rushing_stuff_rateFloat64Share of the team's carries that were stuffed at or behind the line of scrimmage.
rushing_stoppedInt64Count of rushing attempts stopped at or behind the line of scrimmage.
rushing_stopped_rateFloat64Share of carries stopped at or behind the line of scrimmage.
rushing_opportunityInt64Count of rushing opportunities -- carries that reached ESPN's opportunity threshold.
rushing_opportunity_rateFloat64Share of carries that qualified as rushing opportunities.
rushing_highlightInt64Highlight yards -- rushing yardage credited to the back rather than the offensive line.
rushing_highlight_rateFloat64Share of rushing yardage that was highlight (back-credited) yardage.
rushing_highlight_yardsFloat64Total highlight yards the team accumulated -- the yardage credited to ball carriers rather than the line. The per-carry figure is rushing_highlight_yards_per_opp.
line_yardsFloat64Line yards -- the portion of rushing yardage credited to the offensive line under the standard rushing decomposition. ESPN applies its own qualifying threshold for the yardage split.
line_yards_per_carryFloat64Line yards per rushing attempt.
second_level_yardsFloat64Second-level yards -- rushing yardage earned just beyond the line of scrimmage.
open_field_yardsFloat64Open-field yards -- rushing yardage earned well downfield, past the second level.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_team(seasons=2024)

load_cfb_adv_passing

Release: espn_cfb_adv_passing · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_passing/adv_passing_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
passer_player_nameStringDisplay name of the passer -- the FIRST participant in that role on the play.
CompInt64Completed passes recorded in the advanced box score.
AttInt64Pass attempts recorded in the advanced box score.
xCompFloat64Expected completions, summed from the per-play completion model.
YdsFloat64Passing yards from the advanced box score.
Pass_TDInt64Passing touchdowns.
IntInt64Interceptions thrown.
YPAFloat64Yards per pass attempt.
EPAFloat64Expected Points Added on the play (cfbfastR EPA model output).
EPA_per_PlayFloat64EPA per play on the passer's plays.
WPAFloat64Win Probability Added.
SRFloat64Success rate on the passer's plays.
SckInt64Times the passer was sacked.
CompPctFloat64Completion percentage from the advanced box score.
xCompPctFloat64Expected completion percentage from the per-play completion model.
CPOEFloat64Completion percentage over expected -- actual minus modelled completion rate.
qbr_epaFloat64EPA variant used as an input to the QBR calculation.
sack_epaFloat64EPA credited to the player's sacks taken.
pass_epaFloat64EPA credited to the player's pass plays.
rush_epaFloat64EPA credited to the player's rush plays.
pen_epaFloat64EPA attributable to penalties on the player's plays.
spreadFloat64Pre-game point spread from the selected provider.
era0Int64Rule-era indicator for the earliest modelled era.
era1Int64Rule-era indicator for the second modelled era.
era2Int64Rule-era indicator for the third modelled era.
era3Int64Rule-era indicator for the most recent modelled era.
exp_qbrFloat64Expected QBR for the passer.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_passing(seasons=2024)

load_cfb_adv_rushing

Release: espn_cfb_adv_rushing · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_rushing/adv_rushing_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
rusher_player_nameStringDisplay name of the ball carrier on a rush -- the FIRST participant in that role on the play.
CarInt64Rushing attempts credited to this ball carrier in the game.
YdsFloat64Passing yards from the advanced box score.
Rush_TDInt64Rushing touchdowns scored by this ball carrier in the game.
YPCFloat64Yards per carry, the mean rushing yardage across the player's attempts in the game.
EPAFloat64Expected Points Added on the play (cfbfastR EPA model output).
EPA_per_PlayFloat64EPA per play on the passer's plays.
WPAFloat64Win Probability Added.
SRFloat64Success rate on the passer's plays.
FumInt64Count of the carrier's rush attempts whose play text mentions a fumble; it is a play-level flag, not a fumble charged to this player.
Fum_LostInt64Count of the carrier's rush attempts on which a fumble was lost to the opponent.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_rushing(seasons=2024)

load_cfb_adv_receiving

Release: espn_cfb_adv_receiving · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_receiving/adv_receiving_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
receiver_player_nameStringDisplay name of the targeted receiver -- the FIRST participant in that role on the play.
RecInt64Receptions credited to the receiver, the number of completions on plays where this player was the targeted receiver.
TarInt64Times the player was targeted on a pass attempt, the denominator behind YPT.
YdsFloat64Passing yards from the advanced box score.
Rec_TDInt64Receiving touchdowns, the count of the player's targeted plays that ended in a passing touchdown.
YPTFloat64Receiving yards per target, the mean of receiving yardage over every target rather than over receptions only.
EPAFloat64Expected Points Added on the play (cfbfastR EPA model output).
EPA_per_PlayFloat64EPA per play on the passer's plays.
WPAFloat64Win Probability Added.
SRFloat64Success rate on the passer's plays.
FumInt64Count of the receiver's targeted pass plays whose text mentions a fumble; it is a play-level flag, not a fumble charged to this player.
Fum_LostInt64Count of the receiver's targeted plays on which a fumble was lost to the opponent.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_receiving(seasons=2024)

load_cfb_adv_defensive

Release: espn_cfb_adv_defensive · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_defensive/adv_defensive_{season}.parquet

Returns

col_nametypedescription
def_pos_team_idInt64ESPN team id of the team on defense. Present for every season 2004+.
def_pos_teamStringTeam name on defense at the start of the play.
scrimmage_playsInt64Number of plays from scrimmage (rushes plus passes), excluding special teams.
TFLInt64Count of scrimmage plays the defense held to negative yardage (non-penalty, non-special-teams, ESPN statYardage below zero) plus every sack.
TFL_passInt64The TFL count restricted to plays classified as passes, so it covers sacks together with completions and laterals stopped behind the line.
TFL_rushInt64The TFL count restricted to plays classified as rushes, that is rushing attempts the defense stopped for negative yardage.
havoc_totalInt64Total havoc rate.
havoc_total_rateFloat64Share of the defense's scrimmage plays producing a havoc event, a 0-to-1 fraction equal to havoc_total divided by scrimmage_plays.
fumblesInt64Fumbles the defense forced, counted from plays whose narrative contains the phrase forced by, not the total number of fumbles on the play.
def_intInt64Interceptions the defense recorded, counted from plays ESPN types as Interception Return or Interception Return Touchdown.
drive_stopped_rateFloat64Percentage from 0 to 100 of the defense's scrimmage plays that occurred on drives ending in a punt, fumble, interception, or turnover on downs; the denominator is plays, not drives.
num_pass_playsInt64Number of pass scrimmage plays the defense faced, the denominator behind havoc_total_pass_rate and sacks_rate.
havoc_total_passInt64Havoc events (tackle for loss, sack, interception, forced fumble, or pass breakup) recorded on the pass plays the defense faced.
havoc_total_pass_rateFloat64havoc_total_pass divided by num_pass_plays, the defense's havoc rate against the pass as a 0-to-1 fraction.
sacksInt64Team sacks.
sacks_rateFloat64Sacks divided by pass plays faced, the defense's per-pass-play sack rate as a 0-to-1 fraction.
pass_breakupsInt64Passes the defense broke up, counted from plays whose narrative contains the phrase broken up by.
havoc_total_rushInt64Havoc events recorded on the rush plays the defense faced, in practice tackles for loss and forced fumbles.
havoc_total_rush_rateFloat64Havoc events per rush play faced, the mean of the havoc flag over the defense's rush scrimmage plays.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_defensive(seasons=2024)

load_cfb_adv_defensive_players

Release: espn_cfb_adv_defensive_players · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_defensive_players/adv_defensive_players_{season}.parquet

Returns

col_nametypedescription
def_pos_team_idInt64ESPN team id of the team on defense. Present for every season 2004+.
def_pos_teamStringDisplay name of the team on defense (e.g. 'Ohio State Buckeyes'). Held an ESPN team id until the 2026-08 republish; the id now lives in def_pos_team_id.
player_nameStringDisplay name of the defender.
sacksInt64Sacks recorded by the defender. Available from 2005 on; null for 2004.
sacks_yardsInt64Yards lost by the offense on the defender's sacks. Available from 2005 on; null for 2004.
fumble_recoveriesInt64Fumbles recovered by the defender. Available for every season 2004+.
fumble_recoveries_yardsInt64Yards returned on the defender's fumble recoveries. Available for every season 2004+.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
pass_breakupsInt64Passes broken up by the defender. Available from 2005 on; null for 2004.
interceptionsInt64Passes intercepted by the defender. Available from 2014 on; null for 2004-2013, which ESPN ships without interception statistics in this block.
interceptions_yardsInt64Yards returned on the defender's interceptions. Available from 2014 on; null for 2004-2013.
forced_fumblesInt64Fumbles forced by the defender. Available from 2005 on; null for 2004, which ESPN ships with only the fumble-recovery statistics.
load_cfb_adv_defensive_players(seasons=2024)

load_cfb_adv_drives

Release: espn_cfb_adv_drives · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_drives/adv_drives_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
drive_total_available_yardsFloat64Sum of each drive's starting distance to the opponent end zone taken across every scrimmage play, so a drive contributes its available yards once per play rather than once per drive.
drive_total_gained_yardsInt64Sum of ESPN's per-drive yardage repeated across every scrimmage play of that drive, so a drive contributes its yardage once per play.
avg_field_positionFloat64Mean distance to the opponent end zone at drive start averaged over the team's scrimmage plays, exactly drive_total_available_yards divided by that play count.
plays_per_driveFloat64Mean of ESPN's per-drive offensivePlays taken over plays rather than over drives, which weights every drive by its own length.
yards_per_driveFloat64Mean of ESPN's per-drive yardage taken over plays rather than over drives, exactly drive_total_gained_yards divided by the team's scrimmage-play count.
drivesInt64Number of distinct ESPN drive ids on which the team ran at least one scrimmage play.
drive_total_gained_yards_rateFloat64Available-yards conversion as a percentage, 100 times drive_total_gained_yards over drive_total_available_yards with both sums play-weighted.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_drives(seasons=2024)

load_cfb_adv_situational

Release: espn_cfb_adv_situational · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_situational/adv_situational_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringDisplay name of the team on offense (e.g. 'Ohio State Buckeyes').
EPA_successInt64Count of successful plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rateFloat64Success rate -- the share of those plays ESPN scored as successful.
EPA_success_passInt64Count of successful plays on pass plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_pass_rateFloat64Success rate on pass plays -- the share of those plays ESPN scored as successful.
EPA_success_rushInt64Count of successful plays on rush plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rush_rateFloat64Success rate on rush plays -- the share of those plays ESPN scored as successful.
EPA_success_rzInt64Count of successful plays on the red zone. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rate_rzFloat64Success rate on the red zone -- the share of those plays ESPN scored as successful.
EPA_success_thirdInt64Count of successful plays on third down. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rate_thirdFloat64Success rate on third down -- the share of those plays ESPN scored as successful.
EPA_success_early_downInt64Count of successful plays on early downs. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_early_down_rateFloat64Success rate on early downs -- the share of those plays ESPN scored as successful.
early_downsInt64Number of plays the team ran on early downs.
early_down_pass_rateFloat64Share of the team's plays on early downs that were pass plays.
early_down_rush_rateFloat64Share of the team's plays on early downs that were rush plays.
EPA_early_downFloat64Total EPA the team generated on early downs.
EPA_early_down_per_playFloat64EPA per play on early downs.
early_down_first_downInt64Number of early-down plays that produced a first down.
early_down_first_down_rateFloat64Share of early-down plays that produced a first down.
early_down_passInt64Number of pass plays the team ran on early downs.
EPA_early_down_passFloat64Total EPA the team generated on early downs on pass plays.
EPA_early_down_pass_per_playFloat64EPA per play on early downs on pass plays.
EPA_success_early_down_passInt64Count of successful plays on early downs on pass plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_early_down_pass_rateFloat64Success rate on early downs on pass plays -- the share of those plays ESPN scored as successful.
early_down_rushInt64Number of rush plays the team ran on early downs.
EPA_early_down_rushFloat64Total EPA the team generated on early downs on rush plays.
EPA_early_down_rush_per_playFloat64EPA per play on early downs on rush plays.
EPA_success_early_down_rushInt64Count of successful plays on early downs on rush plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_early_down_rush_rateFloat64Success rate on early downs on rush plays -- the share of those plays ESPN scored as successful.
middle_8Int64Number of plays the team ran in the middle eight -- the closing minutes of the first half and opening minutes of the second.
middle_8_pass_rateFloat64Share of the team's plays on the middle eight -- the closing minutes of the first half and opening minutes of the second that were pass plays.
middle_8_rush_rateFloat64Share of the team's plays on the middle eight -- the closing minutes of the first half and opening minutes of the second that were rush plays.
EPA_middle_8Float64Total EPA the team generated on the middle eight -- the closing minutes of the first half and opening minutes of the second.
EPA_middle_8_per_playFloat64EPA per play on the middle eight -- the closing minutes of the first half and opening minutes of the second.
EPA_middle_8_successInt64Count of successful plays on the middle eight -- the closing minutes of the first half and opening minutes of the second. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_middle_8_success_rateFloat64Success rate on the middle eight -- the closing minutes of the first half and opening minutes of the second -- the share of those plays ESPN scored as successful.
middle_8_passInt64Number of pass plays the team ran on the middle eight -- the closing minutes of the first half and opening minutes of the second.
EPA_middle_8_passFloat64Total EPA the team generated on the middle eight -- the closing minutes of the first half and opening minutes of the second on pass plays.
EPA_middle_8_pass_per_playFloat64EPA per play on the middle eight -- the closing minutes of the first half and opening minutes of the second on pass plays.
EPA_middle_8_success_passInt64Count of successful plays on the middle eight -- the closing minutes of the first half and opening minutes of the second on pass plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_middle_8_success_pass_rateFloat64Success rate on the middle eight -- the closing minutes of the first half and opening minutes of the second on pass plays -- the share of those plays ESPN scored as successful.
middle_8_rushInt64Number of rush plays the team ran on the middle eight -- the closing minutes of the first half and opening minutes of the second.
EPA_middle_8_rushFloat64Total EPA the team generated on the middle eight -- the closing minutes of the first half and opening minutes of the second on rush plays.
EPA_middle_8_rush_per_playFloat64EPA per play on the middle eight -- the closing minutes of the first half and opening minutes of the second on rush plays.
EPA_middle_8_success_rushInt64Count of successful plays on the middle eight -- the closing minutes of the first half and opening minutes of the second on rush plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_middle_8_success_rush_rateFloat64Success rate on the middle eight -- the closing minutes of the first half and opening minutes of the second on rush plays -- the share of those plays ESPN scored as successful.
EPA_success_late_downInt64Count of successful plays on late downs. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_late_down_passInt64Count of successful plays on late downs on pass plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_late_down_rushInt64Count of successful plays on late downs on rush plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
late_downsInt64Number of plays the team ran on late downs.
late_down_passInt64Number of pass plays the team ran on late downs.
late_down_rushInt64Number of rush plays the team ran on late downs.
EPA_late_downFloat64Total EPA the team generated on late downs.
EPA_late_down_per_playFloat64EPA per play on late downs.
EPA_success_late_down_rateFloat64Success rate on late downs -- the share of those plays ESPN scored as successful.
EPA_success_late_down_pass_rateFloat64Success rate on late downs on pass plays -- the share of those plays ESPN scored as successful.
EPA_success_late_down_rush_rateFloat64Success rate on late downs on rush plays -- the share of those plays ESPN scored as successful.
late_down_pass_rateFloat64Share of the team's plays on late downs that were pass plays.
late_down_rush_rateFloat64Share of the team's plays on late downs that were rush plays.
EPA_success_standard_downInt64Count of successful plays on standard downs (the team ahead of schedule for the series). Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_standard_down_rateFloat64Success rate on standard downs (the team ahead of schedule for the series) -- the share of those plays ESPN scored as successful.
EPA_standard_downFloat64Total EPA the team generated on standard downs (the team ahead of schedule for the series).
EPA_standard_down_per_playFloat64EPA per play on standard downs (the team ahead of schedule for the series).
standard_downsInt64Number of plays the team ran on standard downs (the team ahead of schedule for the series).
EPA_success_passing_downInt64Count of successful plays on passing downs (the team behind schedule for the series). Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_passing_down_rateFloat64Success rate on passing downs (the team behind schedule for the series) -- the share of those plays ESPN scored as successful.
EPA_passing_downFloat64Total EPA the team generated on passing downs (the team behind schedule for the series).
EPA_passing_down_per_playFloat64EPA per play on passing downs (the team behind schedule for the series).
passing_downsInt64Number of plays the team ran on passing downs (the team behind schedule for the series).
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_situational(seasons=2024)

load_cfb_adv_specialists

Release: espn_cfb_adv_specialists · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_specialists/adv_specialists_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
player_nameStringFull name of player
field_goalsInt64Number of field-goal attempts.
field_goals_yardsInt64Sum 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.
puntsInt64Punts attempted.
punts_yardsInt64Total gross punt yardage parsed from the play text for this punter, working out to roughly 42 yards per punt league-wide.
kick_returnsInt64Number of kick returns.
kick_returns_yardsInt64Total yards the team gained returning kickoffs.
punt_returnsInt64Number of punt returns.
punt_returns_yardsInt64Total punt-return yardage credited to this returner, with fair catches, downed punts, and out-of-bounds punts scored as zero.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_specialists(seasons=2024)

load_cfb_adv_turnover

Release: espn_cfb_adv_turnover · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_turnover/adv_turnover_{season}.parquet

Returns

col_nametypedescription
pos_team_idInt64ESPN team id of the team on offense. Present for every season 2004+.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
turnoversInt64Turnovers total.
st_turnovers_lostInt64Turnovers the team lost on special-teams plays.
IntInt64Interceptions thrown.
fumbles_lostInt64Fumbles lost.
pass_breakupsInt64Passes thrown by this offense that the opposing defense broke up; it equals the opponent's row in the advanced defensive table exactly.
total_fumblesInt64Team total fumbles.
fumbles_recoveredInt64Team fumbles recovered.
team_idInt64ESPN team id.
turnovers_pbpInt64Turnover count derived from the play-by-play, retained unchanged so it can be reconciled against the ESPN-sourced turnovers total.
Int_pbpInt64Interception count derived from the play-by-play, kept alongside the ESPN-sourced Int for reconciliation.
fumbles_lost_pbpInt64Fumbles-lost count derived from the play-by-play, kept alongside the ESPN-sourced fumbles_lost for reconciliation.
espn_sourcedBooleanCONSTANT: true on every published row. It records that the row was built from the ESPN feed rather than an alternate provider, and no other provider is currently used.
expected_turnoversFloat64Turnover expectation for this team, computed as half its total fumbles plus 0.22 times the sum of its pass breakups and interceptions.
expected_turnover_marginFloat64The opponent's expected_turnovers minus this team's, so positive means the team was expected to win the turnover battle.
turnover_marginInt64The opponent's turnovers minus this team's turnovers, positive when the team gained more possessions than it gave away.
turnover_luckFloat64Points of scoring luck attributed to turnovers, five points per turnover times the gap between turnover_margin and expected_turnover_margin.
takeawaysInt64Takeaways.
st_turnovers_gainedInt64Special-teams turnovers this team recovered, taken as the opponent's st_turnovers_lost.
fumble_recoveries_gainedInt64Opponent fumbles this team recovered, taken as the opponent's fumbles_lost.
game_idInt64ESPN game identifier.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
load_cfb_adv_turnover(seasons=2024)

load_cfb_model_pbp

Release: espn_cfb_model_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_model_pbp/model_pbp_{season}.parquet

Returns

col_nametypedescription
game_idInt64ESPN game identifier.
idString247Sports referencing id for the recruit.
sequenceNumberStringBroadcast sequence order number.
game_play_numberInt64Sequential play number within the game (excludes timeouts/end markers).
drive.idStringESPN's drive identifier, formed as the game id followed by the drive's sequence number within that game.
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
periodInt64Period (quarter) number.
pos_teamInt64Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_teamInt64Team name on defense at the start of the play.
start.pos_team.nameStringSchool name of the team with possession at the snap, taken from ESPN's team location field so it carries no mascot.
homeTeamIdInt64ESPN team id of the home team, read off the game header and stamped on every play.
awayTeamIdInt64ESPN team id of the away team, read off the game header and stamped on every play.
homeTeamNameStringHome team's school name from ESPN's team location field, without the mascot.
awayTeamNameStringAway team's school name from ESPN's team location field, without the mascot.
type.textStringESPN's play-type label, for example Rush, Pass Reception, Sack, Punt, Penalty, or Timeout.
textStringFull play description.
start.downInt64Down at the snap as ESPN reports it; 0 marks the small share of rows ESPN leaves without a down, overwhelmingly timeouts and penalty administrations.
start.distanceInt64Yards the offense needs for a first down at the snap, carried through from ESPN without correction.
start.yardsToEndzoneInt64Distance in yards from the offense's spot at the snap to the opponent's end zone, ranging 0 to 100.
pos_score_diff_startInt64Score differential for the possession team at the start of the play.
start.TimeSecsRemInt64Seconds remaining in the half at the snap, so it tops out at 1800 rather than counting down from a full game.
start.is_homeBooleanTrue when the team holding possession at the snap is the home team.
passing_downBooleanTrue on second and eight or longer, third and five or longer, or fourth and five or longer, the standard obvious-passing-situation flag.
passBooleanBinary flag for a passing play (includes sacks).
rushBooleanBinary flag for a rushing play.
completionBooleanBinary flag for a completed pass.
scoring_playBooleanTRUE if the play resulted in a score.
statYardageInt64Yards gained on the play as ESPN reports it, negative on plays that lost yardage.
passer_player_nameStringDisplay name of the passer -- the FIRST participant in that role on the play.
ep_beforeFloat64Expected points value before the play (cfbfastR EPA model).
ep_afterFloat64Expected points value after the play (cfbfastR EPA model).
epaFloat64Expected points added (EPA) by the posteam for the given play.
wp_beforeFloat64Win probability for the possession team before the play (0-1).
wp_afterFloat64Win probability for the possession team after the play (0-1).
wpaFloat64Win Probability Added on the play (cfbfastR WP model output).
completion_probFloat64Modelled probability the pass is completed.
cpoeFloat64For a single pass play this is 1 - cp when the pass was completed or 0 - cp when the pass was incomplete. Analyzed for a whole game or season an indicator for the passer how much over or under expectation his completion percentage was.
model_pbp_versionStringVersion of the model-scored play-by-play build.
cp_model_versionStringVersion of the completion-probability model that scored the play.
ep_model_versionStringVersion of the expected-points model that scored the play.
wp_model_versionStringVersion of the win-probability model that scored the play.
scored_dateStringDate on which the play was scored by the models.
load_cfb_model_pbp(seasons=2024)

load_cfb_passing

Release: espn_cfb_passing · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_passing/cfb_passing_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
divisionStringDivision in the conference for the team.
conferenceStringConference of the team.
seasonInt64Season (4-digit year).
player_idInt64ESPN player id from the roster entry.
passer_player_nameStringDisplay name of the passer -- the FIRST participant in that role on the play.
playsUInt32Total qualifying passing plays included in the WEPA calculation.
gamesUInt32Number of games included in the ATS summary.
team_gamesUInt32Games the team played, used as the per-game denominator.
TEPAFloat64Total EPA summed over every play.
EPAplayFloat64EPA generated per play.
yardsInt64Total yards gained on the drive.
successFloat64Success rate across the team plays.
compFloat64Completed passes.
attFloat64Pass attempts thrown.
comppctFloat64Completion percentage.
passing_tdFloat64Passing touchdowns thrown.
playsgameFloat64Plays per game.
EPAgameFloat64EPA generated per game.
yardsplayFloat64Yards per play.
yardsgameFloat64Yards per game.
sackedUInt32Times the passer was sacked.
sack_ydsInt64Yards lost to sacks.
pass_intUInt32Interceptions thrown.
detmerFloat64Detmer rating -- the composite passing-efficiency measure this pipeline publishes, named for the college passing-efficiency tradition.
detmergameFloat64Detmer rating expressed per game.
dropbacksFloat64Dropbacks taken by the passer.
sack_adj_yardsInt64Passing yards adjusted for sack yardage lost.
yardsdropbackFloat64Yards per dropback.
TEPA_rankFloat64National rank of the team's total EPA summed over every play, where 1 is best.
EPAgame_rankFloat64National rank of the team's EPA generated per game, where 1 is best.
EPAplay_rankFloat64National rank of the team's EPA generated per play, where 1 is best.
success_rankFloat64National rank of the team's success rate across the team plays, where 1 is best.
comppct_rankFloat64National rank of the team's completion percentage, where 1 is best.
yards_rankFloat64National rank of the team's total yards, where 1 is best.
yardsplay_rankFloat64National rank of the team's yards per play, where 1 is best.
yardsgame_rankFloat64National rank of the team's yards per game, where 1 is best.
sack_adj_yards_rankFloat64National rank of the team's passing yards adjusted for sack yardage lost, where 1 is best.
yardsdropback_rankFloat64National rank of the team's yards per dropback, where 1 is best.
detmer_rankFloat64National rank of the team's detmer rating -- the composite passing-efficiency measure this pipeline publishes, named for the college passing-efficiency tradition, where 1 is best.
detmergame_rankFloat64National rank of the team's detmer rating expressed per game, where 1 is best.
fbs_classStringPower/Group classification for the season: P4 or G6 from 2024 on, P5 or G5 through 2023, derived from conference membership. Null for teams outside FBS.
load_cfb_passing(seasons=2024)

load_cfb_percentiles

Release: espn_cfb_percentiles · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_percentiles/cfb_percentiles_{season}.parquet

Returns

col_nametypedescription
pctileFloat64Percentile bucket the row reports, from 0 to 100.
GEIFloat64Value of game excitement index at the percentile this row reports.
EPAplayFloat64Value of EPA generated per play at the percentile this row reports.
pass_successFloat64Value of success rate on pass plays at the percentile this row reports.
rush_successFloat64Value of success rate on rush plays at the percentile this row reports.
early_down_successFloat64Value of success rate on early downs at the percentile this row reports.
early_down_EPAFloat64Value of EPA per early-down play at the percentile this row reports.
late_down_successFloat64Value of success rate on late downs at the percentile this row reports.
successFloat64Value of success rate across the team plays at the percentile this row reports.
yardsplayFloat64Value of yards per play at the percentile this row reports.
dropbacksFloat64Value of dropbacks taken by the passer at the percentile this row reports.
rushesFloat64Value of rushing attempts at the percentile this row reports.
EPAdropbackFloat64Value of EPA generated per dropback at the percentile this row reports.
EPArushFloat64Value of EPA generated per rushing attempt at the percentile this row reports.
yardsdropbackFloat64Value of yards per dropback at the percentile this row reports.
pass_explosiveFloat64Value of explosive-play rate on pass plays at the percentile this row reports.
rush_explosiveFloat64Value of explosive-play rate on rush plays at the percentile this row reports.
explosiveFloat64Value of explosive-play rate at the percentile this row reports.
third_down_successFloat64Value of success rate on third down at the percentile this row reports.
red_zone_successFloat64Value of success rate in the red zone at the percentile this row reports.
play_stuffedFloat64Value of stuffed-play rate at the percentile this row reports.
nonExplosiveEpaPerPlayFloat64Value of EPA per play excluding explosive plays at the percentile this row reports.
havocFloat64Value of havoc rate at the percentile this row reports.
yardsrushFloat64Value of yards per rush at the percentile this row reports.
lineyardsFloat64Value of line yards per rush at the percentile this row reports.
opportunity_runFloat64Value of opportunity-run rate at the percentile this row reports.
third_down_distanceFloat64Value of average yards to go on third down at the percentile this row reports.
load_cfb_percentiles(seasons=2024)

load_cfb_receiving

Release: espn_cfb_receiving · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_receiving/cfb_receiving_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
divisionStringDivision in the conference for the team.
conferenceStringConference of the team.
seasonInt64Season (4-digit year).
player_idInt64ESPN player id from the roster entry.
receiver_player_nameStringDisplay name of the targeted receiver -- the FIRST participant in that role on the play.
playsUInt32Total qualifying passing plays included in the WEPA calculation.
gamesUInt32Number of games included in the ATS summary.
team_gamesUInt32Games the team played, used as the per-game denominator.
TEPAFloat64Total EPA summed over every play.
EPAplayFloat64EPA generated per play.
yardsInt64Total yards gained on the drive.
successFloat64Success rate across the team plays.
compUInt32Completed passes.
targetsUInt32The number of pass plays where the player was the targeted receiver.
passing_tdFloat64Passing touchdowns thrown.
fumblesFloat64Count of the receiver's targeted pass plays across the season whose play text mentions a fumble by either team.
playsgameFloat64Plays per game.
EPAgameFloat64EPA generated per game.
yardsplayFloat64Yards per play.
yardsgameFloat64Yards per game.
catchpctFloat64Catch rate on a 0-to-1 scale, receptions divided by targets for the season.
TEPA_rankFloat64National rank of the team's total EPA summed over every play, where 1 is best.
EPAgame_rankFloat64National rank of the team's EPA generated per game, where 1 is best.
EPAplay_rankFloat64National rank of the team's EPA generated per play, where 1 is best.
success_rankFloat64National rank of the team's success rate across the team plays, where 1 is best.
catchpct_rankFloat64Season rank of catchpct with the best catch rate first, computed only for receivers clearing the leaderboard minimum of 1.875 targets per team game and using averaged ranks for ties.
yards_rankFloat64National rank of the team's total yards, where 1 is best.
yardsplay_rankFloat64National rank of the team's yards per play, where 1 is best.
yardsgame_rankFloat64National rank of the team's yards per game, where 1 is best.
fbs_classStringPower/Group classification for the season: P4 or G6 from 2024 on, P5 or G5 through 2023, derived from conference membership. Null for teams outside FBS.
load_cfb_receiving(seasons=2024)

load_cfb_rushing

Release: espn_cfb_rushing · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_rushing/cfb_rushing_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
divisionStringDivision in the conference for the team.
conferenceStringConference of the team.
seasonInt64Season (4-digit year).
player_idInt64ESPN player id from the roster entry.
rusher_player_nameStringDisplay name of the ball carrier on a rush -- the FIRST participant in that role on the play.
playsUInt32Total qualifying passing plays included in the WEPA calculation.
gamesUInt32Number of games included in the ATS summary.
team_gamesUInt32Games the team played, used as the per-game denominator.
TEPAFloat64Total EPA summed over every play.
EPAplayFloat64EPA generated per play.
yardsInt64Total yards gained on the drive.
successFloat64Success rate across the team plays.
rushing_tdFloat64Rushing touchdowns.
fumblesFloat64Count of the ball carrier's rush attempts across the season whose play text mentions a fumble by either team.
playsgameFloat64Plays per game.
EPAgameFloat64EPA generated per game.
yardsplayFloat64Yards per play.
yardsgameFloat64Yards per game.
TEPA_rankFloat64National rank of the team's total EPA summed over every play, where 1 is best.
EPAgame_rankFloat64National rank of the team's EPA generated per game, where 1 is best.
EPAplay_rankFloat64National rank of the team's EPA generated per play, where 1 is best.
success_rankFloat64National rank of the team's success rate across the team plays, where 1 is best.
yards_rankFloat64National rank of the team's total yards, where 1 is best.
yardsplay_rankFloat64National rank of the team's yards per play, where 1 is best.
yardsgame_rankFloat64National rank of the team's yards per game, where 1 is best.
fbs_classStringPower/Group classification for the season: P4 or G6 from 2024 on, P5 or G5 through 2023, derived from conference membership. Null for teams outside FBS.
load_cfb_rushing(seasons=2024)

load_cfb_team_summaries

Release: espn_cfb_team_summaries · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_team_summaries/cfb_team_summaries_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
divisionStringDivision in the conference for the team.
conferenceStringConference of the team.
seasonInt64Season (4-digit year).
plays_offUInt32Plays run, with the team on offense.
passrate_offFloat64Share of plays that were pass plays, with the team on offense.
rushrate_offFloat64Share of plays that were rush plays, with the team on offense.
havoc_offFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on offense.
explosive_offFloat64Explosive-play rate -- the share of plays carrying the explosive flag, with the team on offense.
TEPA_offFloat64Total EPA summed over every play, with the team on offense.
EPAplay_offFloat64EPA per play, with the team on offense.
yards_offInt64Total yards gained, with the team on offense.
yardsplay_offFloat64Yards gained per play, with the team on offense.
play_stuffed_offFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on offense.
success_offFloat64Success rate -- the share of plays flagged as successful by EPA, with the team on offense.
red_zone_success_offFloat64Success rate on red-zone plays, with the team on offense.
third_down_success_offFloat64Success rate on third-down plays, with the team on offense.
third_down_distance_offFloat64Average yards to go on third down, with the team on offense.
late_down_success_offFloat64Success rate on late-down plays, with the team on offense.
early_down_EPA_offFloat64EPA per early-down play, with the team on offense.
start_position_offFloat64Average drive start position, measured in yards from the opponent goal line, with the team on offense.
nonExplosiveEpaPerPlay_offFloat64EPA per play with explosive plays excluded, with the team on offense.
line_yards_offFloat64Average line yards credited to the offensive line on rushes, with the team on offense.
opportunity_rate_offFloat64Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on offense.
playsgame_offFloat64Plays run per game, with the team on offense.
EPAdrive_offFloat64EPA per drive (total EPA divided by drives), with the team on offense.
EPAgame_offFloat64EPA per game (total EPA divided by games), with the team on offense.
yardsgame_offFloat64Yards gained per game, with the team on offense.
drives_offUInt32Offensive drives, with the team on offense.
drivesgame_offFloat64Drives per game, with the team on offense.
yardsdrive_offFloat64Yards gained per drive, with the team on offense.
playsdrive_offFloat64Plays run per drive, with the team on offense.
playsgame_off_rankFloat64National rank of the team's plays run per game with the team on offense, where 1 is best.
TEPA_off_rankFloat64National rank of the team's total EPA summed over every play with the team on offense, where 1 is best.
EPAgame_off_rankFloat64National rank of the team's EPA per game (total EPA divided by games) with the team on offense, where 1 is best.
EPAplay_off_rankFloat64National rank of the team's EPA per play with the team on offense, where 1 is best.
EPAdrive_off_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) with the team on offense, where 1 is best.
early_down_EPA_off_rankFloat64National rank of the team's EPA per early-down play with the team on offense, where 1 is best.
success_off_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA with the team on offense, where 1 is best.
yards_off_rankFloat64National rank of the team's total yards gained with the team on offense, where 1 is best.
yardsplay_off_rankFloat64National rank of the team's yards gained per play with the team on offense, where 1 is best.
yardsgame_off_rankFloat64National rank of the team's yards gained per game with the team on offense, where 1 is best.
drivesgame_off_rankFloat64National rank of the team's drives per game with the team on offense, where 1 is best.
yardsdrive_off_rankFloat64National rank of the team's yards gained per drive with the team on offense, where 1 is best.
playsdrive_off_rankFloat64National rank of the team's plays run per drive with the team on offense, where 1 is best.
play_stuffed_off_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag with the team on offense, where 1 is best.
red_zone_success_off_rankFloat64National rank of the team's success rate on red-zone plays with the team on offense, where 1 is best.
third_down_success_off_rankFloat64National rank of the team's success rate on third-down plays with the team on offense, where 1 is best.
late_down_success_off_rankFloat64National rank of the team's success rate on late-down plays with the team on offense, where 1 is best.
third_down_distance_off_rankFloat64National rank of the team's average yards to go on third down with the team on offense, where 1 is best.
start_position_off_rankFloat64National rank of the team's average drive start position, measured in yards from the opponent goal line with the team on offense, where 1 is best.
havoc_off_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag with the team on offense, where 1 is best.
explosive_off_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag with the team on offense, where 1 is best.
passrate_off_rankFloat64National rank of the team's share of plays that were pass plays with the team on offense, where 1 is best.
rushrate_off_rankFloat64National rank of the team's share of plays that were rush plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_rankFloat64National rank of the team's EPA per play with explosive plays excluded with the team on offense, where 1 is best.
line_yards_off_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes with the team on offense, where 1 is best.
opportunity_rate_off_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag with the team on offense, where 1 is best.
plays_defUInt32Plays run, with the team on defense (i.e. allowed to opponents).
passrate_defFloat64Share of plays that were pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_defFloat64Share of plays that were rush plays, with the team on defense (i.e. allowed to opponents).
havoc_defFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on defense (i.e. allowed to opponents).
explosive_defFloat64Explosive-play rate -- the share of plays carrying the explosive flag, with the team on defense (i.e. allowed to opponents).
TEPA_defFloat64Total EPA summed over every play, with the team on defense (i.e. allowed to opponents).
EPAplay_defFloat64EPA per play, with the team on defense (i.e. allowed to opponents).
yards_defInt64Total yards gained, with the team on defense (i.e. allowed to opponents).
yardsplay_defFloat64Yards gained per play, with the team on defense (i.e. allowed to opponents).
play_stuffed_defFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on defense (i.e. allowed to opponents).
success_defFloat64Success rate -- the share of plays flagged as successful by EPA, with the team on defense (i.e. allowed to opponents).
red_zone_success_defFloat64Success rate on red-zone plays, with the team on defense (i.e. allowed to opponents).
third_down_success_defFloat64Success rate on third-down plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_defFloat64Average yards to go on third down, with the team on defense (i.e. allowed to opponents).
late_down_success_defFloat64Success rate on late-down plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_defFloat64EPA per early-down play, with the team on defense (i.e. allowed to opponents).
start_position_defFloat64Average drive start position, measured in yards from the opponent goal line, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_defFloat64EPA per play with explosive plays excluded, with the team on defense (i.e. allowed to opponents).
line_yards_defFloat64Average line yards credited to the offensive line on rushes, with the team on defense (i.e. allowed to opponents).
opportunity_rate_defFloat64Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on defense (i.e. allowed to opponents).
playsgame_defFloat64Plays run per game, with the team on defense (i.e. allowed to opponents).
EPAdrive_defFloat64EPA per drive (total EPA divided by drives), with the team on defense (i.e. allowed to opponents).
EPAgame_defFloat64EPA per game (total EPA divided by games), with the team on defense (i.e. allowed to opponents).
yardsgame_defFloat64Yards gained per game, with the team on defense (i.e. allowed to opponents).
drives_defUInt32Offensive drives, with the team on defense (i.e. allowed to opponents).
drivesgame_defFloat64Drives per game, with the team on defense (i.e. allowed to opponents).
yardsdrive_defFloat64Yards gained per drive, with the team on defense (i.e. allowed to opponents).
playsdrive_defFloat64Plays run per drive, with the team on defense (i.e. allowed to opponents).
playsgame_def_rankFloat64National rank of the team's plays run per game with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_def_rankFloat64National rank of the team's total EPA summed over every play with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAgame_def_rankFloat64National rank of the team's EPA per game (total EPA divided by games) with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAplay_def_rankFloat64National rank of the team's EPA per play with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) with the team on defense (i.e. allowed to opponents), where 1 is best.
early_down_EPA_def_rankFloat64National rank of the team's EPA per early-down play with the team on defense (i.e. allowed to opponents), where 1 is best.
success_def_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA with the team on defense (i.e. allowed to opponents), where 1 is best.
yards_def_rankFloat64National rank of the team's total yards gained with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_rankFloat64National rank of the team's yards gained per play with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsgame_def_rankFloat64National rank of the team's yards gained per game with the team on defense (i.e. allowed to opponents), where 1 is best.
drivesgame_def_rankFloat64National rank of the team's drives per game with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_rankFloat64National rank of the team's yards gained per drive with the team on defense (i.e. allowed to opponents), where 1 is best.
playsdrive_def_rankFloat64National rank of the team's plays run per drive with the team on defense (i.e. allowed to opponents), where 1 is best.
play_stuffed_def_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag with the team on defense (i.e. allowed to opponents), where 1 is best.
red_zone_success_def_rankFloat64National rank of the team's success rate on red-zone plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_success_def_rankFloat64National rank of the team's success rate on third-down plays with the team on defense (i.e. allowed to opponents), where 1 is best.
late_down_success_def_rankFloat64National rank of the team's success rate on late-down plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_distance_def_rankFloat64National rank of the team's average yards to go on third down with the team on defense (i.e. allowed to opponents), where 1 is best.
start_position_def_rankFloat64National rank of the team's average drive start position, measured in yards from the opponent goal line with the team on defense (i.e. allowed to opponents), where 1 is best.
havoc_def_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag with the team on defense (i.e. allowed to opponents), where 1 is best.
explosive_def_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag with the team on defense (i.e. allowed to opponents), where 1 is best.
passrate_def_rankFloat64National rank of the team's share of plays that were pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
rushrate_def_rankFloat64National rank of the team's share of plays that were rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
nonExplosiveEpaPerPlay_def_rankFloat64National rank of the team's EPA per play with explosive plays excluded with the team on defense (i.e. allowed to opponents), where 1 is best.
line_yards_def_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes with the team on defense (i.e. allowed to opponents), where 1 is best.
opportunity_rate_def_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_marginFloat64Margin in total EPA summed over every play: the team's offensive value minus the value it allowed on defense.
EPAplay_marginFloat64Margin in EPA per play: the team's offensive value minus the value it allowed on defense.
EPAdrive_marginFloat64Margin in EPA per drive (total EPA divided by drives): the team's offensive value minus the value it allowed on defense.
EPAgame_marginFloat64Margin in EPA per game (total EPA divided by games): the team's offensive value minus the value it allowed on defense.
success_marginFloat64Margin in success rate -- the share of plays flagged as successful by EPA: the team's offensive value minus the value it allowed on defense.
yardsplay_marginFloat64Margin in yards gained per play: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rankFloat64Margin in total EPA summed over every play: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAplay_margin_rankFloat64Margin in EPA per play: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAdrive_margin_rankFloat64Margin in EPA per drive (total EPA divided by drives): the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAgame_margin_rankFloat64Margin in EPA per game (total EPA divided by games): the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
success_margin_rankFloat64Margin in success rate -- the share of plays flagged as successful by EPA: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
yardsplay_margin_rankFloat64Margin in yards gained per play: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
start_position_marginFloat64Field-position margin: the team's own average starting field position minus the average starting field position it allowed, both measured as yards gained from their own goal line. Positive means the team started closer to scoring than its opponents.
start_position_margin_rankFloat64Field-position margin: the team's own average starting field position minus the average starting field position it allowed, both measured as yards gained from their own goal line. Positive means the team started closer to scoring than its opponents. National rank of that margin, 1 = largest.
total_available_yards_offFloat64Available yards are the yards a drive could theoretically gain, summed from each drive's starting distance to the opponent goal line. Total available yards on the team's own drives.
total_gained_yards_offInt64Total yards the team actually gained across its own drives.
available_yards_pct_offFloat64Share of available yards the team's offense actually gained (total_gained_yards_off divided by total_available_yards_off). Higher is better.
available_yards_pct_off_rankFloat64National rank of the team's offensive available-yards share, where 1 is best.
total_available_yards_defFloat64Available yards are the yards a drive could theoretically gain, summed from each drive's starting distance to the opponent goal line. Total available yards on drives the team defended.
total_gained_yards_defInt64Total yards the team allowed across the drives it defended.
available_yards_pct_defFloat64Share of available yards the team's defense allowed opponents to gain. Lower is better.
available_yards_pct_def_rankFloat64National rank of the team's defensive available-yards share, where 1 is best.
total_available_yards_marginFloat64Available yards on the team's own drives minus available yards on drives it defended.
total_gained_yards_marginInt64Yards the team gained minus yards it allowed.
available_yards_pct_marginFloat64Available-yards share gained by the offense minus the share allowed by the defense. Higher is better.
total_available_yards_margin_rankFloat64National rank of total_available_yards_margin, 1 = largest margin.
total_gained_yards_margin_rankFloat64National rank of total_gained_yards_margin, 1 = largest margin.
available_yards_pct_margin_rankFloat64National rank of available_yards_pct_margin, 1 = largest margin.
plays_off_passUInt32Plays run on pass plays, with the team on offense.
passrate_off_passFloat64Share of plays that were pass plays on pass plays, with the team on offense.
rushrate_off_passFloat64Share of plays that were rush plays on pass plays, with the team on offense.
havoc_off_passFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays, with the team on offense.
explosive_off_passFloat64Explosive-play rate -- the share of plays carrying the explosive flag on pass plays, with the team on offense.
TEPA_off_passFloat64Total EPA summed over every play on pass plays, with the team on offense.
EPAplay_off_passFloat64EPA per play on pass plays, with the team on offense.
yards_off_passInt64Total yards gained on pass plays, with the team on offense.
yardsplay_off_passFloat64Yards gained per play on pass plays, with the team on offense.
play_stuffed_off_passFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays, with the team on offense.
success_off_passFloat64Success rate -- the share of plays flagged as successful by EPA on pass plays, with the team on offense.
red_zone_success_off_passFloat64Success rate on red-zone plays on pass plays, with the team on offense.
third_down_success_off_passFloat64Success rate on third-down plays on pass plays, with the team on offense.
third_down_distance_off_passFloat64Average yards to go on third down on pass plays, with the team on offense.
late_down_success_off_passFloat64Success rate on late-down plays on pass plays, with the team on offense.
early_down_EPA_off_passFloat64EPA per early-down play on pass plays, with the team on offense.
nonExplosiveEpaPerPlay_off_passFloat64EPA per play with explosive plays excluded on pass plays, with the team on offense.
line_yards_off_passFloat64Average line yards credited to the offensive line on rushes on pass plays, with the team on offense.
opportunity_rate_off_passFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on offense.
playsgame_off_passFloat64Plays run per game on pass plays, with the team on offense.
EPAdrive_off_passFloat64EPA per drive (total EPA divided by drives) on pass plays, with the team on offense.
EPAgame_off_passFloat64EPA per game (total EPA divided by games) on pass plays, with the team on offense.
yardsgame_off_passFloat64Yards gained per game on pass plays, with the team on offense.
drives_off_passUInt32Offensive drives on pass plays, with the team on offense.
drivesgame_off_passFloat64Drives per game on pass plays, with the team on offense.
yardsdrive_off_passFloat64Yards gained per drive on pass plays, with the team on offense.
playsdrive_off_passFloat64Plays run per drive on pass plays, with the team on offense.
playsgame_off_pass_rankFloat64National rank of the team's plays run per game on pass plays with the team on offense, where 1 is best.
TEPA_off_pass_rankFloat64National rank of the team's total EPA summed over every play on pass plays with the team on offense, where 1 is best.
EPAgame_off_pass_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on pass plays with the team on offense, where 1 is best.
EPAplay_off_pass_rankFloat64National rank of the team's EPA per play on pass plays with the team on offense, where 1 is best.
EPAdrive_off_pass_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on pass plays with the team on offense, where 1 is best.
early_down_EPA_off_pass_rankFloat64National rank of the team's EPA per early-down play on pass plays with the team on offense, where 1 is best.
success_off_pass_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on pass plays with the team on offense, where 1 is best.
yards_off_pass_rankFloat64National rank of the team's total yards gained on pass plays with the team on offense, where 1 is best.
yardsplay_off_pass_rankFloat64National rank of the team's yards gained per play on pass plays with the team on offense, where 1 is best.
yardsgame_off_pass_rankFloat64National rank of the team's yards gained per game on pass plays with the team on offense, where 1 is best.
drivesgame_off_pass_rankFloat64National rank of the team's drives per game on pass plays with the team on offense, where 1 is best.
yardsdrive_off_pass_rankFloat64National rank of the team's yards gained per drive on pass plays with the team on offense, where 1 is best.
playsdrive_off_pass_rankFloat64National rank of the team's plays run per drive on pass plays with the team on offense, where 1 is best.
play_stuffed_off_pass_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays with the team on offense, where 1 is best.
red_zone_success_off_pass_rankFloat64National rank of the team's success rate on red-zone plays on pass plays with the team on offense, where 1 is best.
third_down_success_off_pass_rankFloat64National rank of the team's success rate on third-down plays on pass plays with the team on offense, where 1 is best.
late_down_success_off_pass_rankFloat64National rank of the team's success rate on late-down plays on pass plays with the team on offense, where 1 is best.
third_down_distance_off_pass_rankFloat64National rank of the team's average yards to go on third down on pass plays with the team on offense, where 1 is best.
havoc_off_pass_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays with the team on offense, where 1 is best.
explosive_off_pass_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on pass plays with the team on offense, where 1 is best.
passrate_off_pass_rankFloat64National rank of the team's share of plays that were pass plays on pass plays with the team on offense, where 1 is best.
rushrate_off_pass_rankFloat64National rank of the team's share of plays that were rush plays on pass plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_pass_rankFloat64National rank of the team's EPA per play with explosive plays excluded on pass plays with the team on offense, where 1 is best.
line_yards_off_pass_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on pass plays with the team on offense, where 1 is best.
opportunity_rate_off_pass_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on pass plays with the team on offense, where 1 is best.
plays_def_passUInt32Plays run on pass plays, with the team on defense (i.e. allowed to opponents).
passrate_def_passFloat64Share of plays that were pass plays on pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_passFloat64Share of plays that were rush plays on pass plays, with the team on defense (i.e. allowed to opponents).
havoc_def_passFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays, with the team on defense (i.e. allowed to opponents).
explosive_def_passFloat64Explosive-play rate -- the share of plays carrying the explosive flag on pass plays, with the team on defense (i.e. allowed to opponents).
TEPA_def_passFloat64Total EPA summed over every play on pass plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_passFloat64EPA per play on pass plays, with the team on defense (i.e. allowed to opponents).
yards_def_passInt64Total yards gained on pass plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_passFloat64Yards gained per play on pass plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_passFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays, with the team on defense (i.e. allowed to opponents).
success_def_passFloat64Success rate -- the share of plays flagged as successful by EPA on pass plays, with the team on defense (i.e. allowed to opponents).
red_zone_success_def_passFloat64Success rate on red-zone plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_passFloat64Success rate on third-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_passFloat64Average yards to go on third down on pass plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_passFloat64Success rate on late-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_passFloat64EPA per early-down play on pass plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_passFloat64EPA per play with explosive plays excluded on pass plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_passFloat64Average line yards credited to the offensive line on rushes on pass plays, with the team on defense (i.e. allowed to opponents).
opportunity_rate_def_passFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_passFloat64Plays run per game on pass plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_passFloat64EPA per drive (total EPA divided by drives) on pass plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_passFloat64EPA per game (total EPA divided by games) on pass plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_passFloat64Yards gained per game on pass plays, with the team on defense (i.e. allowed to opponents).
drives_def_passUInt32Offensive drives on pass plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_passFloat64Drives per game on pass plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_passFloat64Yards gained per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_passFloat64Plays run per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_pass_rankFloat64National rank of the team's plays run per game on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_def_pass_rankFloat64National rank of the team's total EPA summed over every play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAgame_def_pass_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAplay_def_pass_rankFloat64National rank of the team's EPA per play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_pass_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
early_down_EPA_def_pass_rankFloat64National rank of the team's EPA per early-down play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
success_def_pass_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yards_def_pass_rankFloat64National rank of the team's total yards gained on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_pass_rankFloat64National rank of the team's yards gained per play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsgame_def_pass_rankFloat64National rank of the team's yards gained per game on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
drivesgame_def_pass_rankFloat64National rank of the team's drives per game on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_pass_rankFloat64National rank of the team's yards gained per drive on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
playsdrive_def_pass_rankFloat64National rank of the team's plays run per drive on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
play_stuffed_def_pass_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
red_zone_success_def_pass_rankFloat64National rank of the team's success rate on red-zone plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_success_def_pass_rankFloat64National rank of the team's success rate on third-down plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
late_down_success_def_pass_rankFloat64National rank of the team's success rate on late-down plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_distance_def_pass_rankFloat64National rank of the team's average yards to go on third down on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
havoc_def_pass_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
explosive_def_pass_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
passrate_def_pass_rankFloat64National rank of the team's share of plays that were pass plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
rushrate_def_pass_rankFloat64National rank of the team's share of plays that were rush plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
nonExplosiveEpaPerPlay_def_pass_rankFloat64National rank of the team's EPA per play with explosive plays excluded on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
line_yards_def_pass_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
opportunity_rate_def_pass_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_margin_passFloat64Margin in total EPA summed over every play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_passFloat64Margin in EPA per play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_passFloat64Margin in EPA per drive (total EPA divided by drives) on pass plays: the team's offensive value minus the value it allowed on defense.
EPAgame_margin_passFloat64Margin in EPA per game (total EPA divided by games) on pass plays: the team's offensive value minus the value it allowed on defense.
success_margin_passFloat64Margin in success rate -- the share of plays flagged as successful by EPA on pass plays: the team's offensive value minus the value it allowed on defense.
yardsplay_margin_passFloat64Margin in yards gained per play on pass plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_pass_rankFloat64Margin in total EPA summed over every play on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAplay_margin_pass_rankFloat64Margin in EPA per play on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAdrive_margin_pass_rankFloat64Margin in EPA per drive (total EPA divided by drives) on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAgame_margin_pass_rankFloat64Margin in EPA per game (total EPA divided by games) on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
success_margin_pass_rankFloat64Margin in success rate -- the share of plays flagged as successful by EPA on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
yardsplay_margin_pass_rankFloat64Margin in yards gained per play on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
plays_off_rushUInt32Plays run on rush plays, with the team on offense.
passrate_off_rushFloat64Share of plays that were pass plays on rush plays, with the team on offense.
rushrate_off_rushFloat64Share of plays that were rush plays on rush plays, with the team on offense.
havoc_off_rushFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays, with the team on offense.
explosive_off_rushFloat64Explosive-play rate -- the share of plays carrying the explosive flag on rush plays, with the team on offense.
TEPA_off_rushFloat64Total EPA summed over every play on rush plays, with the team on offense.
EPAplay_off_rushFloat64EPA per play on rush plays, with the team on offense.
yards_off_rushInt64Total yards gained on rush plays, with the team on offense.
yardsplay_off_rushFloat64Yards gained per play on rush plays, with the team on offense.
play_stuffed_off_rushFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays, with the team on offense.
success_off_rushFloat64Success rate -- the share of plays flagged as successful by EPA on rush plays, with the team on offense.
red_zone_success_off_rushFloat64Success rate on red-zone plays on rush plays, with the team on offense.
third_down_success_off_rushFloat64Success rate on third-down plays on rush plays, with the team on offense.
third_down_distance_off_rushFloat64Average yards to go on third down on rush plays, with the team on offense.
late_down_success_off_rushFloat64Success rate on late-down plays on rush plays, with the team on offense.
early_down_EPA_off_rushFloat64EPA per early-down play on rush plays, with the team on offense.
nonExplosiveEpaPerPlay_off_rushFloat64EPA per play with explosive plays excluded on rush plays, with the team on offense.
line_yards_off_rushFloat64Average line yards credited to the offensive line on rushes on rush plays, with the team on offense.
opportunity_rate_off_rushFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on offense.
playsgame_off_rushFloat64Plays run per game on rush plays, with the team on offense.
EPAdrive_off_rushFloat64EPA per drive (total EPA divided by drives) on rush plays, with the team on offense.
EPAgame_off_rushFloat64EPA per game (total EPA divided by games) on rush plays, with the team on offense.
yardsgame_off_rushFloat64Yards gained per game on rush plays, with the team on offense.
drives_off_rushUInt32Offensive drives on rush plays, with the team on offense.
drivesgame_off_rushFloat64Drives per game on rush plays, with the team on offense.
yardsdrive_off_rushFloat64Yards gained per drive on rush plays, with the team on offense.
playsdrive_off_rushFloat64Plays run per drive on rush plays, with the team on offense.
playsgame_off_rush_rankFloat64National rank of the team's plays run per game on rush plays with the team on offense, where 1 is best.
TEPA_off_rush_rankFloat64National rank of the team's total EPA summed over every play on rush plays with the team on offense, where 1 is best.
EPAgame_off_rush_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on rush plays with the team on offense, where 1 is best.
EPAplay_off_rush_rankFloat64National rank of the team's EPA per play on rush plays with the team on offense, where 1 is best.
EPAdrive_off_rush_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on rush plays with the team on offense, where 1 is best.
early_down_EPA_off_rush_rankFloat64National rank of the team's EPA per early-down play on rush plays with the team on offense, where 1 is best.
success_off_rush_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on rush plays with the team on offense, where 1 is best.
yards_off_rush_rankFloat64National rank of the team's total yards gained on rush plays with the team on offense, where 1 is best.
yardsplay_off_rush_rankFloat64National rank of the team's yards gained per play on rush plays with the team on offense, where 1 is best.
yardsgame_off_rush_rankFloat64National rank of the team's yards gained per game on rush plays with the team on offense, where 1 is best.
drivesgame_off_rush_rankFloat64National rank of the team's drives per game on rush plays with the team on offense, where 1 is best.
yardsdrive_off_rush_rankFloat64National rank of the team's yards gained per drive on rush plays with the team on offense, where 1 is best.
playsdrive_off_rush_rankFloat64National rank of the team's plays run per drive on rush plays with the team on offense, where 1 is best.
play_stuffed_off_rush_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays with the team on offense, where 1 is best.
red_zone_success_off_rush_rankFloat64National rank of the team's success rate on red-zone plays on rush plays with the team on offense, where 1 is best.
third_down_success_off_rush_rankFloat64National rank of the team's success rate on third-down plays on rush plays with the team on offense, where 1 is best.
late_down_success_off_rush_rankFloat64National rank of the team's success rate on late-down plays on rush plays with the team on offense, where 1 is best.
third_down_distance_off_rush_rankFloat64National rank of the team's average yards to go on third down on rush plays with the team on offense, where 1 is best.
havoc_off_rush_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays with the team on offense, where 1 is best.
explosive_off_rush_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on rush plays with the team on offense, where 1 is best.
passrate_off_rush_rankFloat64National rank of the team's share of plays that were pass plays on rush plays with the team on offense, where 1 is best.
rushrate_off_rush_rankFloat64National rank of the team's share of plays that were rush plays on rush plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_rush_rankFloat64National rank of the team's EPA per play with explosive plays excluded on rush plays with the team on offense, where 1 is best.
line_yards_off_rush_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on rush plays with the team on offense, where 1 is best.
opportunity_rate_off_rush_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on rush plays with the team on offense, where 1 is best.
plays_def_rushUInt32Plays run on rush plays, with the team on defense (i.e. allowed to opponents).
passrate_def_rushFloat64Share of plays that were pass plays on rush plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_rushFloat64Share of plays that were rush plays on rush plays, with the team on defense (i.e. allowed to opponents).
havoc_def_rushFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays, with the team on defense (i.e. allowed to opponents).
explosive_def_rushFloat64Explosive-play rate -- the share of plays carrying the explosive flag on rush plays, with the team on defense (i.e. allowed to opponents).
TEPA_def_rushFloat64Total EPA summed over every play on rush plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_rushFloat64EPA per play on rush plays, with the team on defense (i.e. allowed to opponents).
yards_def_rushInt64Total yards gained on rush plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_rushFloat64Yards gained per play on rush plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_rushFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays, with the team on defense (i.e. allowed to opponents).
success_def_rushFloat64Success rate -- the share of plays flagged as successful by EPA on rush plays, with the team on defense (i.e. allowed to opponents).
red_zone_success_def_rushFloat64Success rate on red-zone plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_rushFloat64Success rate on third-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_rushFloat64Average yards to go on third down on rush plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_rushFloat64Success rate on late-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_rushFloat64EPA per early-down play on rush plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_rushFloat64EPA per play with explosive plays excluded on rush plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_rushFloat64Average line yards credited to the offensive line on rushes on rush plays, with the team on defense (i.e. allowed to opponents).
opportunity_rate_def_rushFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rushFloat64Plays run per game on rush plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_rushFloat64EPA per drive (total EPA divided by drives) on rush plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_rushFloat64EPA per game (total EPA divided by games) on rush plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_rushFloat64Yards gained per game on rush plays, with the team on defense (i.e. allowed to opponents).
drives_def_rushUInt32Offensive drives on rush plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_rushFloat64Drives per game on rush plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_rushFloat64Yards gained per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_rushFloat64Plays run per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rush_rankFloat64National rank of the team's plays run per game on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_def_rush_rankFloat64National rank of the team's total EPA summed over every play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAgame_def_rush_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAplay_def_rush_rankFloat64National rank of the team's EPA per play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_rush_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
early_down_EPA_def_rush_rankFloat64National rank of the team's EPA per early-down play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
success_def_rush_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yards_def_rush_rankFloat64National rank of the team's total yards gained on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_rush_rankFloat64National rank of the team's yards gained per play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsgame_def_rush_rankFloat64National rank of the team's yards gained per game on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
drivesgame_def_rush_rankFloat64National rank of the team's drives per game on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_rush_rankFloat64National rank of the team's yards gained per drive on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
playsdrive_def_rush_rankFloat64National rank of the team's plays run per drive on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
play_stuffed_def_rush_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
red_zone_success_def_rush_rankFloat64National rank of the team's success rate on red-zone plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_success_def_rush_rankFloat64National rank of the team's success rate on third-down plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
late_down_success_def_rush_rankFloat64National rank of the team's success rate on late-down plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_distance_def_rush_rankFloat64National rank of the team's average yards to go on third down on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
havoc_def_rush_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
explosive_def_rush_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
passrate_def_rush_rankFloat64National rank of the team's share of plays that were pass plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
rushrate_def_rush_rankFloat64National rank of the team's share of plays that were rush plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
nonExplosiveEpaPerPlay_def_rush_rankFloat64National rank of the team's EPA per play with explosive plays excluded on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
line_yards_def_rush_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
opportunity_rate_def_rush_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_margin_rushFloat64Margin in total EPA summed over every play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_rushFloat64Margin in EPA per play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_rushFloat64Margin in EPA per drive (total EPA divided by drives) on rush plays: the team's offensive value minus the value it allowed on defense.
EPAgame_margin_rushFloat64Margin in EPA per game (total EPA divided by games) on rush plays: the team's offensive value minus the value it allowed on defense.
success_margin_rushFloat64Margin in success rate -- the share of plays flagged as successful by EPA on rush plays: the team's offensive value minus the value it allowed on defense.
yardsplay_margin_rushFloat64Margin in yards gained per play on rush plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rush_rankFloat64Margin in total EPA summed over every play on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAplay_margin_rush_rankFloat64Margin in EPA per play on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAdrive_margin_rush_rankFloat64Margin in EPA per drive (total EPA divided by drives) on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAgame_margin_rush_rankFloat64Margin in EPA per game (total EPA divided by games) on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
success_margin_rush_rankFloat64Margin in success rate -- the share of plays flagged as successful by EPA on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
yardsplay_margin_rush_rankFloat64Margin in yards gained per play on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
fbs_classStringPower/Group classification for the season: P4 or G6 from 2024 on, P5 or G5 through 2023, derived from conference membership (Notre Dame is classified with the power group). Null for teams outside FBS.
valid_gamesUInt32Number of the team's games that produced both an offensive and a defensive adjusted-EPA value; teams below two valid games are dropped from the adjusted ratings.
adj_off_epaFloat64Offensive opponent-adjusted EPA per play from the ridge (RAPM-style) regression on offense/defense team indicators plus home field -- cfbfastR's adjust_epa adjustment, fit in-sample across the season, so the value is descriptive of that window rather than predictive.
adj_def_epaFloat64Defensive opponent-adjusted EPA per play from the ridge (RAPM-style) regression on offense/defense team indicators plus home field -- cfbfastR's adjust_epa adjustment, fit in-sample across the season, so the value is descriptive of that window rather than predictive. Lower is better -- it is EPA allowed.
off_strength_facedFloat64Average opponent-defense strength the team's offense faced, taken as the mean of the ridge's defensive coefficients across its opponents. Higher means a tougher slate.
def_strength_facedFloat64Average opponent-offense strength the team's defense faced, taken as the mean of the ridge's offensive coefficients across its opponents. Higher means a tougher slate.
net_adj_epaFloat64Net opponent-adjusted EPA per play: adj_off_epa minus adj_def_epa. Higher is better.
adj_off_epa_rankFloat64National rank of the team's adj_off_epa, where 1 is best.
adj_def_epa_rankFloat64National rank of the team's adj_def_epa, where 1 is best (fewest EPA allowed).
net_adj_epa_rankFloat64National rank of the team's net_adj_epa, 1 = largest net adjusted EPA.
load_cfb_team_summaries(seasons=2024)

load_cfb_adv_team_gamelog

Release: espn_cfb_adv_team_gamelog · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_cfb_adv_team_gamelog/adv_team_gamelog_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
weekInt64Game week of the season.
season_typeInt32ESPN season type (2 = regular, 3 = postseason).
game_idInt64ESPN game identifier.
start_dateStringSeason start timestamp (ISO 8601, UTC).
team_idInt64ESPN team id.
teamStringTeam name.
opponent_idInt64ESPN team id of the opponent.
opponentStringOpponent team name.
is_homeBooleanWhether the subject team was the home team.
neutral_siteBooleanTRUE/FALSE flag for if the game took place at a neutral site.
points_forInt64Goals/points scored.
points_againstInt64Points allowed.
marginInt64Final scoring margin from this team's perspective, exactly points_for minus points_against.
winBooleanWhether the game was a win (goalie).
rushing_highlight_yards_per_oppFloat64Highlight yards per rushing opportunity.
total_pen_yardsInt64Total penalty yards assessed.
EPA_penaltyFloat64Total EPA attributed to penalties.
penalty_first_downs_createdInt64Number of first downs the team gained via opponent penalty.
penalty_first_downs_created_rateFloat64Share of the team's first downs that came via opponent penalty.
penaltiesInt64Number of penalties assessed against the team.
penalty_yardsInt64Net penalty yardage assessed against the team; can be negative when enforcement moved the team forward on balance.
special_teams_playsInt64Number of special-teams plays.
EPA_spFloat64Total special-teams EPA, ESPN's abbreviated field for the same phase.
EPA_special_teamsFloat64Total EPA generated on special-teams plays.
field_goalsInt64Number of field-goal attempts.
EPA_fgFloat64Total EPA on field-goal attempts.
punt_playsInt64Number of punt plays.
EPA_puntFloat64Total EPA on punt plays.
kickoff_playsInt64Number of kickoff plays.
EPA_kickoffFloat64Total EPA on kickoff plays.
rushesInt64Number of rushing attempts.
rush_yardsFloat64Total yards the team gained on rush plays.
yards_per_rushFloat64Yards gained per rushing attempt.
rushing_power_rateFloat64Share of carries that were power rushing attempts.
rushing_first_downs_createdInt64Number of first downs created on rush plays.
rushing_first_downs_created_rateFloat64Share of rush plays that created a first down.
EPA_rushing_overallFloat64Total EPA on rush plays.
EPA_rushing_per_playFloat64EPA per rush play.
EPA_explosive_rushingInt64Count of explosive rush plays. A play count, not an EPA total.
EPA_explosive_rushing_rateFloat64Explosive-play rate on rush plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_rushingFloat64Total EPA on rush plays with explosive plays excluded.
EPA_non_explosive_rushing_per_playFloat64EPA per rush play with explosive plays excluded.
passesInt64Number of pass plays the team ran.
pass_yardsFloat64Total yards the team gained on pass plays.
yards_per_passFloat64Team game yards per pass.
passing_first_downs_createdInt64Number of first downs created on pass plays.
passing_first_downs_created_rateFloat64Share of pass plays that created a first down.
EPA_passing_overallFloat64Total EPA on pass plays.
EPA_passing_per_playFloat64EPA per pass play.
EPA_explosive_passingInt64Count of explosive pass plays. A play count, not an EPA total.
EPA_explosive_passing_rateFloat64Explosive-play rate on pass plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_passingFloat64Total EPA on pass plays with explosive plays excluded.
EPA_non_explosive_passing_per_playFloat64EPA per pass play with explosive plays excluded.
scrimmage_playsInt64Number of plays from scrimmage (rushes plus passes), excluding special teams.
EPA_overall_offFloat64Total offensive EPA for the team. Duplicated exactly by EPA_overall_offense in every published season checked -- prefer one and ignore the other.
EPA_overall_offenseFloat64Total offensive EPA. An exact duplicate of EPA_overall_off.
EPA_per_playFloat64Offensive EPA per play.
EPA_non_explosiveFloat64Total EPA with explosive plays excluded, isolating the team's routine-down production.
EPA_non_explosive_per_playFloat64EPA per play with explosive plays excluded.
EPA_explosiveInt64Count of explosive plays, per ESPN's advanced box score. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_explosive_rateFloat64Explosive-play rate. Note this is NOT EPA_explosive divided by EPA_plays -- ESPN divides by its own smaller qualifying-play count, so deriving it yourself will not reproduce this value.
passes_rateFloat64Share of the team's plays from scrimmage that were pass plays.
off_yardsInt64Offensive yards gained from scrimmage.
total_off_yardsInt64Total offensive yards across all plays.
yards_per_playFloat64Yards gained per play.
EPA_playsInt64Number of plays ESPN's advanced box score scored for the team.
total_yardsInt64Total yards the team gained across all plays.
EPA_overall_totalFloat64Total EPA across all phases, which is why it differs from the offense-only EPA_overall_off.
rushes_rateFloat64Share of the team's plays from scrimmage that were rush plays.
first_downs_createdInt64Number of first downs the team created.
first_downs_created_rateFloat64Share of the team's plays that created a first down.
EPA_rushing_powerFloat64Total EPA on power rushing situations, as classified by ESPN's advanced box score.
EPA_rushing_power_per_playFloat64EPA per play on power rushing situations.
rushing_power_successInt64Count of power rushing attempts that gained the yardage needed. An integer count, not a rate -- the rate is published separately as rushing_power_success_rate.
rushing_power_success_rateFloat64Share of power rushing attempts that succeeded.
rushing_powerInt64Count of power rushing attempts, in short-yardage situations as classified by ESPN's advanced box score.
rushing_stuffInt64Count of stuffed rushing attempts.
rushing_stuff_rateFloat64Share of the team's carries that were stuffed at or behind the line of scrimmage.
rushing_stoppedInt64Count of rushing attempts stopped at or behind the line of scrimmage.
rushing_stopped_rateFloat64Share of carries stopped at or behind the line of scrimmage.
rushing_opportunityInt64Count of rushing opportunities -- carries that reached ESPN's opportunity threshold.
rushing_opportunity_rateFloat64Share of carries that qualified as rushing opportunities.
rushing_highlightInt64Highlight yards -- rushing yardage credited to the back rather than the offensive line.
rushing_highlight_rateFloat64Share of rushing yardage that was highlight (back-credited) yardage.
rushing_highlight_yardsFloat64Total highlight yards the team accumulated -- the yardage credited to ball carriers rather than the line. The per-carry figure is rushing_highlight_yards_per_opp.
line_yardsFloat64Line yards -- the portion of rushing yardage credited to the offensive line under the standard rushing decomposition. ESPN applies its own qualifying threshold for the yardage split.
line_yards_per_carryFloat64Line yards per rushing attempt.
second_level_yardsFloat64Second-level yards -- rushing yardage earned just beyond the line of scrimmage.
open_field_yardsFloat64Open-field yards -- rushing yardage earned well downfield, past the second level.
load_cfb_adv_team_gamelog(seasons=2024)

load_cfb_ratings_weekly

Release: cfb_ratings_weekly · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_ratings_weekly/cfb_ratings_weekly_{season}.parquet

Returns

col_nametypedescription
seasonInt64Season (4-digit year).
team_idInt64ESPN team id.
adj_off_epaFloat64Opponent-adjusted offensive EPA per play as of the snapshot week: raw per-game EPA on pass and rush plays net of each opponent's ridge-fitted defensive strength.
adj_def_epaFloat64Opponent-adjusted EPA per play allowed as of the snapshot week, netted the same way as the offensive rating, so lower is better.
adj_st_epaFloat64Special-teams composite in EPA units as of the snapshot week, summing the league-centered per-play EPA of the field goal, punt, and kick-return units.
adj_netFloat64adj_off_epa minus adj_def_epa at the snapshot week, the team's overall efficiency rating in EPA per play with special teams excluded.
fei_offFloat64Drive-level offensive rating at the snapshot week, from a ridge fit on per-drive EPA.
fei_defFloat64Drive-level defensive rating at the snapshot week, from the same per-drive ridge fit and on the same scale as fei_off.
fei_netFloat64fei_off minus fei_def at the snapshot week, the team's overall drive-efficiency rating.
gamesInt64Number of games included in the ATS summary.
off_paceFloat64Scrimmage plays per game through the snapshot week, the tempo input consumed by the totals model.
off_rankInt64Dense rank of adj_off_epa in descending order within the snapshot week, so rank 1 is the most efficient offense at that point.
def_rankInt64Dense rank of adj_def_epa in ascending order within the snapshot week, so rank 1 is the stingiest defense at that point.
net_rankInt64Dense rank of adj_net in descending order within the snapshot week, so rank 1 is the strongest overall team at that point.
net_zFloat64adj_net restated as a z-score against the mean and standard deviation of adj_net across the teams rated in that snapshot week.
through_weekInt32Regular-season week the snapshot runs through; the ratings were refit using only games kicking off on or before that week's final kickoff date.
load_cfb_ratings_weekly(seasons=2024)

load_cfb_team_summaries_weekly

Release: cfb_team_summaries_weekly · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfb_team_summaries_weekly/cfb_team_summaries_weekly_{season}.parquet

Returns

col_nametypedescription
team_idInt64ESPN team id.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
divisionStringDivision in the conference for the team.
conferenceStringConference of the team.
seasonInt64Season (4-digit year).
plays_offUInt32Plays run, with the team on offense.
passrate_offFloat64Share of plays that were pass plays, with the team on offense.
rushrate_offFloat64Share of plays that were rush plays, with the team on offense.
havoc_offFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on offense.
explosive_offFloat64Explosive-play rate -- the share of plays carrying the explosive flag, with the team on offense.
TEPA_offFloat64Total EPA summed over every play, with the team on offense.
EPAplay_offFloat64EPA per play, with the team on offense.
yards_offInt64Total yards gained, with the team on offense.
yardsplay_offFloat64Yards gained per play, with the team on offense.
play_stuffed_offFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on offense.
success_offFloat64Success rate -- the share of plays flagged as successful by EPA, with the team on offense.
red_zone_success_offFloat64Success rate on red-zone plays, with the team on offense.
third_down_success_offFloat64Success rate on third-down plays, with the team on offense.
third_down_distance_offFloat64Average yards to go on third down, with the team on offense.
late_down_success_offFloat64Success rate on late-down plays, with the team on offense.
early_down_EPA_offFloat64EPA per early-down play, with the team on offense.
start_position_offFloat64Average drive start position, measured in yards from the opponent goal line, with the team on offense.
nonExplosiveEpaPerPlay_offFloat64EPA per play with explosive plays excluded, with the team on offense.
line_yards_offFloat64Average line yards credited to the offensive line on rushes, with the team on offense.
opportunity_rate_offFloat64Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on offense.
playsgame_offFloat64Plays run per game, with the team on offense.
EPAdrive_offFloat64EPA per drive (total EPA divided by drives), with the team on offense.
EPAgame_offFloat64EPA per game (total EPA divided by games), with the team on offense.
yardsgame_offFloat64Yards gained per game, with the team on offense.
drives_offUInt32Offensive drives, with the team on offense.
drivesgame_offFloat64Drives per game, with the team on offense.
yardsdrive_offFloat64Yards gained per drive, with the team on offense.
playsdrive_offFloat64Plays run per drive, with the team on offense.
playsgame_off_rankFloat64National rank of the team's plays run per game with the team on offense, where 1 is best.
TEPA_off_rankFloat64National rank of the team's total EPA summed over every play with the team on offense, where 1 is best.
EPAgame_off_rankFloat64National rank of the team's EPA per game (total EPA divided by games) with the team on offense, where 1 is best.
EPAplay_off_rankFloat64National rank of the team's EPA per play with the team on offense, where 1 is best.
EPAdrive_off_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) with the team on offense, where 1 is best.
early_down_EPA_off_rankFloat64National rank of the team's EPA per early-down play with the team on offense, where 1 is best.
success_off_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA with the team on offense, where 1 is best.
yards_off_rankFloat64National rank of the team's total yards gained with the team on offense, where 1 is best.
yardsplay_off_rankFloat64National rank of the team's yards gained per play with the team on offense, where 1 is best.
yardsgame_off_rankFloat64National rank of the team's yards gained per game with the team on offense, where 1 is best.
drivesgame_off_rankFloat64National rank of the team's drives per game with the team on offense, where 1 is best.
yardsdrive_off_rankFloat64National rank of the team's yards gained per drive with the team on offense, where 1 is best.
playsdrive_off_rankFloat64National rank of the team's plays run per drive with the team on offense, where 1 is best.
play_stuffed_off_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag with the team on offense, where 1 is best.
red_zone_success_off_rankFloat64National rank of the team's success rate on red-zone plays with the team on offense, where 1 is best.
third_down_success_off_rankFloat64National rank of the team's success rate on third-down plays with the team on offense, where 1 is best.
late_down_success_off_rankFloat64National rank of the team's success rate on late-down plays with the team on offense, where 1 is best.
third_down_distance_off_rankFloat64National rank of the team's average yards to go on third down with the team on offense, where 1 is best.
start_position_off_rankFloat64National rank of the team's average drive start position, measured in yards from the opponent goal line with the team on offense, where 1 is best.
havoc_off_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag with the team on offense, where 1 is best.
explosive_off_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag with the team on offense, where 1 is best.
passrate_off_rankFloat64National rank of the team's share of plays that were pass plays with the team on offense, where 1 is best.
rushrate_off_rankFloat64National rank of the team's share of plays that were rush plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_rankFloat64National rank of the team's EPA per play with explosive plays excluded with the team on offense, where 1 is best.
line_yards_off_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes with the team on offense, where 1 is best.
opportunity_rate_off_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag with the team on offense, where 1 is best.
plays_defUInt32Plays run, with the team on defense (i.e. allowed to opponents).
passrate_defFloat64Share of plays that were pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_defFloat64Share of plays that were rush plays, with the team on defense (i.e. allowed to opponents).
havoc_defFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on defense (i.e. allowed to opponents).
explosive_defFloat64Explosive-play rate -- the share of plays carrying the explosive flag, with the team on defense (i.e. allowed to opponents).
TEPA_defFloat64Total EPA summed over every play, with the team on defense (i.e. allowed to opponents).
EPAplay_defFloat64EPA per play, with the team on defense (i.e. allowed to opponents).
yards_defInt64Total yards gained, with the team on defense (i.e. allowed to opponents).
yardsplay_defFloat64Yards gained per play, with the team on defense (i.e. allowed to opponents).
play_stuffed_defFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on defense (i.e. allowed to opponents).
success_defFloat64Success rate -- the share of plays flagged as successful by EPA, with the team on defense (i.e. allowed to opponents).
red_zone_success_defFloat64Success rate on red-zone plays, with the team on defense (i.e. allowed to opponents).
third_down_success_defFloat64Success rate on third-down plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_defFloat64Average yards to go on third down, with the team on defense (i.e. allowed to opponents).
late_down_success_defFloat64Success rate on late-down plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_defFloat64EPA per early-down play, with the team on defense (i.e. allowed to opponents).
start_position_defFloat64Average drive start position, measured in yards from the opponent goal line, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_defFloat64EPA per play with explosive plays excluded, with the team on defense (i.e. allowed to opponents).
line_yards_defFloat64Average line yards credited to the offensive line on rushes, with the team on defense (i.e. allowed to opponents).
opportunity_rate_defFloat64Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on defense (i.e. allowed to opponents).
playsgame_defFloat64Plays run per game, with the team on defense (i.e. allowed to opponents).
EPAdrive_defFloat64EPA per drive (total EPA divided by drives), with the team on defense (i.e. allowed to opponents).
EPAgame_defFloat64EPA per game (total EPA divided by games), with the team on defense (i.e. allowed to opponents).
yardsgame_defFloat64Yards gained per game, with the team on defense (i.e. allowed to opponents).
drives_defUInt32Offensive drives, with the team on defense (i.e. allowed to opponents).
drivesgame_defFloat64Drives per game, with the team on defense (i.e. allowed to opponents).
yardsdrive_defFloat64Yards gained per drive, with the team on defense (i.e. allowed to opponents).
playsdrive_defFloat64Plays run per drive, with the team on defense (i.e. allowed to opponents).
playsgame_def_rankFloat64National rank of the team's plays run per game with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_def_rankFloat64National rank of the team's total EPA summed over every play with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAgame_def_rankFloat64National rank of the team's EPA per game (total EPA divided by games) with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAplay_def_rankFloat64National rank of the team's EPA per play with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) with the team on defense (i.e. allowed to opponents), where 1 is best.
early_down_EPA_def_rankFloat64National rank of the team's EPA per early-down play with the team on defense (i.e. allowed to opponents), where 1 is best.
success_def_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA with the team on defense (i.e. allowed to opponents), where 1 is best.
yards_def_rankFloat64National rank of the team's total yards gained with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_rankFloat64National rank of the team's yards gained per play with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsgame_def_rankFloat64National rank of the team's yards gained per game with the team on defense (i.e. allowed to opponents), where 1 is best.
drivesgame_def_rankFloat64National rank of the team's drives per game with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_rankFloat64National rank of the team's yards gained per drive with the team on defense (i.e. allowed to opponents), where 1 is best.
playsdrive_def_rankFloat64National rank of the team's plays run per drive with the team on defense (i.e. allowed to opponents), where 1 is best.
play_stuffed_def_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag with the team on defense (i.e. allowed to opponents), where 1 is best.
red_zone_success_def_rankFloat64National rank of the team's success rate on red-zone plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_success_def_rankFloat64National rank of the team's success rate on third-down plays with the team on defense (i.e. allowed to opponents), where 1 is best.
late_down_success_def_rankFloat64National rank of the team's success rate on late-down plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_distance_def_rankFloat64National rank of the team's average yards to go on third down with the team on defense (i.e. allowed to opponents), where 1 is best.
start_position_def_rankFloat64National rank of the team's average drive start position, measured in yards from the opponent goal line with the team on defense (i.e. allowed to opponents), where 1 is best.
havoc_def_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag with the team on defense (i.e. allowed to opponents), where 1 is best.
explosive_def_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag with the team on defense (i.e. allowed to opponents), where 1 is best.
passrate_def_rankFloat64National rank of the team's share of plays that were pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
rushrate_def_rankFloat64National rank of the team's share of plays that were rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
nonExplosiveEpaPerPlay_def_rankFloat64National rank of the team's EPA per play with explosive plays excluded with the team on defense (i.e. allowed to opponents), where 1 is best.
line_yards_def_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes with the team on defense (i.e. allowed to opponents), where 1 is best.
opportunity_rate_def_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_marginFloat64Margin in total EPA summed over every play: the team's offensive value minus the value it allowed on defense.
EPAplay_marginFloat64Margin in EPA per play: the team's offensive value minus the value it allowed on defense.
EPAdrive_marginFloat64Margin in EPA per drive (total EPA divided by drives): the team's offensive value minus the value it allowed on defense.
EPAgame_marginFloat64Margin in EPA per game (total EPA divided by games): the team's offensive value minus the value it allowed on defense.
success_marginFloat64Margin in success rate -- the share of plays flagged as successful by EPA: the team's offensive value minus the value it allowed on defense.
yardsplay_marginFloat64Margin in yards gained per play: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rankFloat64Margin in total EPA summed over every play: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAplay_margin_rankFloat64Margin in EPA per play: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAdrive_margin_rankFloat64Margin in EPA per drive (total EPA divided by drives): the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAgame_margin_rankFloat64Margin in EPA per game (total EPA divided by games): the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
success_margin_rankFloat64Margin in success rate -- the share of plays flagged as successful by EPA: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
yardsplay_margin_rankFloat64Margin in yards gained per play: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
start_position_marginFloat64Field-position margin: the team's own average starting field position minus the average starting field position it allowed, both measured as yards gained from their own goal line. Positive means the team started closer to scoring than its opponents.
start_position_margin_rankFloat64Field-position margin: the team's own average starting field position minus the average starting field position it allowed, both measured as yards gained from their own goal line. Positive means the team started closer to scoring than its opponents. National rank of that margin, 1 = largest.
total_available_yards_offFloat64Available yards are the yards a drive could theoretically gain, summed from each drive's starting distance to the opponent goal line. Total available yards on the team's own drives.
total_gained_yards_offInt64Total yards the team actually gained across its own drives.
available_yards_pct_offFloat64Share of available yards the team's offense actually gained (total_gained_yards_off divided by total_available_yards_off). Higher is better.
available_yards_pct_off_rankFloat64National rank of the team's offensive available-yards share, where 1 is best.
total_available_yards_defFloat64Available yards are the yards a drive could theoretically gain, summed from each drive's starting distance to the opponent goal line. Total available yards on drives the team defended.
total_gained_yards_defInt64Total yards the team allowed across the drives it defended.
available_yards_pct_defFloat64Share of available yards the team's defense allowed opponents to gain. Lower is better.
available_yards_pct_def_rankFloat64National rank of the team's defensive available-yards share, where 1 is best.
total_available_yards_marginFloat64Available yards on the team's own drives minus available yards on drives it defended.
total_gained_yards_marginInt64Yards the team gained minus yards it allowed.
available_yards_pct_marginFloat64Available-yards share gained by the offense minus the share allowed by the defense. Higher is better.
total_available_yards_margin_rankFloat64National rank of total_available_yards_margin, 1 = largest margin.
total_gained_yards_margin_rankFloat64National rank of total_gained_yards_margin, 1 = largest margin.
available_yards_pct_margin_rankFloat64National rank of available_yards_pct_margin, 1 = largest margin.
plays_off_passUInt32Plays run on pass plays, with the team on offense.
passrate_off_passFloat64Share of plays that were pass plays on pass plays, with the team on offense.
rushrate_off_passFloat64Share of plays that were rush plays on pass plays, with the team on offense.
havoc_off_passFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays, with the team on offense.
explosive_off_passFloat64Explosive-play rate -- the share of plays carrying the explosive flag on pass plays, with the team on offense.
TEPA_off_passFloat64Total EPA summed over every play on pass plays, with the team on offense.
EPAplay_off_passFloat64EPA per play on pass plays, with the team on offense.
yards_off_passInt64Total yards gained on pass plays, with the team on offense.
yardsplay_off_passFloat64Yards gained per play on pass plays, with the team on offense.
play_stuffed_off_passFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays, with the team on offense.
success_off_passFloat64Success rate -- the share of plays flagged as successful by EPA on pass plays, with the team on offense.
red_zone_success_off_passFloat64Success rate on red-zone plays on pass plays, with the team on offense.
third_down_success_off_passFloat64Success rate on third-down plays on pass plays, with the team on offense.
third_down_distance_off_passFloat64Average yards to go on third down on pass plays, with the team on offense.
late_down_success_off_passFloat64Success rate on late-down plays on pass plays, with the team on offense.
early_down_EPA_off_passFloat64EPA per early-down play on pass plays, with the team on offense.
nonExplosiveEpaPerPlay_off_passFloat64EPA per play with explosive plays excluded on pass plays, with the team on offense.
line_yards_off_passFloat64Average line yards credited to the offensive line on rushes on pass plays, with the team on offense.
opportunity_rate_off_passFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on offense.
playsgame_off_passFloat64Plays run per game on pass plays, with the team on offense.
EPAdrive_off_passFloat64EPA per drive (total EPA divided by drives) on pass plays, with the team on offense.
EPAgame_off_passFloat64EPA per game (total EPA divided by games) on pass plays, with the team on offense.
yardsgame_off_passFloat64Yards gained per game on pass plays, with the team on offense.
drives_off_passUInt32Offensive drives on pass plays, with the team on offense.
drivesgame_off_passFloat64Drives per game on pass plays, with the team on offense.
yardsdrive_off_passFloat64Yards gained per drive on pass plays, with the team on offense.
playsdrive_off_passFloat64Plays run per drive on pass plays, with the team on offense.
playsgame_off_pass_rankFloat64National rank of the team's plays run per game on pass plays with the team on offense, where 1 is best.
TEPA_off_pass_rankFloat64National rank of the team's total EPA summed over every play on pass plays with the team on offense, where 1 is best.
EPAgame_off_pass_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on pass plays with the team on offense, where 1 is best.
EPAplay_off_pass_rankFloat64National rank of the team's EPA per play on pass plays with the team on offense, where 1 is best.
EPAdrive_off_pass_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on pass plays with the team on offense, where 1 is best.
early_down_EPA_off_pass_rankFloat64National rank of the team's EPA per early-down play on pass plays with the team on offense, where 1 is best.
success_off_pass_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on pass plays with the team on offense, where 1 is best.
yards_off_pass_rankFloat64National rank of the team's total yards gained on pass plays with the team on offense, where 1 is best.
yardsplay_off_pass_rankFloat64National rank of the team's yards gained per play on pass plays with the team on offense, where 1 is best.
yardsgame_off_pass_rankFloat64National rank of the team's yards gained per game on pass plays with the team on offense, where 1 is best.
drivesgame_off_pass_rankFloat64National rank of the team's drives per game on pass plays with the team on offense, where 1 is best.
yardsdrive_off_pass_rankFloat64National rank of the team's yards gained per drive on pass plays with the team on offense, where 1 is best.
playsdrive_off_pass_rankFloat64National rank of the team's plays run per drive on pass plays with the team on offense, where 1 is best.
play_stuffed_off_pass_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays with the team on offense, where 1 is best.
red_zone_success_off_pass_rankFloat64National rank of the team's success rate on red-zone plays on pass plays with the team on offense, where 1 is best.
third_down_success_off_pass_rankFloat64National rank of the team's success rate on third-down plays on pass plays with the team on offense, where 1 is best.
late_down_success_off_pass_rankFloat64National rank of the team's success rate on late-down plays on pass plays with the team on offense, where 1 is best.
third_down_distance_off_pass_rankFloat64National rank of the team's average yards to go on third down on pass plays with the team on offense, where 1 is best.
havoc_off_pass_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays with the team on offense, where 1 is best.
explosive_off_pass_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on pass plays with the team on offense, where 1 is best.
passrate_off_pass_rankFloat64National rank of the team's share of plays that were pass plays on pass plays with the team on offense, where 1 is best.
rushrate_off_pass_rankFloat64National rank of the team's share of plays that were rush plays on pass plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_pass_rankFloat64National rank of the team's EPA per play with explosive plays excluded on pass plays with the team on offense, where 1 is best.
line_yards_off_pass_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on pass plays with the team on offense, where 1 is best.
opportunity_rate_off_pass_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on pass plays with the team on offense, where 1 is best.
plays_def_passUInt32Plays run on pass plays, with the team on defense (i.e. allowed to opponents).
passrate_def_passFloat64Share of plays that were pass plays on pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_passFloat64Share of plays that were rush plays on pass plays, with the team on defense (i.e. allowed to opponents).
havoc_def_passFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays, with the team on defense (i.e. allowed to opponents).
explosive_def_passFloat64Explosive-play rate -- the share of plays carrying the explosive flag on pass plays, with the team on defense (i.e. allowed to opponents).
TEPA_def_passFloat64Total EPA summed over every play on pass plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_passFloat64EPA per play on pass plays, with the team on defense (i.e. allowed to opponents).
yards_def_passInt64Total yards gained on pass plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_passFloat64Yards gained per play on pass plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_passFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays, with the team on defense (i.e. allowed to opponents).
success_def_passFloat64Success rate -- the share of plays flagged as successful by EPA on pass plays, with the team on defense (i.e. allowed to opponents).
red_zone_success_def_passFloat64Success rate on red-zone plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_passFloat64Success rate on third-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_passFloat64Average yards to go on third down on pass plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_passFloat64Success rate on late-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_passFloat64EPA per early-down play on pass plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_passFloat64EPA per play with explosive plays excluded on pass plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_passFloat64Average line yards credited to the offensive line on rushes on pass plays, with the team on defense (i.e. allowed to opponents).
opportunity_rate_def_passFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_passFloat64Plays run per game on pass plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_passFloat64EPA per drive (total EPA divided by drives) on pass plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_passFloat64EPA per game (total EPA divided by games) on pass plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_passFloat64Yards gained per game on pass plays, with the team on defense (i.e. allowed to opponents).
drives_def_passUInt32Offensive drives on pass plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_passFloat64Drives per game on pass plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_passFloat64Yards gained per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_passFloat64Plays run per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_pass_rankFloat64National rank of the team's plays run per game on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_def_pass_rankFloat64National rank of the team's total EPA summed over every play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAgame_def_pass_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAplay_def_pass_rankFloat64National rank of the team's EPA per play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_pass_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
early_down_EPA_def_pass_rankFloat64National rank of the team's EPA per early-down play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
success_def_pass_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yards_def_pass_rankFloat64National rank of the team's total yards gained on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_pass_rankFloat64National rank of the team's yards gained per play on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsgame_def_pass_rankFloat64National rank of the team's yards gained per game on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
drivesgame_def_pass_rankFloat64National rank of the team's drives per game on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_pass_rankFloat64National rank of the team's yards gained per drive on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
playsdrive_def_pass_rankFloat64National rank of the team's plays run per drive on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
play_stuffed_def_pass_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
red_zone_success_def_pass_rankFloat64National rank of the team's success rate on red-zone plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_success_def_pass_rankFloat64National rank of the team's success rate on third-down plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
late_down_success_def_pass_rankFloat64National rank of the team's success rate on late-down plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_distance_def_pass_rankFloat64National rank of the team's average yards to go on third down on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
havoc_def_pass_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
explosive_def_pass_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
passrate_def_pass_rankFloat64National rank of the team's share of plays that were pass plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
rushrate_def_pass_rankFloat64National rank of the team's share of plays that were rush plays on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
nonExplosiveEpaPerPlay_def_pass_rankFloat64National rank of the team's EPA per play with explosive plays excluded on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
line_yards_def_pass_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
opportunity_rate_def_pass_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on pass plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_margin_passFloat64Margin in total EPA summed over every play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_passFloat64Margin in EPA per play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_passFloat64Margin in EPA per drive (total EPA divided by drives) on pass plays: the team's offensive value minus the value it allowed on defense.
EPAgame_margin_passFloat64Margin in EPA per game (total EPA divided by games) on pass plays: the team's offensive value minus the value it allowed on defense.
success_margin_passFloat64Margin in success rate -- the share of plays flagged as successful by EPA on pass plays: the team's offensive value minus the value it allowed on defense.
yardsplay_margin_passFloat64Margin in yards gained per play on pass plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_pass_rankFloat64Margin in total EPA summed over every play on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAplay_margin_pass_rankFloat64Margin in EPA per play on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAdrive_margin_pass_rankFloat64Margin in EPA per drive (total EPA divided by drives) on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAgame_margin_pass_rankFloat64Margin in EPA per game (total EPA divided by games) on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
success_margin_pass_rankFloat64Margin in success rate -- the share of plays flagged as successful by EPA on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
yardsplay_margin_pass_rankFloat64Margin in yards gained per play on pass plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
plays_off_rushUInt32Plays run on rush plays, with the team on offense.
passrate_off_rushFloat64Share of plays that were pass plays on rush plays, with the team on offense.
rushrate_off_rushFloat64Share of plays that were rush plays on rush plays, with the team on offense.
havoc_off_rushFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays, with the team on offense.
explosive_off_rushFloat64Explosive-play rate -- the share of plays carrying the explosive flag on rush plays, with the team on offense.
TEPA_off_rushFloat64Total EPA summed over every play on rush plays, with the team on offense.
EPAplay_off_rushFloat64EPA per play on rush plays, with the team on offense.
yards_off_rushInt64Total yards gained on rush plays, with the team on offense.
yardsplay_off_rushFloat64Yards gained per play on rush plays, with the team on offense.
play_stuffed_off_rushFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays, with the team on offense.
success_off_rushFloat64Success rate -- the share of plays flagged as successful by EPA on rush plays, with the team on offense.
red_zone_success_off_rushFloat64Success rate on red-zone plays on rush plays, with the team on offense.
third_down_success_off_rushFloat64Success rate on third-down plays on rush plays, with the team on offense.
third_down_distance_off_rushFloat64Average yards to go on third down on rush plays, with the team on offense.
late_down_success_off_rushFloat64Success rate on late-down plays on rush plays, with the team on offense.
early_down_EPA_off_rushFloat64EPA per early-down play on rush plays, with the team on offense.
nonExplosiveEpaPerPlay_off_rushFloat64EPA per play with explosive plays excluded on rush plays, with the team on offense.
line_yards_off_rushFloat64Average line yards credited to the offensive line on rushes on rush plays, with the team on offense.
opportunity_rate_off_rushFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on offense.
playsgame_off_rushFloat64Plays run per game on rush plays, with the team on offense.
EPAdrive_off_rushFloat64EPA per drive (total EPA divided by drives) on rush plays, with the team on offense.
EPAgame_off_rushFloat64EPA per game (total EPA divided by games) on rush plays, with the team on offense.
yardsgame_off_rushFloat64Yards gained per game on rush plays, with the team on offense.
drives_off_rushUInt32Offensive drives on rush plays, with the team on offense.
drivesgame_off_rushFloat64Drives per game on rush plays, with the team on offense.
yardsdrive_off_rushFloat64Yards gained per drive on rush plays, with the team on offense.
playsdrive_off_rushFloat64Plays run per drive on rush plays, with the team on offense.
playsgame_off_rush_rankFloat64National rank of the team's plays run per game on rush plays with the team on offense, where 1 is best.
TEPA_off_rush_rankFloat64National rank of the team's total EPA summed over every play on rush plays with the team on offense, where 1 is best.
EPAgame_off_rush_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on rush plays with the team on offense, where 1 is best.
EPAplay_off_rush_rankFloat64National rank of the team's EPA per play on rush plays with the team on offense, where 1 is best.
EPAdrive_off_rush_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on rush plays with the team on offense, where 1 is best.
early_down_EPA_off_rush_rankFloat64National rank of the team's EPA per early-down play on rush plays with the team on offense, where 1 is best.
success_off_rush_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on rush plays with the team on offense, where 1 is best.
yards_off_rush_rankFloat64National rank of the team's total yards gained on rush plays with the team on offense, where 1 is best.
yardsplay_off_rush_rankFloat64National rank of the team's yards gained per play on rush plays with the team on offense, where 1 is best.
yardsgame_off_rush_rankFloat64National rank of the team's yards gained per game on rush plays with the team on offense, where 1 is best.
drivesgame_off_rush_rankFloat64National rank of the team's drives per game on rush plays with the team on offense, where 1 is best.
yardsdrive_off_rush_rankFloat64National rank of the team's yards gained per drive on rush plays with the team on offense, where 1 is best.
playsdrive_off_rush_rankFloat64National rank of the team's plays run per drive on rush plays with the team on offense, where 1 is best.
play_stuffed_off_rush_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays with the team on offense, where 1 is best.
red_zone_success_off_rush_rankFloat64National rank of the team's success rate on red-zone plays on rush plays with the team on offense, where 1 is best.
third_down_success_off_rush_rankFloat64National rank of the team's success rate on third-down plays on rush plays with the team on offense, where 1 is best.
late_down_success_off_rush_rankFloat64National rank of the team's success rate on late-down plays on rush plays with the team on offense, where 1 is best.
third_down_distance_off_rush_rankFloat64National rank of the team's average yards to go on third down on rush plays with the team on offense, where 1 is best.
havoc_off_rush_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays with the team on offense, where 1 is best.
explosive_off_rush_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on rush plays with the team on offense, where 1 is best.
passrate_off_rush_rankFloat64National rank of the team's share of plays that were pass plays on rush plays with the team on offense, where 1 is best.
rushrate_off_rush_rankFloat64National rank of the team's share of plays that were rush plays on rush plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_rush_rankFloat64National rank of the team's EPA per play with explosive plays excluded on rush plays with the team on offense, where 1 is best.
line_yards_off_rush_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on rush plays with the team on offense, where 1 is best.
opportunity_rate_off_rush_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on rush plays with the team on offense, where 1 is best.
plays_def_rushUInt32Plays run on rush plays, with the team on defense (i.e. allowed to opponents).
passrate_def_rushFloat64Share of plays that were pass plays on rush plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_rushFloat64Share of plays that were rush plays on rush plays, with the team on defense (i.e. allowed to opponents).
havoc_def_rushFloat64Havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays, with the team on defense (i.e. allowed to opponents).
explosive_def_rushFloat64Explosive-play rate -- the share of plays carrying the explosive flag on rush plays, with the team on defense (i.e. allowed to opponents).
TEPA_def_rushFloat64Total EPA summed over every play on rush plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_rushFloat64EPA per play on rush plays, with the team on defense (i.e. allowed to opponents).
yards_def_rushInt64Total yards gained on rush plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_rushFloat64Yards gained per play on rush plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_rushFloat64Stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays, with the team on defense (i.e. allowed to opponents).
success_def_rushFloat64Success rate -- the share of plays flagged as successful by EPA on rush plays, with the team on defense (i.e. allowed to opponents).
red_zone_success_def_rushFloat64Success rate on red-zone plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_rushFloat64Success rate on third-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_rushFloat64Average yards to go on third down on rush plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_rushFloat64Success rate on late-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_rushFloat64EPA per early-down play on rush plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_rushFloat64EPA per play with explosive plays excluded on rush plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_rushFloat64Average line yards credited to the offensive line on rushes on rush plays, with the team on defense (i.e. allowed to opponents).
opportunity_rate_def_rushFloat64Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rushFloat64Plays run per game on rush plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_rushFloat64EPA per drive (total EPA divided by drives) on rush plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_rushFloat64EPA per game (total EPA divided by games) on rush plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_rushFloat64Yards gained per game on rush plays, with the team on defense (i.e. allowed to opponents).
drives_def_rushUInt32Offensive drives on rush plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_rushFloat64Drives per game on rush plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_rushFloat64Yards gained per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_rushFloat64Plays run per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rush_rankFloat64National rank of the team's plays run per game on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_def_rush_rankFloat64National rank of the team's total EPA summed over every play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAgame_def_rush_rankFloat64National rank of the team's EPA per game (total EPA divided by games) on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAplay_def_rush_rankFloat64National rank of the team's EPA per play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_rush_rankFloat64National rank of the team's EPA per drive (total EPA divided by drives) on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
early_down_EPA_def_rush_rankFloat64National rank of the team's EPA per early-down play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
success_def_rush_rankFloat64National rank of the team's success rate -- the share of plays flagged as successful by EPA on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yards_def_rush_rankFloat64National rank of the team's total yards gained on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_rush_rankFloat64National rank of the team's yards gained per play on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsgame_def_rush_rankFloat64National rank of the team's yards gained per game on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
drivesgame_def_rush_rankFloat64National rank of the team's drives per game on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_rush_rankFloat64National rank of the team's yards gained per drive on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
playsdrive_def_rush_rankFloat64National rank of the team's plays run per drive on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
play_stuffed_def_rush_rankFloat64National rank of the team's stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
red_zone_success_def_rush_rankFloat64National rank of the team's success rate on red-zone plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_success_def_rush_rankFloat64National rank of the team's success rate on third-down plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
late_down_success_def_rush_rankFloat64National rank of the team's success rate on late-down plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
third_down_distance_def_rush_rankFloat64National rank of the team's average yards to go on third down on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
havoc_def_rush_rankFloat64National rank of the team's havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
explosive_def_rush_rankFloat64National rank of the team's explosive-play rate -- the share of plays carrying the explosive flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
passrate_def_rush_rankFloat64National rank of the team's share of plays that were pass plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
rushrate_def_rush_rankFloat64National rank of the team's share of plays that were rush plays on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
nonExplosiveEpaPerPlay_def_rush_rankFloat64National rank of the team's EPA per play with explosive plays excluded on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
line_yards_def_rush_rankFloat64National rank of the team's average line yards credited to the offensive line on rushes on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
opportunity_rate_def_rush_rankFloat64National rank of the team's opportunity rate -- the share of rushes carrying the opportunity flag on rush plays with the team on defense (i.e. allowed to opponents), where 1 is best.
TEPA_margin_rushFloat64Margin in total EPA summed over every play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_rushFloat64Margin in EPA per play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_rushFloat64Margin in EPA per drive (total EPA divided by drives) on rush plays: the team's offensive value minus the value it allowed on defense.
EPAgame_margin_rushFloat64Margin in EPA per game (total EPA divided by games) on rush plays: the team's offensive value minus the value it allowed on defense.
success_margin_rushFloat64Margin in success rate -- the share of plays flagged as successful by EPA on rush plays: the team's offensive value minus the value it allowed on defense.
yardsplay_margin_rushFloat64Margin in yards gained per play on rush plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rush_rankFloat64Margin in total EPA summed over every play on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAplay_margin_rush_rankFloat64Margin in EPA per play on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAdrive_margin_rush_rankFloat64Margin in EPA per drive (total EPA divided by drives) on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
EPAgame_margin_rush_rankFloat64Margin in EPA per game (total EPA divided by games) on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
success_margin_rush_rankFloat64Margin in success rate -- the share of plays flagged as successful by EPA on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
yardsplay_margin_rush_rankFloat64Margin in yards gained per play on rush plays: the team's offensive value minus the value it allowed on defense. National rank of that margin, 1 = largest.
fbs_classStringPower/Group classification for the season: P4 or G6 from 2024 on, P5 or G5 through 2023, derived from conference membership (Notre Dame is classified with the power group). Null for teams outside FBS.
valid_gamesUInt32Number of the team's games that produced both an offensive and a defensive adjusted-EPA value; teams below two valid games are dropped from the adjusted ratings.
adj_off_epaFloat64Offensive opponent-adjusted EPA per play from the ridge (RAPM-style) regression on offense/defense team indicators plus home field -- cfbfastR's adjust_epa adjustment, fit in-sample across the season, so the value is descriptive of that window rather than predictive.
adj_def_epaFloat64Defensive opponent-adjusted EPA per play from the ridge (RAPM-style) regression on offense/defense team indicators plus home field -- cfbfastR's adjust_epa adjustment, fit in-sample across the season, so the value is descriptive of that window rather than predictive. Lower is better -- it is EPA allowed.
off_strength_facedFloat64Average opponent-defense strength the team's offense faced, taken as the mean of the ridge's defensive coefficients across its opponents. Higher means a tougher slate.
def_strength_facedFloat64Average opponent-offense strength the team's defense faced, taken as the mean of the ridge's offensive coefficients across its opponents. Higher means a tougher slate.
net_adj_epaFloat64Net opponent-adjusted EPA per play: adj_off_epa minus adj_def_epa. Higher is better.
adj_off_epa_rankFloat64National rank of the team's adj_off_epa, where 1 is best.
adj_def_epa_rankFloat64National rank of the team's adj_def_epa, where 1 is best (fewest EPA allowed).
net_adj_epa_rankFloat64National rank of the team's net_adj_epa, 1 = largest net adjusted EPA.
through_weekInt32Regular-season week this cumulative snapshot covers -- the row reflects the team's state through the end of that week. One asset holds every week, so filter on this column.
load_cfb_team_summaries_weekly(seasons=2024)

load_cfb_pbp_r

Release: cfbfastR_cfb_pbp · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/cfbfastR_cfb_pbp/play_by_play_{season}.parquet

Returns

col_nametypedescription
yearInt32Four-digit season year (e.g. 2019).
weekInt32Game week of the season.
id_playFloat64Unique CFBD play identifier (concatenates game_id and play index).
game_idInt32ESPN game identifier.
game_play_numberFloat64Sequential play number within the game (excludes timeouts/end markers).
half_play_numberFloat64Sequential play number within the current half.
drive_play_numberFloat64Sequential play number within the current drive.
pos_teamStringTeam name in possession at the start of the play (offense, kickoff-aware).
def_pos_teamStringTeam name on defense at the start of the play.
pos_team_scoreInt32Score for the team in possession at the start of the play.
def_pos_team_scoreInt32Score for the defensive team at the start of the play.
halfFloat64Half indicator (1 or 2).
periodInt32Period (quarter) number.
clock_minutesInt32Minutes remaining on the period clock at the start of the play.
clock_secondsInt32Game clock value in seconds at the play.
play_typeStringCFBD play type label (e.g. "Rush", "Pass Reception", "Field Goal Good").
play_textStringFree-form text description of the play from the CFBD feed.
downFloat64Down of the play (1-4).
distanceFloat64Yards to gain for a first down (or to the goal line in goal-to-go situations).
yards_to_goalFloat64Distance in yards from the offense's spot to the opponent's goal line (0-100).
yards_gainedFloat64Net yards gained by the offense on the play.
EPAFloat64Expected Points Added on the play (cfbfastR EPA model output).
ep_beforeFloat64Expected points value before the play (cfbfastR EPA model).
ep_afterFloat64Expected points value after the play (cfbfastR EPA model).
wpaFloat64Win Probability Added on the play (cfbfastR WP model output).
wp_beforeFloat64Win probability for the possession team before the play (0-1).
wp_afterFloat64Win probability for the possession team after the play (0-1).
def_wp_beforeFloat64Win probability for the defensive team before the play (0-1).
def_wp_afterFloat64Win probability for the defensive team after the play (0-1).
penalty_detailStringParsed penalty description extracted from play text.
yds_penaltyFloat64Yardage assessed on the penalty.
penalty_1st_convBooleanTRUE when the penalty resulted in a first down conversion.
new_seriesFloat64Binary flag for the start of a new series of downs.
firstD_by_kickoffFloat64Binary flag for a new first down arising from a kickoff.
firstD_by_possFloat64Binary flag for a new first down via change of possession.
firstD_by_penaltyFloat64Binary flag for a new first down via penalty.
firstD_by_yardsFloat64Binary flag for a new first down via yards gained.
def_EPAFloat64EPA for the defensive team on the play (sign-flipped offense EPA).
home_EPAFloat64EPA for the home team on the play.
away_EPAFloat64EPA for the away team on the play.
home_EPA_rushFloat64Rushing EPA for the home team on the play.
away_EPA_rushFloat64Rushing EPA for the away team on the play.
home_EPA_passFloat64Passing EPA for the home team on the play.
away_EPA_passFloat64Passing EPA for the away team on the play.
total_home_EPAFloat64Cumulative total EPA for the home team through the play.
total_away_EPAFloat64Cumulative total EPA for the away team through the play.
total_home_EPA_rushFloat64Cumulative rushing EPA for the home team through the play.
total_away_EPA_rushFloat64Cumulative rushing EPA for the away team through the play.
total_home_EPA_passFloat64Cumulative passing EPA for the home team through the play.
total_away_EPA_passFloat64Cumulative passing EPA for the away team through the play.
net_home_EPAFloat64Net EPA differential (home minus away) through the play.
net_away_EPAFloat64Net EPA differential (away minus home) through the play.
net_home_EPA_rushFloat64Net rushing EPA differential for the home team through the play.
net_away_EPA_rushFloat64Net rushing EPA differential for the away team through the play.
net_home_EPA_passFloat64Net passing EPA differential for the home team through the play.
net_away_EPA_passFloat64Net passing EPA differential for the away team through the play.
successFloat64Binary success-rate flag using the 50/70/100 percent down-state thresholds.
epa_successFloat64Binary flag for plays with positive EPA (EPA > 0).
rz_playFloat64Binary flag for a red-zone play (yards_to_goal <= 20).
scoring_oppFloat64Binary flag for a scoring opportunity (yards_to_goal <= 40).
middle_8BooleanTRUE for plays in the middle-8 window (final 4 min of 1H, first 4 min of 2H).
stuffed_runFloat64Binary flag for a stuffed run (zero or negative yards gained).
change_of_pos_teamFloat64Binary flag for change of possession-team on the play.
downs_turnoverFloat64Binary flag for a turnover on downs.
turnoverFloat64Binary flag for any turnover on the play.
pos_score_diff_startFloat64Score differential for the possession team at the start of the play.
pos_score_ptsFloat64Points scored on the play attributed to the possession team.
log_ydstogoFloat64Natural log of distance-to-go (model feature).
ExpScoreDiffFloat64Expected score differential at the start of the play (EPA-adjusted).
ExpScoreDiff_Time_RatioFloat64Expected score differential scaled by share of time remaining.
half_clock_minutesFloat64Minutes remaining in the half (15 + clock_minutes when in Q1/Q3).
TimeSecsRemFloat64Seconds remaining in the half at the start of the play.
adj_TimeSecsRemFloat64Adjusted seconds remaining used by the EPA/WP models.
Goal_To_GoBooleanTRUE when the offense is in a goal-to-go situation.
Under_twoBooleanTRUE when under two minutes remain in the half.
homeStringHome team name.
awayStringAway team name.
home_wp_beforeFloat64Home team win probability before the play (0-1).
away_wp_beforeFloat64Away team win probability before the play (0-1).
home_wp_afterFloat64Home team win probability after the play (0-1).
away_wp_afterFloat64Away team win probability after the play (0-1).
end_of_halfFloat64Binary flag for the last play of a half.
pos_team_receives_2H_kickoffFloat64Binary flag indicating possession team receives the second-half kickoff.
lead_pos_teamStringPossession team on the next play (lead value).
lead_play_typeStringPlay type on the next play (lead value).
lag_pos_teamStringPossession team on the previous play (lag value).
lag_play_typeStringPlay type on the previous play (lag value).
orig_play_typeStringOriginal CFBD play type label before cfbfastR cleaning.
Under_threeBooleanTRUE when under three minutes remain in the half.
rowInt32Row index within the game grouping (sequencing helper).
drive_event_numberFloat64Sequential event number within the current drive.
play_numberInt32Sequential play number within the game (1-indexed).
wallclockStringReal-world ISO timestamp of the play.
providerStringSportsbook provider used for spread/over_under joined onto the play.
spreadFloat64Pre-game point spread from the selected provider.
formatted_spreadStringHuman-readable formatted spread string from the betting provider.
over_underFloat64Pre-game over/under total from the selected provider.
drive_is_home_offenseBooleanTRUE when the home team is on offense for the drive.
drive_start_offense_scoreInt32Offense score at the start of the drive.
drive_start_defense_scoreInt32Defense score at the start of the drive.
drive_end_offense_scoreInt32Offense score at the end of the drive.
drive_end_defense_scoreInt32Defense score at the end of the drive.
playFloat64Binary flag indicating the row is a counted play (excludes end markers/timeouts/penalties).
eventFloat64Binary flag indicating the row is a counted game event (excludes end markers).
game_event_numberFloat64Sequential event number within the game.
game_row_numberInt32Row index within the game grouping.
half_playFloat64Binary flag indicating a counted play within the half.
half_eventFloat64Binary flag indicating a counted event within the half.
half_event_numberFloat64Sequential event number within the half.
half_row_numberInt32Row index within the half grouping.
pos_unitStringPossession-team unit label (offense or special teams).
def_pos_unitStringDefensive possession-team unit label (defense or special teams).
drive_playFloat64Binary flag indicating a counted play within the drive.
drive_eventFloat64Binary flag indicating a counted event within the drive.
venue_idInt32Referencing venue id.
venueStringVenue name.
neutral_siteBooleanTRUE/FALSE flag for if the game took place at a neutral site.
conference_gameBooleanTRUE/FALSE flag for this game qualifying as a conference game.
season_typeStringESPN season type (2 = regular, 3 = postseason).
start_dateStringSeason start timestamp (ISO 8601, UTC).
completedBooleanTRUE if the game is complete.
home_team_idInt32ESPN home team id (parsed from home_team_ref).
home_teamStringHome team name.
home_team_divisionStringHome team NCAA division (1, 2, 3).
home_team_conferenceStringConference name of the home team.
home_team_pregame_eloInt32
away_team_idInt32ESPN away team id (parsed from away_team_ref).
away_teamStringAway team name.
away_team_divisionStringAway team NCAA division (1, 2, 3).
away_team_conferenceStringConference name of the away team.
away_team_pregame_eloInt32
seasonInt32Season (4-digit year).
teamStringTeam name.
conferenceStringConference of the team.
opponentStringOpponent team name.
team_scoreInt32Offense team score at the time of the play.
opponent_scoreInt32Defense / opponent team score at the time of the play.
down_endFloat64Down number at the end of the play (post-play state).
distance_endFloat64Distance-to-go at the end of the play (post-play state).
log_ydstogo_endFloat64Natural log of post-play distance-to-go (model feature).
yards_to_goal_endFloat64Yards to opponent end zone at the end of the play.
TimeSecsRem_endFloat64Seconds remaining in the half at the end of the play.
Goal_To_Go_endBooleanTRUE when the post-play state is goal-to-go.
Under_two_endBooleanTRUE when the post-play state is under two minutes.
offense_score_playFloat64Binary flag for an offensive scoring play.
defense_score_playFloat64Binary flag for a defensive scoring play.
ppaFloat64Predicted Points Added from the CFBD ppa endpoint (CFB-EPA analogue).
yard_lineInt32Field-position yard line at the start of the play (0-50 scale from the offense's side).
scoringBooleanTRUE when the play results in a score (TD, FG, safety, two-point conversion).
pos_team_timeouts_rem_beforeFloat64Possession team timeouts remaining before the play.
def_pos_team_timeouts_rem_beforeFloat64Defensive team timeouts remaining before the play.
pos_team_timeoutsFloat64Possession team timeouts remaining after the play.
def_pos_team_timeoutsFloat64Defensive team timeouts remaining after the play.
pos_score_diffInt32Score differential from the possession team's perspective.
pos_score_diff_start_endFloat64Score differential aggregated from start to end of the play.
offense_playStringOffensive team name as labeled by CFBD on the play.
defense_playStringDefensive team name as labeled by CFBD on the play.
offense_receives_2H_kickoffFloat64Binary flag indicating offense receives the second-half kickoff.
change_of_possFloat64Binary flag for change of possession on the play (CFBD offense field).
score_ptsFloat64Points scored on the play.
score_diff_startFloat64Score differential at the start of the play.
score_diffInt32Score differential (offense_score - defense_score) at the start.
offense_scoreInt32Offense team score at the start of the play.
defense_scoreInt32Defense team score at the start of the play.
offense_conferenceStringConference name of the offense (e.g. "SEC", "ACC").
defense_conferenceStringConference name of the defense (e.g. "SEC", "ACC").
off_timeout_calledFloat64Binary flag for an offensive timeout called during the play.
def_timeout_calledFloat64Binary flag for a defensive timeout called during the play.
offense_timeoutsFloat64Timeouts remaining for the offense at the end of the play.
defense_timeoutsFloat64Timeouts remaining for the defense at the end of the play.
off_timeouts_rem_beforeFloat64Offense timeouts remaining before the play.
def_timeouts_rem_beforeFloat64Defense timeouts remaining before the play.
rusher_player_nameStringName of the rusher on a rushing play.
yds_rushedFloat64Rushing yards gained on the play.
passer_player_nameStringName of the passer on a passing play.
receiver_player_nameStringName of the receiver on a passing play.
yds_receivingFloat64Receiving yards gained on the play.
yds_sackedFloat64Yards lost on the sack.
sack_playersStringCombined names of all sack participants.
sack_player_nameStringPrimary sack player name.
sack_player_name2StringSecondary sack player name (when split between two defenders).
pass_breakup_player_nameStringName of the defender credited with the pass breakup.
interception_player_nameStringName of the defender credited with the interception.
yds_int_returnFloat64Yards gained on an interception return.
fumble_player_nameStringName of the player who fumbled.
fumble_forced_player_nameStringName of the player who forced the fumble.
fumble_recovered_player_nameStringName of the player who recovered the fumble.
yds_fumble_returnFloat64Yards gained on a fumble return.
punter_player_nameStringName of the punter.
yds_puntedFloat64Yards the ball traveled on the punt.
punt_returner_player_nameStringName of the punt returner.
yds_punt_returnFloat64Yards gained on the punt return.
yds_punt_gainedFloat64Net yards gained on the punt (punt distance minus return).
punt_block_player_nameStringName of the player credited with blocking the punt.
punt_block_return_player_nameStringName of the player returning a blocked punt.
fg_kicker_player_nameStringName of the field goal kicker.
yds_fgFloat64Distance of the field goal attempt in yards.
fg_block_player_nameStringName of the player credited with blocking the field goal.
fg_return_player_nameStringName of the player returning the blocked/missed field goal.
kickoff_player_nameStringName of the kickoff specialist.
yds_kickoffFloat64Yards the ball traveled on the kickoff.
kickoff_returner_player_nameStringName of the kickoff returner.
yds_kickoff_returnFloat64Yards gained on the kickoff return.
new_idFloat64Numeric play index within the game (id_play with game_id stripped).
orig_drive_numberInt32Original CFBD drive number for the play.
drive_numberInt32Sequential drive number within the game (1-indexed).
drive_result_detailedStringDetailed drive result label (e.g. "Punt", "Passing Touchdown", "Downs Turnover").
new_drive_ptsFloat64Points scored on the drive (signed for offense/defense).
drive_idFloat64CFBD drive identifier the play belongs to.
drive_resultStringDrive result code (drive_-prefixed; every drive-level column is carried with this prefix).
drive_start_yards_to_goalFloat64Yards to opponent's end zone at drive start (0-100).
drive_end_yards_to_goalInt32Yards to opponent's end zone at drive end (0-100).
drive_yardsInt32Net yards gained on the drive.
drive_scoringFloat64Binary flag for a scoring drive.
drive_ptsFloat64Points scored on the drive (CFBD/cfbfastR reconciled value).
drive_start_periodInt32Period (quarter) at the start of the drive.
drive_end_periodInt32Period (quarter) at the end of the drive.
drive_time_minutes_startInt32Minutes on the clock at the start of the drive.
drive_time_seconds_startInt32Seconds on the clock at the start of the drive.
drive_time_minutes_endInt32Minutes on the clock at the end of the drive.
drive_time_seconds_endInt32Seconds on the clock at the end of the drive.
drive_time_minutes_elapsedInt32Minutes elapsed during the drive.
drive_time_seconds_elapsedInt32Seconds elapsed during the drive.
drive_numbersFloat64Binary flag marking the first play of a new drive.
number_of_drivesFloat64Cumulative count of drives in the game.
pts_scoredFloat64Points scored on the play, signed by play_type rule.
drive_result_detailed_flagStringPre-fill copy of drive_result_detailed used during drive reconciliation.
drive_result2StringShort-form drive result label (e.g. "TD", "PUNT", "DOWNS").
drive_numFloat64Game-scoped drive sequence number.
lag_drive_result_detailedStringDrive result detailed on the previous play (lag value).
lead_drive_result_detailedStringDrive result detailed on the next play (lead value).
lag_new_drive_ptsFloat64Drive points on the previous play (lag value).
id_driveFloat64Composite drive identifier (game_id concatenated with drive_num).
rushFloat64Binary flag for a rushing play.
rush_tdFloat64Binary flag for a rushing touchdown.
passFloat64Binary flag for a passing play (includes sacks).
pass_tdFloat64Binary flag for a passing touchdown.
completionFloat64Binary flag for a completed pass.
pass_attemptFloat64Binary flag for a pass attempt.
targetFloat64Binary flag for a targeted receiver on the play.
sack_vecFloat64Binary flag for a sack play.
sackFloat64Binary flag for a sack (duplicate of sack_vec for downstream use).
intFloat64Binary flag for an interception.
int_tdFloat64Binary flag for an interception returned for a touchdown.
turnover_vecFloat64Binary flag for any play classified as a turnover.
turnover_vec_lagFloat64Lag of turnover_vec (previous-play turnover flag).
turnover_indicatorFloat64Composite turnover indicator including failed 4th downs.
kickoff_playFloat64Binary flag for a kickoff play.
receives_2H_kickoffFloat64Binary flag for the team receiving the second-half kickoff.
missing_yard_flagBooleanTRUE when post-play yardage had to be imputed.
scoring_playFloat64TRUE if the play resulted in a score.
td_playFloat64Binary flag for a touchdown play.
touchdownFloat64Binary flag for a touchdown (duplicate of td_play for downstream use).
safetyFloat64Binary flag for a safety.
fumble_vecFloat64Binary flag for a play involving a fumble.
kickoff_tbFloat64Binary flag for a kickoff touchback.
kickoff_onsideFloat64Binary flag for an onside kickoff attempt.
kickoff_oobFloat64Binary flag for a kickoff out of bounds.
kickoff_fair_catchFloat64Binary flag for a kickoff fair catch.
kickoff_downedFloat64Binary flag for a kickoff downed in the field of play.
kickoff_safetyFloat64Binary flag for a kickoff safety.
kick_playFloat64Binary flag for any kicking play (kickoff or field goal).
puntFloat64Binary flag for a punt play.
punt_playFloat64Binary flag for any punt-related play (includes blocks/returns).
punt_tbFloat64Binary flag for a punt touchback.
punt_oobFloat64Binary flag for a punt out of bounds.
punt_fair_catchFloat64Binary flag for a punt fair catch.
punt_downedFloat64Binary flag for a punt downed in the field of play.
punt_safetyFloat64Binary flag for a punt safety.
punt_blockedFloat64Binary flag for a blocked punt.
penalty_safetyFloat64Binary flag for a safety scored on a penalty.
fg_indsFloat64Binary flag for a field goal attempt.
fg_madeBooleanTRUE when the field goal attempt was successful.
fg_make_probFloat64Predicted probability of making the field goal (cfbfastR FG model, 0-1).
No_Score_beforeFloat64Pre-play predicted probability of no score before end of half (cfbfastR EP model, 0-1).
FG_beforeFloat64Pre-play predicted probability of a posteam field goal next (0-1).
Opp_FG_beforeFloat64Pre-play predicted probability of a defteam field goal next (0-1).
Opp_Safety_beforeFloat64Pre-play predicted probability of a defteam safety next (0-1).
Opp_TD_beforeFloat64Pre-play predicted probability of a defteam touchdown next (0-1).
Safety_beforeFloat64Pre-play predicted probability of a posteam safety next (0-1).
TD_beforeFloat64Pre-play predicted probability of a posteam touchdown next (0-1).
No_Score_afterFloat64Post-play predicted probability of no score before end of half (0-1).
FG_afterFloat64Post-play predicted probability of a posteam field goal next (0-1).
Opp_FG_afterFloat64Post-play predicted probability of a defteam field goal next (0-1).
Opp_Safety_afterFloat64Post-play predicted probability of a defteam safety next (0-1).
Opp_TD_afterFloat64Post-play predicted probability of a defteam touchdown next (0-1).
Safety_afterFloat64Post-play predicted probability of a posteam safety next (0-1).
TD_afterFloat64Post-play predicted probability of a posteam touchdown next (0-1).
position_receptionString
position_targetString
position_completionString
position_incompletionString
position_sack_takenString
position_sackString
position_interception_thrownString
position_interceptionString
position_fumbleString
position_fumble_forcedString
position_fumble_recoveredString
position_pass_breakupString
position_rushString
position_touchdownString
rush_player_idFloat64CFBD athlete_id of the player credited with a rush attempt.
rush_playerStringName of the player credited with a rush attempt.
rush_ydsInt32Rushing yards gained on the play.
reception_player_idFloat64CFBD athlete_id of the receiver credited with a reception.
reception_playerStringName of the receiver credited with a reception.
reception_ydsInt32Reception yards gained on the play.
completion_player_idFloat64CFBD athlete_id of the passer credited with a completion.
completion_playerStringName of the passer credited with a completion.
completion_ydsInt32Passing yards gained on the completion.
interception_player_idFloat64CFBD athlete_id of the defender credited with an interception.
interception_playerStringName of the defender credited with an interception.
interception_statInt32Interception stat value reported by CFBD (typically 1 per INT).
interception_thrown_player_idFloat64CFBD athlete_id of the passer charged with the interception.
interception_thrown_playerStringName of the passer charged with the interception.
interception_thrown_statInt32Interception-thrown stat value reported by CFBD (typically 1 per INT thrown).
touchdown_player_idFloat64CFBD athlete_id of the player credited with the touchdown.
touchdown_playerStringName of the player credited with the touchdown.
touchdown_statInt32Touchdown stat value reported by CFBD (typically 1 per TD scored).
incompletion_player_idFloat64CFBD athlete_id of the targeted receiver on an incompletion.
incompletion_playerStringName of the targeted receiver on an incompletion.
incompletion_statInt32Incompletion stat value reported by CFBD (typically 1 per incompletion).
target_player_idFloat64CFBD athlete_id of the targeted receiver on a pass.
target_playerStringName of the targeted receiver on a pass.
target_statInt32Target stat value reported by CFBD (typically 1 per target).
fumble_recovered_player_idFloat64CFBD athlete_id of the player recovering the fumble.
fumble_recovered_playerStringName of the player recovering the fumble.
fumble_recovered_statInt32Fumble-recovered stat value reported by CFBD (typically 1 per recovery).
fumble_forced_player_idFloat64CFBD athlete_id of the defender credited with forcing the fumble.
fumble_forced_playerStringName of the defender credited with forcing the fumble.
fumble_forced_statInt32Fumble-forced stat value reported by CFBD (typically 1 per forced fumble).
fumble_player_idFloat64CFBD athlete_id of the player who fumbled.
fumble_playerStringName of the player who fumbled.
fumble_statInt32Fumble stat value reported by CFBD (typically 1 per fumble).
sack_player_idFloat64Comma-separated CFBD athlete_id(s) of the sacking defender(s).
sack_playerStringComma-separated name(s) of the sacking defender(s).
sack_statInt32Sack stat value reported by CFBD (sack credit can be split between defenders).
sack_taken_player_idFloat64CFBD athlete_id of the QB charged with taking the sack.
sack_taken_playerStringName of the QB charged with taking the sack.
sack_taken_statInt32Sack-taken stat value reported by CFBD (typically 1 per sack taken).
pass_breakup_player_idFloat64CFBD athlete_id of the defender credited with the pass breakup (PBU).
pass_breakup_playerStringName of the defender credited with the pass breakup (PBU).
pass_breakup_statInt32Pass breakup (PBU) stat value reported by CFBD (typically 1 per PBU).
field_goal_attempt_player_idStringCFBD athlete_id of the kicker attempting the field goal.
field_goal_attempt_playerStringName of the kicker attempting the field goal.
field_goal_attempt_statInt32Field goal attempt distance in yards reported by CFBD.
field_goal_made_player_idStringCFBD athlete_id of the kicker on a made field goal.
field_goal_made_playerStringName of the kicker on a made field goal.
field_goal_made_statInt32Made-field-goal distance in yards reported by CFBD.
field_goal_missed_player_idStringCFBD athlete_id of the kicker on a missed field goal.
field_goal_missed_playerStringName of the kicker on a missed field goal.
field_goal_missed_statInt32Missed-field-goal distance in yards reported by CFBD.
field_goal_blocked_player_idStringCFBD athlete_id of the defender credited with blocking the field goal.
field_goal_blocked_playerStringName of the defender credited with blocking the field goal.
field_goal_blocked_statInt32Blocked-field-goal distance in yards reported by CFBD.
penalty_flagBooleanTRUE when a penalty was flagged on the play.
penalty_declinedBooleanTRUE when the penalty was declined.
penalty_no_playBooleanTRUE when the penalty nullified the play (no play counted).
penalty_offsetBooleanTRUE when offsetting penalties were called.
penalty_textBooleanTRUE when penalty information is detectable in the play text.
penalty_play_textStringPenalty-related substring extracted from the play text.
load_cfb_pbp_r(seasons=2024)