CFB dataset loaders

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

Automation status

Dataset	Release tag	Pipeline
load_cfb_pbp	espn_cfb_pbp	—
load_cfb_ratings	cfb_ratings	—
load_cfb_recruiting_proj	cfb_recruiting_proj	—
load_cfb_recruits	cfb_recruits	—
load_cfb_returning_production	cfb_returning_production	—
load_cfb_rosters	espn_cfb_rosters	—
load_cfb_rosters_cfbd	cfbfastR-data	—
load_cfb_schedule	cfb_schedules	—
load_cfb_team_info	cfb_team_info	—
load_cfb_teams	espn_cfb_teams	—
load_cfb_team_talent	cfb_team_talent	—
load_cfb_teams_crosswalk	cfb_crosswalk	—
load_cfb_schedule_crosswalk	cfb_crosswalk	—
load_cfb_team_box	espn_cfb_team_box	—
load_cfb_player_box	espn_cfb_player_box	—
load_cfb_drives	espn_cfb_drives	—
load_cfb_play_participants	espn_cfb_play_participants	—
load_cfb_game_rosters	espn_cfb_game_rosters	—
load_cfb_linescores	espn_cfb_linescores	—
load_cfb_betting	espn_cfb_betting	—
load_cfb_fpi_weekly	cfb_fpi_weekly	—
load_cfb_power_index	espn_cfb_power_index	—
load_cfb_adv_team	espn_cfb_adv_team	—
load_cfb_adv_passing	espn_cfb_adv_passing	—
load_cfb_adv_rushing	espn_cfb_adv_rushing	—
load_cfb_adv_receiving	espn_cfb_adv_receiving	—
load_cfb_adv_defensive	espn_cfb_adv_defensive	—
load_cfb_adv_defensive_players	espn_cfb_adv_defensive_players	—
load_cfb_adv_drives	espn_cfb_adv_drives	—
load_cfb_adv_situational	espn_cfb_adv_situational	—
load_cfb_adv_specialists	espn_cfb_adv_specialists	—
load_cfb_adv_turnover	espn_cfb_adv_turnover	—
load_cfb_model_pbp	espn_cfb_model_pbp	—
load_cfb_passing	espn_cfb_passing	—
load_cfb_percentiles	espn_cfb_percentiles	—
load_cfb_receiving	espn_cfb_receiving	—
load_cfb_rushing	espn_cfb_rushing	—
load_cfb_team_summaries	espn_cfb_team_summaries	—
load_cfb_adv_team_gamelog	espn_cfb_adv_team_gamelog	—
load_cfb_ratings_weekly	cfb_ratings_weekly	—
load_cfb_team_summaries_weekly	cfb_team_summaries_weekly	—
load_cfb_pbp_r	cfbfastR_cfb_pbp	—
load_ncaa_mfb_pbp	ncaa_mfb_pbp	—
load_ncaa_mfb_pbp_cfbfastr	ncaa_mfb_pbp_cfbfastr	—
load_ncaa_mfb_drives	ncaa_mfb_drives	—
load_ncaa_mfb_schedule	ncaa_mfb_schedule	—
load_ncaa_mfb_rosters	ncaa_mfb_rosters	—
load_ncaa_mfb_teams	ncaa_mfb_teams	—
load_ncaa_mfb_team_stats	ncaa_mfb_team_stats	—
load_ncaa_mfb_player_stats	ncaa_mfb_player_stats	—
load_ncaa_mfb_officials	ncaa_mfb_officials	—
load_ncaa_mfb_linescore	ncaa_mfb_linescore	—

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_name	type	description
season	Int64	Season (4-digit year).
game_id	Int64	ESPN game identifier.
game_play_number	Int64	Sequential play number within the game (excludes timeouts/end markers).
pos_team	Int64	Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_team	Int64	Team name on defense at the start of the play.
pos_team_score	Int64	Score for the team in possession at the start of the play.
def_pos_team_score	Int64	Score for the defensive team at the start of the play.
half	Int64	Half indicator (1 or 2).
period	Int64	Period (quarter) number.
down	Int64	Down of the play (1-4).
distance	Int64	Yards to gain for a first down (or to the goal line in goal-to-go situations).
EPA	Float64	Expected Points Added on the play (cfbfastR EPA model output).
wpa	Float64	Win Probability Added on the play (cfbfastR WP model output).
wp_before	Float64	Win probability for the possession team before the play (0-1).
wp_after	Float64	Win probability for the possession team after the play (0-1).
def_wp_before	Float64	Win probability for the defensive team before the play (0-1).
def_wp_after	Float64	Win probability for the defensive team after the play (0-1).
penalty_detail	String	Parsed penalty description extracted from play text.
yds_penalty	String	Yardage assessed on the penalty.
penalty_1st_conv	Boolean	TRUE when the penalty resulted in a first down conversion.
def_EPA	Float64	EPA for the defensive team on the play (sign-flipped offense EPA).
rz_play	Boolean	Binary flag for a red-zone play (yards_to_goal <= 20).
scoring_opp	Boolean	Binary flag for a scoring opportunity (yards_to_goal <= 40).
middle_8	Boolean	TRUE for plays in the middle-8 window (final 4 min of 1H, first 4 min of 2H).
stuffed_run	Boolean	Binary flag for a stuffed run (zero or negative yards gained).
change_of_pos_team	Boolean	Binary flag for change of possession-team on the play.
downs_turnover	Boolean	Binary flag for a turnover on downs.
pos_score_diff_start	Int64	Score differential for the possession team at the start of the play.
pos_score_pts	Int64	Points scored on the play attributed to the possession team.
home_wp_before	Float64	Home team win probability before the play (0-1).
away_wp_before	Float64	Away team win probability before the play (0-1).
home_wp_after	Float64	Home team win probability after the play (0-1).
away_wp_after	Float64	Away team win probability after the play (0-1).
end_of_half	Boolean	Binary flag for the last play of a half.
lead_pos_team	Int64	Value of pos_team on the next play, used for sequence-aware derivations.
lead_play_type	String	Value of play_type on the next play, used for sequence-aware derivations.
lag_pos_team	Int64	Value of pos_team on the previous play, used for sequence-aware derivations.
orig_play_type	String	Original CFBD play type label before cfbfastR cleaning.
offense_score_play	Boolean	Binary flag for an offensive scoring play.
defense_score_play	Boolean	Binary flag for a defensive scoring play.
pos_score_diff	Int64	Score differential from the possession team's perspective.
change_of_poss	Boolean	Binary flag for change of possession on the play (CFBD offense field).
rusher_player_name	String	Name of the rusher on a rushing play.
yds_rushed	Int64	Rushing yards gained on the play.
passer_player_name	String	Name of the passer on a passing play.
receiver_player_name	String	Name of the receiver on a passing play.
yds_receiving	Int64	Receiving yards gained on the play.
yds_sacked	Int64	Yards lost on the sack.
sack_players	String	Combined names of all sack participants.
sack_player_name	String	Primary sack player name.
sack_player_name2	String	Secondary sack player name (when split between two defenders).
pass_breakup_player_name	String	Name of the defender credited with the pass breakup.
interception_player_name	String	Name of the defender credited with the interception.
yds_int_return	Int64	Yards gained on an interception return.
fumble_player_name	String	Name of the player who fumbled.
fumble_forced_player_name	String	Name of the player who forced the fumble.
fumble_recovered_player_name	String	Name of the player who recovered the fumble.
yds_fumble_return	Int64	Yards gained on a fumble return.
punter_player_name	String	Name of the punter.
yds_punted	Int64	Yards the ball traveled on the punt.
yds_punt_return	Int64	Yards gained on the punt return.
yds_punt_gained	Int64	Net yards gained on the punt (punt distance minus return).
punt_block_player_name	String	Name of the player credited with blocking the punt.
punt_block_return_player_name	String	Name of the player returning a blocked punt.
fg_kicker_player_name	String	Name of the field goal kicker.
yds_fg	Int64	Distance of the field goal attempt in yards.
fg_block_player_name	String	Name of the player credited with blocking the field goal.
fg_return_player_name	String	Name of the player returning the blocked/missed field goal.
kickoff_player_name	String	Name of the kickoff specialist.
yds_kickoff	Int64	Yards the ball traveled on the kickoff.
yds_kickoff_return	Int64	Yards gained on the kickoff return.
rush	Boolean	Binary flag for a rushing play.
rush_td	Boolean	Binary flag for a rushing touchdown.
pass	Boolean	Binary flag for a passing play (includes sacks).
pass_td	Boolean	Binary flag for a passing touchdown.
completion	Boolean	Binary flag for a completed pass.
pass_attempt	Boolean	Binary flag for a pass attempt.
target	Boolean	Binary flag for a targeted receiver on the play.
sack_vec	Boolean	Binary flag for a sack play.
sack	Boolean	Binary flag for a sack (duplicate of sack_vec for downstream use).
int	Boolean	Binary flag for an interception.
int_td	Boolean	Binary flag for an interception returned for a touchdown.
turnover_vec	Boolean	Binary flag for any play classified as a turnover.
kickoff_play	Boolean	Binary flag for a kickoff play.
scoring_play	Boolean	TRUE if the play resulted in a score.
td_play	Boolean	Binary flag for a touchdown play.
touchdown	Boolean	Binary flag for a touchdown (duplicate of td_play for downstream use).
safety	Boolean	Binary flag for a safety.
fumble_vec	Boolean	Binary flag for a play involving a fumble.
kickoff_tb	Boolean	Binary flag for a kickoff touchback.
kickoff_onside	Boolean	Binary flag for an onside kickoff attempt.
kickoff_oob	Boolean	Binary flag for a kickoff out of bounds.
kickoff_fair_catch	Boolean	Binary flag for a kickoff fair catch.
kickoff_downed	Boolean	Binary flag for a kickoff downed in the field of play.
kickoff_safety	Boolean	Binary flag for a kickoff safety.
kick_play	Boolean	Binary flag for any kicking play (kickoff or field goal).
punt	Boolean	Binary flag for a punt play.
punt_play	Boolean	Binary flag for any punt-related play (includes blocks/returns).
punt_tb	Boolean	Binary flag for a punt touchback.
punt_oob	Boolean	Binary flag for a punt out of bounds.
punt_fair_catch	Boolean	Binary flag for a punt fair catch.
punt_downed	Boolean	Binary flag for a punt downed in the field of play.
punt_safety	Boolean	Binary flag for a punt safety.
punt_blocked	Boolean	Binary flag for a blocked punt.
penalty_safety	Boolean	Binary flag for a safety scored on a penalty.
fg_made	Boolean	TRUE when the field goal attempt was successful.
fg_make_prob	Float64	Predicted probability of making the field goal (cfbfastR FG model, 0-1).
penalty_flag	Boolean	TRUE when a penalty was flagged on the play.
penalty_declined	Boolean	TRUE when the penalty was declined.
penalty_no_play	Boolean	TRUE when the penalty nullified the play (no play counted).
penalty_offset	Boolean	TRUE when offsetting penalties were called.
penalty_text	String	TRUE when penalty information is detectable in the play text.
lead_wp_before2	Float64	Value of wp_before 2 plays ahead, used for sequence-aware derivations.
lead_wp_before	Float64	Value of wp_before on the next play, used for sequence-aware derivations.
lead_pos_team2	Int64	Value of pos_team 2 plays ahead, used for sequence-aware derivations.
lag_change_of_pos_team	Boolean	Value of change_of_pos_team on the previous play, used for sequence-aware derivations.
lag_pos_score_diff	Int64	Value of pos_score_diff on the previous play, used for sequence-aware derivations.
id	Int64	247Sports referencing id for the recruit.
sequenceNumber	Int64	Broadcast sequence order number.
text	String	Full play description.
awayScore	Int64	Away team score after the goal.
homeScore	Int64	Home team score after the goal.
scoringPlay	Boolean	ESPN flag marking the play as a scoring play.
priority	Boolean	TRUE if ESPN flags the play as a priority highlight.
modified	String	ISO timestamp the play record was last modified.
wallclock	String	Real-world ISO timestamp of the play.
teamParticipants	String	Raw ESPN team-level participants payload carried through from the plays feed (stringified).
isPenalty	Boolean	ESPN's per-play flag that a penalty occurred on the play.
statYardage	Int64	Yardage ESPN credits to the play for statistical purposes.
isTurnover	Boolean	ESPN's per-play turnover flag as shipped in the plays feed (broader than the giveaway-based is_turnover derivation).
type.id	String	ESPN's numeric identifier for the play type.
type.text	String	ESPN's text label for the play type.
type.abbreviation	String	ESPN's abbreviation for the play type.
period.number	Int64	Period (quarter) number in which the play occurred.
clock.displayValue	String	Game clock at the play, as the displayed mm:ss string.
start.down	Int64	ESPN's down value for the play state at the start of the play.
start.distance	Int64	ESPN's distance value for the play state at the start of the play.
start.yardLine	Int64	ESPN's yardLine value for the play state at the start of the play.
start.yardsToEndzone	Int64	ESPN's yardsToEndzone value for the play state at the start of the play.
start.team.id	Int64	ESPN's team.id value for the play state at the start of the play.
end.down	Int64	ESPN's down value for the play state at the end of the play.
end.distance	Int64	ESPN's distance value for the play state at the end of the play.
end.yardLine	Int64	ESPN's yardLine value for the play state at the end of the play.
end.yardsToEndzone	Int64	ESPN's yardsToEndzone value for the play state at the end of the play.
end.downDistanceText	String	ESPN's downDistanceText value for the play state at the end of the play.
end.shortDownDistanceText	String	ESPN's shortDownDistanceText value for the play state at the end of the play.
end.possessionText	String	ESPN's possessionText value for the play state at the end of the play.
end.team.id	Int64	ESPN's team.id value for the play state at the end of the play.
start.downDistanceText	String	ESPN's downDistanceText value for the play state at the start of the play.
start.shortDownDistanceText	String	ESPN's shortDownDistanceText value for the play state at the start of the play.
start.possessionText	String	ESPN's possessionText value for the play state at the start of the play.
scoringType.name	String	ESPN's name for the scoring type (e.g. touchdown, field goal).
scoringType.displayName	String	ESPN's display label for the scoring type.
scoringType.abbreviation	String	ESPN's abbreviation for the scoring type.
pointAfterAttempt.id	Float64	ESPN identifier for the point-after attempt type on the scoring play.
pointAfterAttempt.text	String	ESPN description of the point-after attempt and its result.
pointAfterAttempt.abbreviation	String	ESPN abbreviation of the point-after attempt type; drives the extra-point / two-point result derivation.
pointAfterAttempt.value	Float64	Points ESPN credits for the point-after attempt (1.0 made extra point, 2.0 made two-point try).
drive.id	String	ESPN's id field for the drive containing this play.
drive.displayResult	String	ESPN's displayResult field for the drive containing this play.
drive.isScore	Boolean	ESPN's isScore field for the drive containing this play.
drive.team.shortDisplayName	String	ESPN's team.shortDisplayName field for the drive containing this play.
drive.team.displayName	String	ESPN's team.displayName field for the drive containing this play.
drive.team.name	String	ESPN's team.name field for the drive containing this play.
drive.team.abbreviation	String	ESPN's team.abbreviation field for the drive containing this play.
drive.yards	Int64	ESPN's yards field for the drive containing this play.
drive.offensivePlays	Int64	ESPN's offensivePlays field for the drive containing this play.
drive.result	String	ESPN's result field for the drive containing this play.
drive.description	String	ESPN's description field for the drive containing this play.
drive.shortDisplayResult	String	ESPN's shortDisplayResult field for the drive containing this play.
drive.timeElapsed.displayValue	String	ESPN's timeElapsed.displayValue field for the drive containing this play.
drive.start.period.number	Int64	ESPN's start.period.number field for the drive containing this play.
drive.start.period.type	String	ESPN's start.period.type field for the drive containing this play.
drive.start.yardLine	Int64	ESPN's start.yardLine field for the drive containing this play.
drive.start.clock.displayValue	String	ESPN's start.clock.displayValue field for the drive containing this play.
drive.start.text	String	ESPN's start.text field for the drive containing this play.
drive.end.period.number	Int64	ESPN's end.period.number field for the drive containing this play.
drive.end.period.type	String	ESPN's end.period.type field for the drive containing this play.
drive.end.yardLine	Int64	ESPN's end.yardLine field for the drive containing this play.
drive.end.clock.displayValue	String	ESPN's end.clock.displayValue field for the drive containing this play.
seasonType	Int64	ESPN season type for the game (2 = regular season, 3 = postseason).
week	Int64	Game week of the season.
status_type_completed	Boolean	Whether the game is complete.
homeTeamId	Int64	ESPN's home-team Id for the game, stamped on every play.
awayTeamId	Int64	ESPN's away-team Id for the game, stamped on every play.
homeTeamName	String	ESPN's home-team Name for the game, stamped on every play.
awayTeamName	String	ESPN's away-team Name for the game, stamped on every play.
homeTeamMascot	String	ESPN's home-team Mascot for the game, stamped on every play.
awayTeamMascot	String	ESPN's away-team Mascot for the game, stamped on every play.
homeTeamAbbrev	String	ESPN's home-team Abbrev for the game, stamped on every play.
awayTeamAbbrev	String	ESPN's away-team Abbrev for the game, stamped on every play.
homeTeamNameAlt	String	ESPN's home-team NameAlt for the game, stamped on every play.
awayTeamNameAlt	String	ESPN's away-team NameAlt for the game, stamped on every play.
gameSpread	Float64	Point spread used as an input to the win-probability model.
homeFavorite	Boolean	True when the home team was favoured by the spread.
gameSpreadAvailable	Boolean	True when a spread was available for the game.
overUnder	Float64	Over/under total used as a model input.
homeTeamSpread	Float64	ESPN's home-team Spread for the game, stamped on every play.
clock.minutes	Int64	Minutes remaining on the game clock at the play.
clock.seconds	Int64	Seconds component of the game clock at the play.
lag_half	Int64	Value of half on the previous play, used for sequence-aware derivations.
lead_half	Int64	Value of half on the next play, used for sequence-aware derivations.
start.TimeSecsRem	Int64	ESPN's TimeSecsRem value for the play state at the start of the play.
start.adj_TimeSecsRem	Int64	ESPN's adj_TimeSecsRem value for the play state at the start of the play.
lead_text	String	Value of text on the next play, used for sequence-aware derivations.
lead_start_team	String	Value of start_team on the next play, used for sequence-aware derivations.
lead_start_yardsToEndzone	Int64	Value of start_yardsToEndzone on the next play, used for sequence-aware derivations.
lead_start_down	Int64	Value of start_down on the next play, used for sequence-aware derivations.
lead_start_distance	Int64	Value of start_distance on the next play, used for sequence-aware derivations.
lead_scoringPlay	Boolean	Value of scoringPlay on the next play, used for sequence-aware derivations.
text_dupe	Boolean	True when the play description duplicates the previous row's text.
end_state_missing	Boolean	Flag that ESPN's end-of-play state (end.team.id) was absent and the end state was imputed.
start.pos_team.id	Int64	ESPN's pos_team.id value for the play state at the start of the play.
start.def_pos_team.id	Int64	ESPN's def_pos_team.id value for the play state at the start of the play.
end.def_pos_team.id	Int64	ESPN's def_pos_team.id value for the play state at the end of the play.
end.pos_team.id	Int64	ESPN's pos_team.id value for the play state at the end of the play.
start.pos_team.name	String	ESPN's pos_team.name value for the play state at the start of the play.
start.def_pos_team.name	String	ESPN's def_pos_team.name value for the play state at the start of the play.
end.pos_team.name	String	ESPN's pos_team.name value for the play state at the end of the play.
end.def_pos_team.name	String	ESPN's def_pos_team.name value for the play state at the end of the play.
start.is_home	Boolean	ESPN's is_home value for the play state at the start of the play.
end.is_home	Boolean	ESPN's is_home value for the play state at the end of the play.
homeTimeoutCalled	Boolean	True when the home team called a timeout on the play.
awayTimeoutCalled	Boolean	True when the away team called a timeout on the play.
end.homeTeamTimeouts	Int64	ESPN's homeTeamTimeouts value for the play state at the end of the play.
end.awayTeamTimeouts	Int64	ESPN's awayTeamTimeouts value for the play state at the end of the play.
start.homeTeamTimeouts	Int64	ESPN's homeTeamTimeouts value for the play state at the start of the play.
start.awayTeamTimeouts	Int64	ESPN's awayTeamTimeouts value for the play state at the start of the play.
end.TimeSecsRem	Int64	ESPN's TimeSecsRem value for the play state at the end of the play.
end.adj_TimeSecsRem	Int64	ESPN's adj_TimeSecsRem value for the play state at the end of the play.
start.posTeamTimeouts	Int64	ESPN's posTeamTimeouts value for the play state at the start of the play.
start.defPosTeamTimeouts	Int64	ESPN's defPosTeamTimeouts value for the play state at the start of the play.
end.posTeamTimeouts	Int64	ESPN's posTeamTimeouts value for the play state at the end of the play.
end.defPosTeamTimeouts	Int64	ESPN's defPosTeamTimeouts value for the play state at the end of the play.
firstHalfKickoffTeamId	Int64	ESPN id of the team that received the opening kickoff.
start.yard	Int64	ESPN's yard value for the play state at the start of the play.
end.yard	Int64	ESPN's yard value for the play state at the end of the play.
lag_scoringPlay	Boolean	Value of scoringPlay on the previous play, used for sequence-aware derivations.
down_1	Boolean	True when it is 1st down at the start of the play.
down_2	Boolean	True when it is 2nd down at the start of the play.
down_3	Boolean	True when it is 3rd down at the start of the play.
down_4	Boolean	True when it is 4th down at the start of the play.
down_1_end	Boolean	True when it is 1st down at the end of the play.
down_2_end	Boolean	True when it is 2nd down at the end of the play.
down_3_end	Boolean	True when it is 3rd down at the end of the play.
down_4_end	Boolean	True when it is 4th down at the end of the play.
td_check	Boolean	Internal flag used while reconciling whether the play produced a touchdown.
forced_fumble	Boolean	True when the defense forced a fumble on the play.
is_home	Boolean	Whether the subject team was the home team.
lag_HA_score_diff	Int64	Value of HA_score_diff on the previous play, used for sequence-aware derivations.
HA_score_diff	Int64	Home score minus away score for the play.
net_HA_score_pts	Int64	Net points the play added to the home-minus-away score margin.
H_score_diff	Int64	Home team's score minus the away team's, from the home perspective.
A_score_diff	Int64	Away team's score minus the home team's, from the away perspective.
lag_homeScore	Int64	Value of homeScore on the previous play, used for sequence-aware derivations.
lag_awayScore	Int64	Value of awayScore on the previous play, used for sequence-aware derivations.
start.homeScore	Int64	ESPN's homeScore value for the play state at the start of the play.
start.awayScore	Int64	ESPN's awayScore value for the play state at the start of the play.
end.homeScore	Int64	ESPN's homeScore value for the play state at the end of the play.
end.awayScore	Int64	ESPN's awayScore value for the play state at the end of the play.
start.pos_team_score	Int64	ESPN's pos_team_score value for the play state at the start of the play.
start.def_pos_team_score	Int64	ESPN's def_pos_team_score value for the play state at the start of the play.
start.pos_score_diff	Int64	ESPN's pos_score_diff value for the play state at the start of the play.
end.pos_team_score	Int64	ESPN's pos_team_score value for the play state at the end of the play.
end.def_pos_team_score	Int64	ESPN's def_pos_team_score value for the play state at the end of the play.
end.pos_score_diff	Int64	ESPN's pos_score_diff value for the play state at the end of the play.
start.pos_team_receives_2H_kickoff	Boolean	ESPN's pos_team_receives_2H_kickoff value for the play state at the start of the play.
end.pos_team_receives_2H_kickoff	Boolean	ESPN's pos_team_receives_2H_kickoff value for the play state at the end of the play.
penalty_in_text	Boolean	True when the play description mentions a penalty.
pass_breakup	Boolean	True when a defender broke up the pass.
pass_depth	String	Thrown-pass depth parsed from ESPN play text ("short" or "deep"); null when the text omits it (sacks, screens, pre-2025 text).
pass_direction	String	Pass direction parsed from ESPN play text ("left", "middle", or "right"); null when the text omits it.
rush_direction	String	Rush direction parsed from ESPN play text ("left", "middle", or "right"); null when the text omits it.
qb_hurry	Boolean	Whether ESPN's play text says the quarterback was hurried into the throw ("hurried by ...").
fg_attempt	Boolean	True when the play was a field-goal attempt.
pos_unit	String	Possession-team unit label (offense or special teams).
def_pos_unit	String	Defensive possession-team unit label (defense or special teams).
sp	Boolean	Binary indicator for whether or not a score occurred on the play.
play	Boolean	Binary flag indicating the row is a counted play (excludes end markers/timeouts/penalties).
cleaned_text	String	Play description with overturned-call prefixes stripped; the text the name and team extractors run against.
kneel_down	Boolean	Whether the play is an offensive kneel, from explicit kneel text plus an end-of-half TEAM-rush heuristic.
scrimmage_play	Boolean	True when the play is a play from scrimmage rather than a special-teams or administrative row.
pos_score_diff_end	Int64	Score differential from the possessing team's perspective at the end of the play.
fumble_lost	Boolean	Binary indicator for if the fumble was lost.
fumble_recovered	Boolean	True when a fumble on the play was recovered.
field_goal_result	String	String indicator for result of field goal attempt: made, missed, or blocked.
extra_point_result	String	String 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_result	String	String result of the two-point conversion attempt: success, failure, or safety (touchback in the defensive end zone).
air_yardsToEndzone	Int64	Yards to the endzone at the catch spot, parsed from the 2025+ vendor catch-spot text; null before 2025 or when unresolvable.
air_yards	Int64	Numeric 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_catch	Int64	Numeric value for distance in yards perpendicular to the yard line where the receiver made the reception to where the play ended.
kicking_team	Int64	Team id of the kicking team on kickoff, punt, and field-goal plays.
return_team	Int64	Team id of the returning side; set on interception, fumble, kickoff, punt, and blocked-kick returns.
fumble_or_muff	Boolean	Whether the play includes a fumble or a muffed kick or punt (widened beyond ESPN's fumble play types).
recovery_team	Int64	Team id parsed from the play text as recovering the fumble or muff.
recovery_team_2	Int64	Team id of the second recovery in a multi-recovery scramble, parsed from the play text.
fumbling_team	Int64	Team id of the side that fumbled or muffed the ball, parsed from the play text.
int_turnover	Boolean	Whether the play is an interception giveaway.
pos_fumble_lost	Boolean	Whether the possession team fumbled and lost the ball.
def_fumble_lost	Boolean	Whether the defending team (e.g. a returner after a takeaway) fumbled and lost the ball back.
is_pos_team_turnover	Boolean	Whether the possession team committed a giveaway (interception or fumble lost).
is_def_pos_team_turnover	Boolean	Whether the defending team gave the ball back via a lost fumble.
is_turnover	Boolean	True when the play is a giveaway-based turnover (interception thrown or fumble lost); blocked kicks recovered by the defense are carried by the blocked-kick fields instead.
turnover_team	Int64	Team id charged with the giveaway on the play.
is_st_turnover	Boolean	Whether the giveaway happened on a special-teams play (kick or punt snap, or a return).
is_blocked_punt_turnover	Boolean	Blocked-punt possession loss (blocked-punt TD, or the defense recovered); kept out of is_turnover to match ESPN's giveaway-only box.
is_blocked_fg_turnover	Boolean	Blocked-field-goal possession loss (blocked-FG TD, or the defense recovered); kept out of is_turnover to match ESPN's giveaway-only box.
sack_team	Int64	Team id credited with the sack (the defense).
interception_team	Int64	Team id credited with the interception (the defense).
pass_breakup_team	Int64	Team id credited with the pass breakup (the defense).
forced_fumble_team	Int64	Team id credited with forcing the fumble -- the side opposite the fumbling player (the covering team on returns).
fumble_recovery_team	Int64	Team id that recovered the fumble or muff, from parsed text with a giveaway / own-recovery fallback.
punt_return_team	Int64	Team id of the punt-returning side.
kick_return_team	Int64	Team id of the kick-returning side.
fg_team	Int64	Team id attempting the field goal (the kicking team).
punt_team	Int64	Team id punting the ball (the kicking team).
penalized_team	Int64	Team id the penalty was assessed against, from the home/away text resolver with a foul-direction fallback.
penalty_yards_signed	Int64	Penalty yardage parsed from the play text with era-aware bounds; the printed sign is retained but is not a reliable enforcement direction.
new_down	Int64	Down after the play, including any penalty enforcement.
new_distance	Int64	Distance to go after the play, including any penalty enforcement.
under_2	Boolean	Whether the play began with two minutes or less remaining in the half.
goal_to_go	Boolean	Binary indicator for whether or not the posteam is in a goal down situation.
stopped_run	Boolean	True when the rush was stopped at or behind the line of scrimmage.
opportunity_run	Boolean	True 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_run	Boolean	True when the rush gained 8 or more yards.
adj_rush_yardage	Int64	Rushing yards capped at 8, the input to the line-yards decomposition.
line_yards	Float64	Yards 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_yards	Float64	Rushing yards earned from 4 to 8, split evenly between line and carrier under the line-yards decomposition.
open_field_yards	Int64	Rushing yards gained beyond 8, credited to the ball carrier rather than the line.
highlight_yards	Float64	Second-level plus open-field yards -- the yardage credited to the carrier.
opp_highlight_yards	Float64	Highlight 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_success	Boolean	True when a short-yardage rush gained the yardage needed.
short_rush_attempt	Boolean	True when the play is a rush in a short-yardage situation.
power_rush_success	Boolean	True when a power rushing attempt gained the yardage needed.
power_rush_attempt	Boolean	True when the play is a short-yardage power rushing attempt.
early_down	Boolean	True when the play is a scrimmage play on first or second down.
late_down	Boolean	True when the play is a scrimmage play on third or fourth down.
early_down_pass	Boolean	True when the play is a pass on an early down.
early_down_rush	Boolean	True when the play is a rush on an early down.
late_down_pass	Boolean	True when the play is a pass on a late down.
late_down_rush	Boolean	True when the play is a rush on a late down.
standard_down	Boolean	True 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_down	Boolean	True when the offense is behind schedule for the series -- second down needing 8 or more, or third/fourth down needing 5 or more.
TFL	Boolean	True when the play was a tackle for loss.
TFL_pass	Boolean	True when the play was a tackle for loss on a pass play (a sack).
TFL_rush	Boolean	True when the play was a tackle for loss on a rush play.
havoc	Boolean	True when the defense disrupted the play: a pass breakup, tackle for loss, interception or forced fumble.
start.pos_team_spread	Float64	ESPN's pos_team_spread value for the play state at the start of the play.
start.elapsed_share	Float64	ESPN's elapsed_share value for the play state at the start of the play.
start.spread_time	Float64	ESPN's spread_time value for the play state at the start of the play.
end.pos_team_spread	Float64	ESPN's pos_team_spread value for the play state at the end of the play.
end.elapsed_share	Float64	ESPN's elapsed_share value for the play state at the end of the play.
end.spread_time	Float64	ESPN's spread_time value for the play state at the end of the play.
penalty_assessed_on_kickoff	Boolean	Whether a penalty was assessed on a kickoff; such plays take the kickoff/touchback win-probability handling.
start.yardsToEndzone.touchback	Int64	ESPN's yardsToEndzone.touchback value for the play state at the start of the play.
EP_start_touchback	Float64	Expected points the offense would have had from a touchback on this play.
EP_start	Float64	Expected points for the offense at the start of the play.
EP_end	Float64	Expected points for the offense at the end of the play.
lag_EP_end	Float64	Value of EP_end on the previous play, used for sequence-aware derivations.
EP_between	Float64	Change in expected points across the play, before penalty adjustment.
EPA_scrimmage	Float64	EPA credited to the play on plays from scrimmage.
EPA_rush	Float64	EPA credited to the play on rush plays.
EPA_pass	Float64	EPA credited to the play on pass plays.
EPA_explosive	Boolean	True when the play was explosive.
EPA_non_explosive	Float64	EPA credited to the play on non-explosive plays.
EPA_explosive_pass	Boolean	True when the pass play was explosive.
EPA_explosive_rush	Boolean	True when the rush play was explosive.
first_down_created	Boolean	True when the play produced a first down for the offense.
EPA_success	Boolean	True when the play was successful by EPA.
EPA_success_early_down	Boolean	True when the play on an early down was successful by EPA.
EPA_success_early_down_pass	Boolean	True when the pass play on an early down was successful by EPA.
EPA_success_early_down_rush	Boolean	True when the rush play on an early down was successful by EPA.
EPA_success_late_down	Boolean	True when the play on a late down was successful by EPA.
EPA_success_late_down_pass	Boolean	True when the pass play on a late down was successful by EPA.
EPA_success_late_down_rush	Boolean	True when the rush play on a late down was successful by EPA.
EPA_success_standard_down	Boolean	True when the play on a standard down was successful by EPA.
EPA_success_passing_down	Boolean	True when the play on a passing down was successful by EPA.
EPA_success_pass	Boolean	True when the pass play was successful by EPA.
EPA_success_rush	Boolean	True when the rush play was successful by EPA.
EPA_success_EPA	Float64	EPA on successful plays.
EPA_success_standard_down_EPA	Float64	EPA on successful plays on a standard down.
EPA_success_passing_down_EPA	Float64	EPA on successful plays on a passing down.
EPA_success_pass_EPA	Float64	EPA on successful pass plays.
EPA_success_rush_EPA	Float64	EPA on successful rush plays.
EPA_middle_8_success	Boolean	True when the play in the middle eight was successful by EPA.
EPA_middle_8_success_pass	Boolean	True when the pass play in the middle eight was successful by EPA.
EPA_middle_8_success_rush	Boolean	True when the rush play in the middle eight was successful by EPA.
EPA_penalty	Float64	EPA credited to the play attributable to penalties.
EPA_sp	Float64	EPA credited to the play on special-teams plays.
EPA_fg	Float64	EPA credited to the play on field-goal attempts.
EPA_punt	Float64	EPA credited to the play on punt plays.
EPA_kickoff	Float64	EPA credited to the play on kickoff plays.
start.ExpScoreDiff_touchback	Float64	ESPN's ExpScoreDiff_touchback value for the play state at the start of the play.
start.ExpScoreDiff	Float64	ESPN's ExpScoreDiff value for the play state at the start of the play.
start.ExpScoreDiff_Time_Ratio_touchback	Float64	ESPN's ExpScoreDiff_Time_Ratio_touchback value for the play state at the start of the play.
start.ExpScoreDiff_Time_Ratio	Float64	ESPN's ExpScoreDiff_Time_Ratio value for the play state at the start of the play.
end.ExpScoreDiff	Float64	ESPN's ExpScoreDiff value for the play state at the end of the play.
end.ExpScoreDiff_Time_Ratio	Float64	ESPN's ExpScoreDiff_Time_Ratio value for the play state at the end of the play.
wp_touchback	Float64	Win probability the offense would have had starting from a touchback.
wp_before_naive	Float64	Pre-snap possession-team win probability from the spread-free (naive) WP model.
wp_touchback_naive	Float64	Naive-model win probability for the kickoff-touchback substitute state, used as the pre-snap WP on kickoffs.
wp_after_naive	Float64	End-of-play possession-team win probability from the naive model, after the game-logic adjustment chain.
def_wp_before_naive	Float64	Pre-snap defense win probability under the naive model (1 - wp_before_naive).
home_wp_before_naive	Float64	Pre-snap naive win probability mapped to the home team.
away_wp_before_naive	Float64	Pre-snap naive win probability mapped to the away team.
lead_wp_before_naive	Float64	Next play's pre-snap naive win probability, used in the end-of-half and change-of-possession adjustments.
lead_wp_before2_naive	Float64	Pre-snap naive win probability two plays ahead, used where the immediately following row is a non-play.
def_wp_after_naive	Float64	End-of-play defense win probability under the naive model.
home_wp_after_naive	Float64	End-of-play naive win probability mapped to the home team.
away_wp_after_naive	Float64	End-of-play naive win probability mapped to the away team.
wpa_naive	Float64	Win probability added on the play under the spread-free (naive) model.
cp	Float64	Numeric value indicating the probability for a complete pass based on comparable game situations.
cpoe	Float64	For 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.
era	Int64	one of pre2018 (2006-2017) or post2018 (2018+)
xpass	Float64	Probability of dropback scaled from 0 to 1.
pass_oe	Float64	Dropback percent over expected on a given play scaled from 0 to 100.
drive_start	Float64	Yard line at which the drive began.
drive_stopped	Boolean	True when the play ended the drive.
drive_play_index	Int64	Sequence number of the play within its drive.
drive_offense_plays	Int64	Offensive plays run on the drive.
prog_drive_EPA	Float64	Cumulative EPA accrued by the drive up to and including this play.
prog_drive_WPA	Float64	Cumulative win-probability added by the drive up to and including this play.
drive_offense_yards	Int64	Offensive yards gained on the drive.
drive_total_yards	Int64	Total yards gained on the drive.
qbr_epa	Float64	EPA variant used as an input to the QBR calculation.
weight	Float64	Listed weight (lbs).
non_fumble_sack	Boolean	True when the play was a sack that did not produce a fumble.
sack_epa	Float64	EPA credited to the play when it is a sack.
pass_epa	Float64	EPA credited to the play when it is a pass.
rush_epa	Float64	EPA credited to the play when it is a rush.
pen_epa	Float64	EPA attributable to a penalty on the play.
sack_weight	Float64	Weighting applied to the sack component of the play.
pass_weight	Float64	Weighting applied to the pass component of the play.
rush_weight	Float64	Weighting applied to the rush component of the play.
pen_weight	Float64	Weighting applied to the penalty component of the play.
action_play	Boolean	True when the play advanced the game state -- excludes timeouts, end-of-period markers and other non-action rows.
athlete_name	String	Player full name.
rusher_player_id	Int64	Unique identifier for the player that attempted the run.
passer_player_id	Int64	Unique identifier for the player that attempted the pass.
receiver_player_id	Int64	Unique identifier for the receiver that was targeted on the pass.
fumble_player_id	Int64	CFBD athlete_id of the player who fumbled.
sack_player_id	Int64	Comma-separated CFBD athlete_id(s) of the sacking defender(s).
sack_player_id2	Int64	ESPN athlete id of the second sacker on a split sack (regex fallback for an ESPN sidecar blind spot).
interception_player_id	Int64	CFBD athlete_id of the defender credited with an interception.
pass_breakup_player_id	Int64	CFBD athlete_id of the defender credited with the pass breakup (PBU).
fumble_forced_player_id	Int64	CFBD athlete_id of the defender credited with forcing the fumble.
fumble_recovered_player_id	Int64	CFBD athlete_id of the player recovering the fumble.
fg_kicker_player_id	Int64	ESPN athlete id of the field-goal kicker.
punter_player_id	Int64	Unique identifier for the punter.
kickoff_player_id	Int64	ESPN athlete id of the player kicking off.
kickoff_return_player_id	Int64	ESPN athlete id of the kickoff returner.
punt_return_player_id	Int64	ESPN athlete id of the punt returner.
fg_block_player_id	Int64	ESPN athlete id of the player who blocked the field goal.
punt_block_player_id	Int64	ESPN athlete id of the player who blocked the punt.
fg_return_player_id	Int64	ESPN athlete id of the player who returned the blocked or missed field goal.
punt_block_return_player_id	Null	ESPN athlete id of the player who returned the blocked punt.
go_wp	Float64	Win probability from going for it on fourth down: conversion-probability-weighted mean of the success and failure states (cfb4th port).
first_down_prob	Float64	Modeled probability of converting the fourth down when going for it.
wp_succeed	Float64	Mean win probability across yardage outcomes given the fourth-down attempt converts.
wp_fail	Float64	Mean win probability given the fourth-down attempt fails.
make_fg_wp	Float64	Win probability given the field-goal attempt is made.
miss_fg_wp	Float64	Win probability given the field-goal attempt misses.
fg_wp	Float64	Make-probability-weighted win probability of attempting the field goal.
punt_wp	Float64	Win probability of punting, from the bundled punt-outcome distribution.
go_boost	Float64	cfb4th's headline number: 100 * (go_wp - max(fg_wp, punt_wp)), in percentage points.
go_wp_diff	Float64	go_wp minus the recommended option's WP (0 when going for it is the recommendation, otherwise <= 0).
fg_wp_diff	Float64	fg_wp minus the recommended option's WP (0 when the field goal is the recommendation, otherwise <= 0).
punt_wp_diff	Float64	punt_wp minus the recommended option's WP (0 when punting is the recommendation, otherwise <= 0).
fourth_down_recommendation	String	Max-WP fourth-down choice among "go", "punt", and "field_goal".
two_pt_wp	Float64	Win probability of going for two: conversion-probability-weighted mean of the 2-point and 0-point outcomes (cfb4th port).
xp_wp	Float64	Win probability of kicking the extra point, weighting the make by the empirical CFB extra-point make rate.
prob_2pt	Float64	Two-point conversion probability from the bundled CFB two-point model.
two_pt_recommendation	String	Point-after recommendation: "go_for_2" when two_pt_wp exceeds xp_wp, otherwise "kick_xp".
two_pt_wp_diff	Float64	two_pt_wp minus xp_wp; positive favors going for two.

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_name	type	description
season	Int64	Season (4-digit year).
team_id	Int64	ESPN team id.
adj_off_epa	Float64	Opponent-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_epa	Float64	Opponent-adjusted EPA per play allowed, netted the same way as the offensive rating, so lower is better because it measures EPA surrendered.
adj_st_epa	Float64	Special-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_net	Float64	adj_off_epa minus adj_def_epa, the team's overall efficiency rating in EPA per play; special teams is deliberately excluded.
fei_off	Float64	Drive-level offensive rating from a ridge fit on per-drive EPA, the Fremeau-style drive-efficiency counterpart to adj_off_epa.
fei_def	Float64	Drive-level defensive rating from the same per-drive ridge fit, on the same scale as fei_off.
fei_net	Float64	fei_off minus fei_def, the team's overall drive-efficiency rating, with the ridge's dropped reference team pinned at zero.
games	Int64	Number of games included in the ATS summary.
off_pace	Float64	Tempo measure: scrimmage plays (pass plus rush) per game, centering near 65 and used as the pace input to the totals model.
off_rank	Int64	Dense rank of adj_off_epa in descending order, so rank 1 is the season's most efficient offense.
def_rank	Int64	Dense rank of adj_def_epa in ascending order, so rank 1 is the season's stingiest defense.
net_rank	Int64	Dense rank of adj_net in descending order, so rank 1 is the season's strongest overall team.
net_z	Float64	adj_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_name	type	description
season	Int64	Season (4-digit year).
team_id	Int64	ESPN team id.
pred_wins	Float64	Ridge 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_margin	Float64	Ridge projection of the team's average per-game scoring margin, from the same preseason-known feature set as pred_wins.
pred_net_epa	Float64	Reserved 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_recruits

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

Returns

col_name	type	description
season	Int64	Season (4-digit year).
team_id	Int64	ESPN team id.
team_id_247	String	247Sports' own team key for the recruit's committed or signed school; not interchangeable with the ESPN/CFBD team id.
team	String	Team name.
recruit_id	String	ESPN recruit id.
player_name	String	Full name of player
stars	Int64	Recruit star rating on the 247Sports scale (2-5).
grade	Float64	ESPN recruit grade (0-100; 0 = not rated).
position	String	Athlete position.

load_cfb_recruits(seasons=2024)

load_cfb_returning_production

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

Returns

col_name	type	description
season	Int64	Season (4-digit year).
team_id	Int64	ESPN team id.
off_returning	Float64	Share of the team's prior-season offensive production returning for the season.
def_returning	Float64	Share of the team's prior-season defensive production returning for the season.
overall_returning	Float64	Usage-weighted blend of the offensive and defensive returning-production shares.
n_returning	Int64	Number of returning players counted in the returning-production calculation.

load_cfb_returning_production(seasons=2024)

load_cfb_rosters

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

Returns

col_name	type	description
season	Int64	Season the roster row describes. One row per athlete per team per season, so a transfer appears once under each team.
team_id	Int64	ESPN team identifier, the join key to cfb_teams, cfb_schedules and the pbp datasets.
athlete_id	Int64	ESPN athlete identifier, stable across seasons and teams -- the key for following a player through a career or a transfer.
division	String	NCAA classification of the athlete's team that season (fbs, fcs, d2, d3, d2_d3, naia), resolved from ESPN's group tree by the same map the teams dataset uses.
position_id	Int64	ESPN's numeric position identifier, resolved against the league's 74-entry position reference rather than left as a bare URL.
position	String	Human-readable position, e.g. Quarterback or Nose Tackle. Resolved from the position reference, which is why this is populated rather than href-only as on the older published assets.
position_abbreviation	String	Short position code, e.g. QB or NT -- the form most box-score and depth-chart joins expect.
position_name	String	ESPN's canonical position name from the reference table; usually matches position, and kept so a caller can see the raw reference value.
position_leaf	Boolean	Whether the position sits at the bottom of ESPN's position tree. False means it is a grouping such as Offensive Line rather than a specific role.
position_parent_id	Int64	Identifier of the broader position group above this one, letting you roll specific roles up to offense/defense buckets.
games_rostered	Int64	Number of that season's games whose roster block listed the athlete. The dataset is compiled per game, so this doubles as an availability signal -- a low count means a late arrival, injury or departure.
athlete_uid	String	ESPN's fully-qualified resource key for the athlete. Traceability back to the source payload; athlete_id is the practical key.
athlete_guid	String	Opaque ESPN global identifier for the athlete record.
athlete_type	String	ESPN's athlete category, effectively always the football player type in this dataset.
first_name	String	Athlete's given name as ESPN records it.
middle_name	String	Athlete's middle name where ESPN carries one; null for most rows.
last_name	String	Athlete's family name as ESPN records it. Beware suffixes -- ESPN sometimes folds Jr./III into this field.
full_name	String	ESPN's assembled full name for the athlete.
display_name	String	Name ESPN shows in most surfaces, generally first plus last.
athlete_display_name	String	ESPN's display name taken from the athlete record itself, which can differ in punctuation or suffix handling from display_name.
short_name	String	Abbreviated name ESPN uses where space is tight, typically first initial plus surname.
nickname	String	Alternate short label ESPN carries for the athlete; sparsely populated.
slug	String	URL fragment ESPN uses for the athlete on espn.com.
jersey	String	Jersey number as text, because ESPN publishes it that way and numbers can carry a leading zero. Cast before doing arithmetic.
jersey_right	String	Right-aligned jersey rendering ESPN publishes for tabular display; cosmetic rather than analytic.
weight	Float64	Listed weight in pounds. Null where ESPN has no figure, which is common outside Division I.
display_weight	String	Weight as ESPN renders it for display, e.g. 215 lbs.
height	Float64	Listed height in inches. Null where ESPN has no figure.
display_height	String	Height as ESPN renders it for display, e.g. 6' 3".
age	Float64	Athlete's age as of the payload capture, not as of any particular game. Treat it as approximate.
date_of_birth	String	Birth date ESPN publishes, as text. Sparsely populated and worth validating before use.
hand_type	String	Handedness ESPN records, mostly meaningful for quarterbacks and kickers.
hand_abbreviation	String	Short form of the handedness value, e.g. R or L.
hand_display_value	String	Handedness as ESPN renders it for display.
linked	Boolean	ESPN's flag for whether the athlete record links to a fuller profile.
active	Boolean	ESPN's active flag on the athlete record. It reflects capture time, not the season, so do not use it as a season-eligibility filter.
alternate_ids_sdr	String	ESPN's secondary SDR identifier for the athlete, occasionally needed to reconcile against other ESPN feeds.
birth_place_city	String	City ESPN lists as the athlete's birthplace.
birth_place_state	String	State or province of the athlete's birthplace.
birth_place_country	String	Country of the athlete's birthplace.
birth_country_alternate_id	String	ESPN's alternate identifier for the birth country.
birth_country_abbreviation	String	Abbreviated birth-country code as ESPN publishes it.
citizenship	String	Citizenship ESPN records for the athlete; sparsely populated and mostly present for international players.
flag_href	String	URL of the flag image ESPN pairs with the athlete's citizenship.
flag_alt	String	Alt text ESPN publishes for that flag image.
flag_rel	String	Relationship hints ESPN attaches to the flag image, stringified from a list.
headshot_href	String	URL of the athlete's headshot on ESPN's CDN. Null for most non-FBS players.
headshot_alt	String	Alt text ESPN publishes for the headshot image.
experience_years	Float64	Years of collegiate experience ESPN credits the athlete with, which is closer to class standing than to seasons played.
experience_display_value	String	Experience as ESPN renders it, e.g. Sophomore or Freshman.
experience_abbreviation	String	Short form of the experience value, e.g. SO or FR.
status_id	String	Identifier of the athlete's roster status in ESPN's status vocabulary.
status_name	String	Roster status as ESPN names it, e.g. Active. Reflects capture time rather than a point in the season.
status_type	String	ESPN's coarse grouping for the status value.
status_abbreviation	String	Short form of the roster status.
draft_display_text	String	ESPN's rendered draft summary for the athlete where one exists, e.g. round and pick. Populated only for players who reached the NFL draft.
draft_round	String	Round the athlete was drafted in, as text. Null for the overwhelming majority of rows.
draft_year	String	Year the athlete was drafted, as text.
draft_selection	String	Overall selection number in that draft, as text.
draft_team_href	String	URL of the drafting team's ESPN resource, from which the team can be resolved.
team_guid	String	Opaque ESPN global identifier of the athlete's team, denormalised onto the roster row.
team_uid	String	ESPN's fully-qualified resource key for the team.
team_slug	String	URL fragment ESPN uses for the team.
team_location	String	School or city ESPN attaches to the team, denormalised for convenience.
team_name	String	Team nickname as ESPN stores it, e.g. Crimson Tide.
team_nickname	String	ESPN's alternate short label for the team, often the school shorthand.
team_abbreviation	String	Short team code ESPN displays, e.g. ALA. Not unique across divisions, so join on team_id.
team_display_name	String	Full team name as ESPN renders it, location plus nickname.
team_short_display_name	String	Condensed team label ESPN uses where space is tight.
team_color	String	Primary team colour as a hex string without the leading hash, denormalised from the team record.
team_alternate_color	String	Secondary team colour as a hex string without the leading hash.
team_alternate_ids_sdr	String	ESPN's secondary SDR identifier for the team.
is_active	Boolean	Whether ESPN marks the team as active. Denormalised from the team record and reflects capture time.
is_all_star	Boolean	Whether the team is one of the all-star or exhibition squads ESPN files alongside real programs. Filter these out for a true roster count.
logo_href	String	URL of the team's primary logo on ESPN's CDN.
logo_dark_href	String	URL of the dark-background variant of the team logo.
athlete_href	String	ESPN API URL of the athlete resource, useful for fetching the fuller profile.
position_href	String	ESPN API URL of the position resource. Retained for provenance -- the resolved position, position_name and position_abbreviation columns are what you should read.
cfbd_recruit_ids	String	CollegeFootballData recruiting-profile ids matched to this athlete, as a JSON array string such as "[62208]". The one field here with no ESPN counterpart at all, and the link from a roster row into the recruiting datasets; a lone 0 entry means no recruiting profile was matched.
cfbd_home_city	String	Hometown city from CollegeFootballData. This is HOMETOWN, not birthplace -- ESPN's birth_place_city is a different fact and the two disagree often enough that they are shipped side by side rather than coalesced.
cfbd_home_state	String	Hometown state or province from CollegeFootballData, two-letter for United States addresses. Hometown, not birthplace -- see cfbd_home_city.
cfbd_home_country	String	Hometown country from CollegeFootballData, overwhelmingly USA. Hometown, not birthplace -- see cfbd_home_city.
cfbd_home_latitude	String	Latitude of the hometown as geocoded by CollegeFootballData, carried as a string exactly as published. Pair with cfbd_home_longitude to map recruiting footprints or compute distance from campus.
cfbd_home_longitude	String	Longitude of the hometown as geocoded by CollegeFootballData, carried as a string exactly as published. Negative across the United States; pair with cfbd_home_latitude.
cfbd_home_county_fips	String	Five-digit FIPS code of the hometown county from CollegeFootballData, the join key to United States census and county-level demographic tables.

load_cfb_rosters(seasons=2024)

load_cfb_rosters_cfbd

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

Returns

col_name	type	description
athlete_id	String	ESPN athlete id.
first_name	String	Athlete first name.
last_name	String	Athlete last name.
team	String	Team name.
weight	Int32	Listed weight (lbs).
height	Int32	Listed height (inches).
jersey	Int32	Jersey number.
year	Int32	Four-digit season year (e.g. 2019).
position	String	Athlete position.
home_city	String	Hometown of the athlete.
home_state	String	Hometown state of the athlete.
home_country	String	Hometown country of the athlete.
home_latitude	Float64	Hometown latitude.
home_longitude	Float64	Hometown longitude.
home_county_fips	String	Hometown FIPS code.
recruit_ids	List(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_url	String	Player ESPN headshot url.
season	Float64	Season (4-digit year).

load_cfb_rosters_cfbd(seasons=2024)

load_cfb_schedule

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

Returns

col_name	type	description
game_id	Int64	ESPN game id, and the primary key: exactly one row per game. Every CFB surface in this package keys on the same id -- pbp, box scores, rosters, the crosswalks -- so this column joins them all. Pinned to Int64 on every build path so a join never fails on a dtype mismatch.
season	Int64	Season year the game belongs to, matching the season argument you asked for. Bowl and playoff games played in January carry the PRIOR calendar year here, so group on this rather than on the year inside start_date.
week	Int64	Week number within the season as ESPN numbers it, restarting at 1 for the postseason. Pair it with season_type before using it as a sort or join key -- week 1 is ambiguous on its own.
season_type	String	ESPN's season-type label, snake_cased: "regular", "postseason", "offseason" (all-star games), and 2020's COVID-only "spring_regular" / "spring_postseason". Always agrees with season_type_id; use whichever reads better in your code.
season_type_id	Int64	ESPN's season-type integer, the canonical form ESPN publishes at /seasons/{year}/types: 1 preseason, 2 regular, 3 postseason, 4 offseason, 5 spring regular and 6 spring postseason (2020 only). A strict 1:1 partner to season_type, and the value to filter on when joining ESPN endpoints that take a numeric season type.
start_date	String	Scheduled kickoff instant from ESPN, ISO-8601 in UTC -- not local time, so a Saturday-night kickoff on the West Coast lands on the Sunday date. Parse it before comparing; sorting the raw string works only within one season.
start_time_tbd	Boolean	True while ESPN has announced the date but not the kickoff time, which is normal for games more than a few weeks out. When true, treat the time portion of start_date as a placeholder rather than a real kickoff.
completed	Boolean	True once the game has been played to a final. False covers both a future game and one that was cancelled or postponed -- read status to tell those apart. Filter on this before aggregating points or winners.
neutral_site	Boolean	True when neither team was hosting -- bowls, playoff games, and neutral kickoff-weekend matchups. The home/away labels still populate, so use this flag rather than assuming the home team had home-field advantage.
conference_game	Boolean	True when the two teams share a conference, derived from their conference membership for the season. Prefer it over comparing home_conference to away_conference, which mislabels independents and conference realignment.
conference_competition	Boolean	ESPN's own flag on the competition record for whether the game counts as a conference matchup. Kept alongside conference_game because the two measurably disagree on a handful of games each season -- membership says one thing, the game record another. Null for games ESPN's native feed does not carry.
attendance	Int64	Announced attendance for the game as reported to ESPN. Null for games with no announced figure and for closed-door 2020 games; a null is unknown, not zero, so exclude it rather than filling it.
venue_id	Int64	ESPN's identifier for the stadium hosting the game. Stable across seasons and across renames, so it is the join key for venue metadata in cfb_team_info. Null for games with no recorded venue.
venue	String	Stadium the game was played in, as ESPN spells it that season. Sponsor renames change this string between seasons for the same building -- join on venue_id instead of on this text.
status	String	ESPN's game-status enum ("STATUS_FINAL", "STATUS_SCHEDULED", "STATUS_POSTPONED", "STATUS_CANCELED", ...). This is what separates a scheduled-then-cancelled game from an unplayed future one -- the 121 COVID postponements and cancellations in 2020 are found here, not through completed. Null for games ESPN's native feed does not carry.
home_id	Int64	ESPN team id of the home team. The join key to every other team-level CFB table in this package; join on it rather than on home_team, which is a display string.
home_team	String	School name of the home team as ESPN spells it. Display text only -- spellings drift across seasons and endpoints, so join on home_id.
home_abbreviation	String	Short ESPN abbreviation for the home team ("OSU", "MICH"), the form that fits a scoreboard or a chart axis. Abbreviations are not unique across all of college football, so never join on this. Null for games ESPN's native feed does not carry.
home_division	String	Home team's NCAA classification as ESPN records it: "fbs", "fcs", "ii", "iii", or null when ESPN publishes no classification for that team. Null means unclassified, not confirmed non-FBS -- the derived flags treat it conservatively as not-FBS. Filter with fbs_game / fbs_participant rather than comparing this column, because a null comparison yields null in polars and silently drops rows.
home_conference	String	Conference the home team played in that season, as ESPN records it. It follows realignment, so the same school carries different values across seasons -- exactly what you want for a season-by-season breakdown.
home_points	Int64	Final points scored by the home team. Null until the game is played, so filter on completed before summing or differencing scores.
home_winner	Boolean	True when the home team won. Taken from ESPN's winner flag where it is set and otherwise derived from the final score, so it is populated for the full history rather than only recent seasons. Null when the game is not completed or carries no score -- a tie is not representable here.
away_id	Int64	ESPN team id of the away team. Same role as home_id: the join key to every other team-level CFB table.
away_team	String	School name of the away team as ESPN spells it. Display text only -- join on away_id.
away_abbreviation	String	Short ESPN abbreviation for the away team; see home_abbreviation for the display-only caveat.
away_division	String	Away team's NCAA classification, same vocabulary and same unclassified-null caveat as home_division. This is the column that is null most often, because FBS schools schedule opponents ESPN leaves unclassified.
away_conference	String	Conference the away team played in that season, as ESPN records it; follows realignment season by season.
away_points	Int64	Final points scored by the away team. Null until the game is played.
away_winner	Boolean	True when the away team won; same ESPN-flag-then-derived-from-score handling and the same nulls as home_winner.
fbs_game	Boolean	True when BOTH teams are classified FBS -- the filter for an FBS-only schedule. An unclassified (null) division is treated conservatively as not-FBS, so the flag reads False rather than null and is directly usable as a mask without any fill_null. A game whose opponent ESPN never classified therefore reads False even if that opponent was in fact FBS.
fbs_participant	Boolean	True when AT LEAST ONE team is classified FBS -- the filter that keeps an FBS team's games against FCS and lower opponents. An unclassified (null) division contributes False, never null, so the flag is always a usable mask.
highlights	String	Link to ESPN's highlight package for the game, where one was published. Null for most games and for the whole early history.
notes	String	Free-text note ESPN attaches to the game -- typically the bowl or event name, occasionally a weather or relocation note. Unstructured; do not parse it for bowl identity, use playoff_bowl_name.
playoff_competition	String	Playoff competition the game belongs to (e.g. "cfp"). Null for every non-playoff game, which makes is_not_null() the playoff filter.
playoff_format	String	Playoff format in effect for the game (e.g. "four_team", "twelve_team_2025"). Lets you compare bracket eras without hard-coding season cutoffs.
playoff_round	String	Playoff round slug (e.g. "first_round", "quarterfinal", "semifinal", "championship") -- the machine-readable partner to playoff_round_name.
playoff_round_name	String	Playoff round as ESPN displays it (e.g. "Semifinal"). Snake_cased column name here; cfbfastR's flatten emitted it as playoff_roundName.
playoff_bracket_slot	String	Slot the game occupies in the bracket (e.g. "SF1", "FR4"), which is what lets you reconstruct the bracket tree rather than just list the games.
playoff_home_seed	Int64	Seed the home team entered the playoff with. Null outside the playoff and for the seasons before seeding was published.
playoff_away_seed	Int64	Seed the away team entered the playoff with; same nulls as playoff_home_seed.
playoff_bowl_name	String	Bowl hosting the playoff game (e.g. "Rose Bowl") -- the reliable way to attribute a playoff game to a bowl site, rather than parsing notes.

load_cfb_schedule(seasons=2024)

load_cfb_team_info

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

Returns

col_name	type	description
team_id	Int64	ESPN team id.
school	String	Team name.
mascot	String	Team mascot.
abbreviation	String	Metric abbreviation.
alt_name1	String	Team alternate name 1 (as it appears in play_text).
alt_name2	String	Team alternate name 2 (as it appears in play_text).
alt_name3	String	Team alternate name 3 (as it appears in play_text).
conference	String	Conference of the team.
division	String	Division in the conference for the team.
classification	String	Conference classification (fbs, fcs, ii, iii).
color	String	Primary team color (hex, no #).
alt_color	String	Team color (alternate).
logo	String	Team or league logo URL.
logo_2	String	URL of the team's alternate dark-background 500-pixel logo on ESPN's CDN, null for programs with no dark variant.
logos_3	String	URL of the team's logo variant in slot 3 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_4	String	URL of the team's logo variant in slot 4 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_5	String	URL of the team's logo variant in slot 5 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_6	String	URL of the team's logo variant in slot 6 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_7	String	URL of the team's logo variant in slot 7 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_8	String	URL of the team's logo variant in slot 8 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_9	String	URL of the team's logo variant in slot 9 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_10	String	URL of the team's logo variant in slot 10 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_11	String	URL of the team's logo variant in slot 11 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_12	String	URL of the team's logo variant in slot 12 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_13	String	URL of the team's logo variant in slot 13 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_14	String	URL of the team's logo variant in slot 14 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_15	String	URL of the team's logo variant in slot 15 of ESPN's team-info logo list; null when the team publishes fewer variants.
logos_16	String	URL of the team's logo variant in slot 16 of ESPN's team-info logo list; null when the team publishes fewer variants.
twitter	String	The football program's Twitter/X handle including the leading at sign, populated for only a minority of listed teams.
venue_id	Int32	Referencing venue id.
venue_name	String	Full name of the franchise's venue.
city	String	Venue city.
state	String	U.S. state where the school is located.
zip	String	Team/venue zip code.
country_code	String	Team/venue country code.
timezone	String	Time zone in which the venue resides (i.e. Eastern Time -> "America/New_York").
latitude	Float64	Venue latitude in decimal degrees.
longitude	Float64	Venue longitude in decimal degrees.
elevation	String	Venue elevation above sea level.
capacity	Int32	Stadium capacity.
year_constructed	Int32	Year in which the venue was constructed.
grass	Boolean	TRUE/FALSE response on whether the field is grass or not.
dome	Boolean	TRUE/FALSE response to whether the venue has a dome or not.

load_cfb_team_info(seasons=2024)

load_cfb_teams

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

Returns

col_name	type	description
season	Int64	Season the team row describes. The dataset is season-scoped, so a school's conference, division and branding are what ESPN published for that year rather than today's values.
team_id	Int64	ESPN's team identifier, stable across seasons and the join key to every other ESPN-sourced CFB dataset (schedules, rosters, pbp).
uid	String	ESPN's fully-qualified resource key for the team, e.g. s:20l:23t:333. Rarely needed directly; team_id is the practical join key.
guid	String	Opaque ESPN global identifier for the team record. Present for traceability back to the source payload; not a join key you would normally use.
slug	String	URL fragment ESPN uses for the team on espn.com, e.g. alabama-crimson-tide.
abbreviation	String	Short team code ESPN displays on scoreboards, e.g. ALA. Not unique across all divisions, so never join on it.
display_name	String	Full team name as ESPN renders it, e.g. Alabama Crimson Tide -- location plus nickname.
short_display_name	String	Condensed team label ESPN uses where space is tight, usually the nickname alone.
name	String	Team nickname as ESPN stores it, e.g. Crimson Tide, without the school or location prefix.
nickname	String	ESPN's alternate short label for the team; often the school shorthand rather than the mascot, and it can duplicate name.
location	String	School or city ESPN attaches to the team, e.g. Alabama. Combined with name to build display_name.
color	String	Primary team colour ESPN publishes, as a hex string without the leading hash. Useful for plotting; null for teams ESPN has no branding for.
alternate_color	String	Secondary team colour as a hex string without the leading hash. Frequently null outside Division I.
is_active	Boolean	ESPN's flag for whether the program was active that season. Do not use it as a division filter -- it stays true for teams ESPN has stopped classifying.
is_all_star	Boolean	ESPN's own all-star marker. It is unreliable on its own: it catches only about a third of the exhibition squads ESPN files inside the FBS and FCS groups, which is why is_exhibition exists.
is_exhibition	Boolean	Derived marker for bowl all-star and exhibition squads that ESPN files alongside real programs. Combine as is_fbs and not is_exhibition to count actual FBS teams -- 133 rather than 145 in 2023.
division	String	Most specific NCAA grouping ESPN places the team in: fbs, fcs, d2, d3, d2_d3 for teams filed directly under the Division II/III node, naia, or all_star. Null when ESPN lists the team in no group at all.
is_fbs	Boolean	Whether the team is classified FBS, as a non-null boolean. Prefer this over comparing division, because a null division comparison yields null in polars and silently drops rows from a mask.
team_group_id	Int64	Identifier of the immediate ESPN group holding the team. That group is a division within a conference where one exists, so an SEC team can point at SEC - West rather than at the SEC itself.
team_group_name	String	Label of that immediate group, e.g. SEC - West. Use the conference_ columns when you want the conference proper.
conference_id	Int64	ESPN identifier of the conference, resolved by walking up from the immediate group to the ancestor whose parent is the FBS or FCS node. Null for teams with no conference, which is normal outside Division I.
conference_name	String	Full conference name for that season, e.g. Southeastern Conference. It follows realignment, so a school carries different values across seasons.
conference_short_name	String	Shortened conference label ESPN uses in compact contexts, e.g. SEC, preserving ESPN's casing.
conference_abbreviation	String	Conference abbreviation as ESPN publishes it. Note ESPN lower-cases these, so it reads sec rather than SEC.
conference_midsize_name	String	Medium-length conference label sitting between the short name and the full name in ESPN's own hierarchy.
conference_slug	String	URL fragment ESPN uses for the conference on espn.com.
conference_is_conference	Boolean	ESPN's flag marking the resolved group as a true conference rather than a structural division node. Useful for detecting when the walk-up landed somewhere unexpected.
conference_parent_id	Int64	Identifier of the group above the conference, which is the FBS or FCS node for Division I teams.
team_logo	String	URL of the team's primary logo on ESPN's CDN, sized 500x500. Null for programs ESPN has no artwork for, which is most of the NAIA universe.
team_logo_dark	String	URL of the dark-background variant of the team logo, where ESPN publishes one.
conference_logo	String	URL of the conference's logo on ESPN's CDN. Always null outside Division I -- ESPN publishes conference artwork only for FBS and FCS.
venue_id	Int64	ESPN's identifier for the team's home venue, joinable to ESPN venue payloads.
venue_name	String	Home venue name as ESPN records it.
venue_city	String	City of the home venue per ESPN. Compare with the CFBD-sourced city column, which describes the school rather than the stadium.
venue_state	String	State or province of the home venue per ESPN.
venue_indoor	Boolean	Whether ESPN marks the home venue as indoor. The CFBD-sourced dome column answers the same question from the other feed and the two can disagree.
venue_grass	Boolean	Whether ESPN marks the home venue's playing surface as grass. See the CFBD-sourced grass column for the second opinion.
school	String	School name as CollegeFootballData spells it. Present for cross-source reconciliation; prefer team_id for joins because spellings differ between feeds.
mascot	String	Team mascot per the CollegeFootballData feed, which often differs in wording from ESPN's name column.
alt_name1	String	First alternate school spelling CollegeFootballData carries, useful when matching against a source that names schools differently.
alt_name2	String	Second alternate school spelling from the same alias list.
alt_name3	String	Third alternate school spelling from the same alias list.
cfbd_conference	String	Conference as recorded on the CollegeFootballData feed. Kept separate from the conference_ family so the two opinions never silently overwrite one another.
classification	String	Division as recorded on the CollegeFootballData feed: fbs, fcs, ii, iii. An independent second opinion on division -- the two agree for the vast majority of teams and disagreements are worth inspecting rather than reconciling blindly.
city	String	City the school is located in, from the CollegeFootballData feed. This describes the institution, not the stadium -- see venue_city for that.
state	String	State the school is located in, from the CollegeFootballData feed.
country_code	String	ISO country code for the school's location, effectively always US in this dataset.
timezone	String	Olson timezone for the school's location, e.g. America/Chicago. Handy for converting kickoff timestamps to local time.
latitude	Float64	Latitude of the school or its stadium in decimal degrees, for mapping and travel-distance work.
longitude	Float64	Longitude of the school or its stadium in decimal degrees.
elevation	String	Stadium elevation in metres. Carried as text on the source feed, so cast it before doing arithmetic.
capacity	Int64	Listed seating capacity of the home stadium. Null where the feed has no figure, which is common below Division I.
dome	Boolean	Whether the stadium is domed per the CollegeFootballData feed. Compare with venue_indoor, ESPN's answer to the same question.
grass	Boolean	Whether the playing surface is grass per the CollegeFootballData feed. Compare with venue_grass from ESPN.

load_cfb_teams(seasons=2024)

load_cfb_team_talent

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

Returns

col_name	type	description
season	Int64	Season (4-digit year).
team_id	Int64	ESPN team id.
team	String	Team name.
talent_composite	Float64	Sum of composite recruiting ratings across the counted signing classes (the Team Talent measure).
talent_rank	Int64	Dense rank of talent_composite within the season (1 = most talented roster).
blue_chip_ratio	Float64	Share of the team's counted signees rated four or five stars over the rolling class window.
n_recruits	Int64	Number of signees counted in the blue-chip-ratio window.

load_cfb_team_talent(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_name	type	description
norm_key	String	Shared join key across providers: the team name lowercased, ASCII-folded, stripped of punctuation, whitespace-collapsed, and alias-mapped.
espn_team_id	Int64	ESPN team id for the crosswalk row.
espn_team	String	ESPN's full team display name, school plus mascot, null when the row was anchored on a non-ESPN provider.
espn_abbreviation	String	ESPN abbreviation.
fox_team_id	String	Fox Sports team id for the same team.
fox_team	String	Fox Sports' team name, which that feed ships in all capitals.
fox_abbreviation	String	Fox Sports' short team code, which frequently differs from the ESPN abbreviation for the same school.
yahoo_team_id	String	Yahoo Sports team id for the same team.
yahoo_team	String	Yahoo Sports' team display name, school plus mascot.
yahoo_abbreviation	String	Yahoo Sports' short team code for the school.
matched_sources	String	Plus-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_name	type	description
matchup_key	String	Order-independent key for the game: the two normalized team names sorted alphabetically and joined with a pipe.
espn_game_id	Int64	ESPN game id for the crosswalk row.
fox_game_id	String	Fox Sports game id for the same game.
yahoo_game_id	String	Yahoo Sports game id for the same game.
yahoo_global_game_id	String	Yahoo's cross-season global game key in ncaaf.g. form, distinct from the date-encoded yahoo_game_id.
home_team	String	Home team name.
away_team	String	Away team name.
espn_date	String	Kickoff date as YYYY-MM-DD taken from ESPN's schedule, null on games that matched no ESPN row.
fox_date	String	Kickoff date as YYYY-MM-DD taken from the Fox Sports schedule, null on games that matched no Fox row.
yahoo_date	String	Kickoff date as YYYY-MM-DD, parsed from Yahoo's RFC-2822 start_time string.
matched_sources	String	Plus-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_name	type	description
firstDowns	String	Total first downs ESPN credits the team, carried verbatim from the box score as a string.
thirdDownEff	String	Third-down efficiency as ESPN's conversions-attempts string, for example 5-15.
fourthDownEff	String	Fourth-down efficiency as a conversions-attempts string, for example 3-4.
totalYards	String	Total offensive yards for the team, matching rushingYards plus netPassingYards in about 99.8 percent of games.
netPassingYards	String	Passing yards after yardage lost to sacks is deducted, the numerator behind yardsPerPass.
completionAttempts	String	Completions and pass attempts as a slash-separated string, for example 23/41.
yardsPerPass	String	Net passing yards per pass attempt, netPassingYards divided by the attempt count in completionAttempts and rounded to one decimal.
rushingYards	String	Net rushing yards gained.
rushingAttempts	String	Rushing attempts.
yardsPerRushAttempt	String	Yards gained per rushing attempt.
totalPenaltiesYards	String	Penalties and penalty yards as a hyphen-separated string, for example 7-64.
turnovers	String	Turnovers total.
fumblesLost	String	Number of fumbles the team lost to the opponent, carried as a string.
interceptions	String	Passing interceptions.
possessionTime	String	Time of possession as mm:ss; the two teams' values add up to 60 minutes in a regulation game.
team_id	Int64	ESPN team id.
team_abbreviation	String	Team abbreviation; team_detail = TRUE only.
team_name	String	Team nickname; team_detail = TRUE only.
home_away	String	home or away.
game_id	Int64	ESPN game identifier.
season	Int64	Season (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_name	type	description
stat_1	String	First 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_2	String	Second 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_3	String	Third 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_4	String	Fourth 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_5	String	Fifth 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.
category	String	CFBD stats category name (e.g. passing, rushing, defensive).
athlete_id	Int64	ESPN athlete id.
athlete_name	String	Player full name.
jersey	String	Jersey number.
team_id	Int64	ESPN team id.
rushingAttempts	String	Rushing attempts.
rushingYards	String	Net rushing yards gained.
yardsPerRushAttempt	String	Yards gained per rushing attempt.
rushingTouchdowns	String	Rushing touchdowns.
longRushing	String	Longest rush of the game, in yards.
receptions	String	The number of pass receptions. Lateral receptions officially don't count as reception.
receivingYards	String	Receiving yards gained.
yardsPerReception	String	Yards gained per reception.
receivingTouchdowns	String	Receiving touchdowns.
longReception	String	Longest reception of the game, in yards.
fumbles	String	Number of times the player fumbled in the game (ESPN box score).
fumblesLost	String	Number of the player's fumbles lost to the opponent (ESPN box score).
fumblesRecovered	String	Number of fumbles the player recovered (ESPN box score).
kickReturns	String	Number of kickoff returns by the player (ESPN box score).
kickReturnYards	String	Total kickoff-return yards by the player (ESPN box score).
yardsPerKickReturn	String	Average yards per kickoff return for the player (ESPN box score).
longKickReturn	String	Player's longest kickoff return of the game, in yards (ESPN box score).
kickReturnTouchdowns	String	Kickoff returns the player took for touchdowns (ESPN box score).
puntReturns	String	Punt returns attempted.
puntReturnYards	String	Yards gained on punt returns.
yardsPerPuntReturn	String	Yards gained per punt return.
longPuntReturn	String	Longest punt return of the game, in yards.
puntReturnTouchdowns	String	Touchdowns scored on punt returns.
fieldGoalsMade/fieldGoalAttempts	String	Field goals made and attempted, as ESPN's combined string.
fieldGoalPct	String	Field-goal percentage.
longFieldGoalMade	String	Longest field goal made, in yards.
extraPointsMade/extraPointAttempts	String	Extra points made and attempted, as ESPN's combined string.
totalKickingPoints	String	Total points scored by kicking.
punts	String	Punts attempted.
puntYards	String	Total punt yards.
grossAvgPuntYards	String	Gross average yards per punt, before return yardage.
touchbacks	String	Punts or kickoffs that resulted in a touchback.
puntsInside20	String	Punts downed inside the opponent 20-yard line.
longPunt	String	Longest punt of the game, in yards.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
interceptions	String	Passing interceptions.
interceptionYards	String	Yards returned on interceptions.
interceptionTouchdowns	String	Touchdowns scored on interception returns.
totalTackles	String	Player's total tackles, solo plus assisted (ESPN box score).
soloTackles	String	Player's solo (unassisted) tackles (ESPN box score).
sacks	String	Sacks credited to the player (ESPN box score).
tacklesForLoss	String	Player's tackles made behind the line of scrimmage (ESPN box score).
passesDefended	String	Passes the player broke up or defended (ESPN box score).
hurries	String	Quarterback hurries credited to the player (ESPN box score).
defensiveTouchdowns	String	Touchdowns the player scored on defense (ESPN box score).
completions/passingAttempts	String	Completions and pass attempts, as ESPN's combined string.
passingYards	String	Net passing yards gained.
yardsPerPassAttempt	String	Yards gained per pass attempt.
passingTouchdowns	String	Passing touchdowns.
adjQBR	String	Adjusted 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_name	type	description
drive_id	String	CFBD drive identifier the play belongs to.
team_id	Int64	ESPN team id.
result	String	Drive result code (e.g. PUNT, TD).
display_result	String	Drive-result label (e.g. Punt, Touchdown).
short_display_result	String	Short drive-result label.
description	String	ESPN's description of the stat.
yards	Int64	Total yards gained on the drive.
offensive_plays	Int64	Number of offensive plays on the drive.
is_score	Boolean	TRUE if the drive resulted in a score.
start_period	Int64	Period (quarter) in which the drive starts.
start_yard_line	Int64	Yard line at the start of the play.
start_clock	String	Game clock display value at the start of the drive.
start_text	String	Field-position text at the start of the drive.
end_period	Int64	Period (quarter) in which the drive ends.
end_yard_line	Int64	Yard line at the end of the play.
end_clock	String	Game clock display value at the end of the drive.
time_elapsed	String	Elapsed game time for the drive (MM:SS).
n_plays	Int64	Number 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_id	Int64	ESPN game identifier.
season	Int64	Season (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_name	type	description
game_id	Int64	ESPN game identifier.
play_id	Int64	ESPN play id.
kicker_player_name	String	Display name of the kicker -- the FIRST participant in that role on the play.
tackler_player_name	String	Display name of a defender credited with the tackle -- the FIRST participant in that role on the play.
returner_player_name	String	Display name of the player returning the kick or punt -- the FIRST participant in that role on the play.
rusher_player_name	String	Display name of the ball carrier on a rush -- the FIRST participant in that role on the play.
passer_player_name	String	Display name of the passer -- the FIRST participant in that role on the play.
receiver_player_name	String	Display name of the targeted receiver -- the FIRST participant in that role on the play.
punter_player_name	String	Display name of the punter -- the FIRST participant in that role on the play.
assisted_by_player_name	String	Display name of a defender credited with an assisted tackle -- the FIRST participant in that role on the play.
penalized_player_name	String	Display name of the penalized player -- the FIRST participant in that role on the play.
scorer_player_name	String	Display name of the player credited with the score -- the FIRST participant in that role on the play.
pat_scorer_player_name	String	Display name of the player credited with the point-after score -- the FIRST participant in that role on the play.
sacked_by_player_name	String	Display name of a defender credited with the sack -- the FIRST participant in that role on the play.
kicker_player_id	String	ESPN athlete id of the kicker -- the FIRST participant in that role on the play.
tackler_player_id	String	ESPN athlete id of a defender credited with the tackle -- the FIRST participant in that role on the play.
returner_player_id	String	ESPN athlete id of the player returning the kick or punt -- the FIRST participant in that role on the play.
rusher_player_id	String	ESPN athlete id of the ball carrier on a rush -- the FIRST participant in that role on the play.
passer_player_id	String	ESPN athlete id of the passer -- the FIRST participant in that role on the play.
receiver_player_id	String	ESPN athlete id of the targeted receiver -- the FIRST participant in that role on the play.
punter_player_id	String	ESPN athlete id of the punter -- the FIRST participant in that role on the play.
assisted_by_player_id	String	ESPN athlete id of a defender credited with an assisted tackle -- the FIRST participant in that role on the play.
penalized_player_id	String	ESPN athlete id of the penalized player -- the FIRST participant in that role on the play.
scorer_player_id	String	ESPN athlete id of the player credited with the score -- the FIRST participant in that role on the play.
pat_scorer_player_id	String	ESPN athlete id of the player credited with the point-after score -- the FIRST participant in that role on the play.
sacked_by_player_id	String	ESPN athlete id of a defender credited with the sack -- the FIRST participant in that role on the play.
kicker_player_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_names	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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_ids	String	List 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.
season	Int64	Season (4-digit year).
week	Int64	Game week of the season.
pass_defender_player_name	String	Display name of the defender credited with defending the pass -- the FIRST participant in that role on the play.
pass_defender_player_id	String	ESPN athlete id of the defender credited with defending the pass -- the FIRST participant in that role on the play.
pass_defender_player_names	String	List 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_ids	String	List 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_name	String	Display name of the player who recovered the fumble -- the FIRST participant in that role on the play.
fumbler_player_name	String	Display name of the first (primary) player who fumbled on the play, from ESPN's per-play participants.
recoverer_player_id	String	ESPN athlete id of the player who recovered the fumble -- the FIRST participant in that role on the play.
fumbler_player_id	String	ESPN athlete id of the first (primary) player who fumbled on the play.
recoverer_player_names	String	List 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_names	String	Display names of every player who fumbled on the play, as a list.
recoverer_player_ids	String	List 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_ids	String	ESPN athlete ids of every player who fumbled on the play, as a list.
forced_by_player_name	String	Display name of the defender who forced the fumble -- the FIRST participant in that role on the play.
forced_by_player_id	String	ESPN athlete id of the defender who forced the fumble -- the FIRST participant in that role on the play.
forced_by_player_names	String	List 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_ids	String	List 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_name	String	Display name of the passer on the point-after attempt -- the FIRST participant in that role on the play.
pat_passer_player_id	String	ESPN athlete id of the passer on the point-after attempt -- the FIRST participant in that role on the play.
pat_passer_player_names	String	List 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_ids	String	List 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_name	type	description
athlete_id	Int64	ESPN athlete id.
athlete_uid	String	ESPN athlete UID (universal identifier).
athlete_guid	String	ESPN athlete GUID.
athlete_type	String	Athlete type / class.
first_name	String	Athlete first name.
last_name	String	Athlete last name.
full_name	String	Venue full name (e.g. Tenney Stadium).
athlete_display_name	String	Player display name; athlete_detail = TRUE only.
short_name	String	Ranking source short name (e.g. AP Poll).
weight	Float64	Listed weight (lbs).
display_weight	String	Human-readable weight (e.g. 205 lbs).
height	Float64	Listed height (inches).
display_height	String	Human-readable height (e.g. 6' 1").
slug	String	URL slug for the team.
jersey	String	Jersey number.
linked	Boolean	TRUE if the record is linked to a related entity.
active	Boolean	TRUE if the player was active for the game.
alternate_ids_sdr	String	Alternate ids sdr.
birth_place_city	String	Birth place city.
birth_place_state	String	Birth place state.
birth_place_country	String	Birth place country.
birth_country_alternate_id	String	ESPN's internal alternate identifier for the athlete's birth country, paired with birth_place_country and the flag fields.
birth_country_abbreviation	String	Birth country abbreviation.
headshot_href	String	URL of the athlete headshot image.
headshot_alt	String	Alternative-text label for the headshot.
hand_type	String	Hand type.
hand_abbreviation	String	Hand abbreviation.
hand_display_value	String	Hand display value.
flag_href	String	URL of the birth-country flag image hosted on ESPN's CDN under teamlogos/countries.
flag_alt	String	Alt text ESPN attaches to the birth-country flag image, which is the country's name spelled out.
flag_rel	String	Stringified relationship list ESPN ships with the flag image; the only non-null value observed is a single country-flag entry.
experience_years	Float64	Years of experience.
experience_display_value	String	Experience display value.
experience_abbreviation	String	Experience abbreviation.
status_id	String	ESPN commitment status id.
status_name	String	Status-type key (e.g. STATUS_FINAL).
status_type	String	Status type.
status_abbreviation	String	Status abbreviation.
middle_name	String	Middle name of the player.
starter	Boolean	TRUE if the athlete started the game.
jersey_right	String	Secondary or alternate jersey number display string from ESPN's roster record, distinct from the primary jersey number.
valid	Boolean	TRUE if the roster entry is flagged valid by ESPN.
did_not_play	Boolean	TRUE if the athlete did not play.
display_name	String	Human-readable metric name.
athlete_href	String	ESPN Core v2 API reference URL for the athlete's season record, ending in the athlete id.
position_href	String	ESPN Core v2 API reference URL for the position resource ESPN lists the athlete at.
statistics_href	String	ESPN 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_id	Int64	ESPN team id.
order	Int64	Team order within the competition (0 = first).
home_away	String	home or away.
winner	Boolean	TRUE if this team won the game.
team_guid	String	ESPN team GUID.
team_uid	String	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	String	Team slug for the stat row.
team_location	String	Team location / school name; team_detail = TRUE only.
team_name	String	Team nickname; team_detail = TRUE only.
team_nickname	String	Team nickname label; team_detail = TRUE only.
team_abbreviation	String	Team abbreviation; team_detail = TRUE only.
team_display_name	String	Full team display name; team_detail = TRUE only.
team_short_display_name	String	Short team display name; team_detail = TRUE only.
team_color	String	Primary team color; team_detail = TRUE only.
team_alternate_color	String	Alternate team color; team_detail = TRUE only.
is_active	Boolean	Whether the team is currently active.
is_all_star	Boolean	Whether the team is an all-star team.
team_alternate_ids_sdr	String	The team's Sportradar alternate identifier, which maps one-to-one with team_id.
logo_href	String	URL of the default team logo.
logo_dark_href	String	URL of the dark-variant team logo.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game week of the season.
age	Float64	Age as of last pipeline build, rounded to one decimal. Pipeline is built on a weekly basis.
date_of_birth	String	Player date of birth (if published).
citizenship	String	Citizenship.
draft_display_text	String	Draft display text.
draft_round	Float64	Round that player was drafted in
draft_year	Float64	Year that player was drafted
draft_selection	Float64	Draft selection.
draft_team_href	String	API 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_name	type	description
team_id	Int64	ESPN team id.
period	Int64	Period (quarter) number.
value	String	Metric value.
game_id	Int64	ESPN game identifier.
season	Int64	Season (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_name	type	description
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game week of the season.
game_spread	Float64	Game spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns
over_under	Float64	Pre-game over/under total from the selected provider.
home_favorite	Boolean	TRUE if the home team is the favorite.
home_team_spread	Float64	The game spread with respect to the home team
game_spread_available	Boolean	Logical (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_source	String	Provenance 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_name	type	description
season	Int64	Season (4-digit year).
season_type	Int64	ESPN season type (2 = regular, 3 = postseason).
week	Int64	Game week of the season.
team_id	Int64	ESPN team id.
last_updated	String	Timestamp ESPN last refreshed the power index.
run_date_time_key	Int64	ESPN'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_sequence	Boolean	True 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.
fpi	Float64	Football Power Index that measures team's true strength on net points scale; expected point margin vs average opponent on neutral field.
fpirank	Float64	ESPN'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.
projectedw	Float64	Projected 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.
projectedl	Float64	Projected 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.
projectedt	Null	Projected 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.
projectedwpctrank	Float64	Rank among FBS teams by projected win percentage. ESPN publishes the rank without the underlying percentage; derive it from projectedw and projectedl.
probwinout	Float64	Percent of season simulations in which team won all remaining scheduled games as well as conference championship game (if applicable).
probwinconf	Float64	Percent 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.
sosremainingrank	Float64	Rank among all FBS teams of remaining schedule strength, from perspective of an average FBS team.
accomplishment	Float64	Reflects 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.
accomplishmentrank	Float64	Strength of Record rank. Reflects chance that an average Top 25 team would have team's record or better, given the schedule.
adjwins	Float64	Team's Wins adjusted for chance an average FBS team would have team's record or better, given the schedule.
adjlosses	Float64	Team's Losses adjusted for chance an average FBS team would have team's record or better, given the schedule.
adjwinpctrank	Float64	Rank 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.
gamecontrol	Float64	Reflects 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.
gamecontrolrank	Float64	Game 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.
adjavgingamewp	Float64	Team'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.
adjavgingamewprank	Float64	Rank 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.
avgingamewp	Float64	Team's average in-game win probability across all plays of all games played, not adjusted for site or opponent.
avgingamewprank	Float64	Team'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.
avgsosrank	Float64	Rank among all FBS teams of games already played schedule strength, from perspective of an average Top 25 team.
topsosrank	Float64	Rank among all FBS teams of games already played schedule strength, from perspective of an top FBS team.
epaoffense	Float64	Offensive component of FPI. Offensive contribution to expected point margin vs average opponent on neutral field.
epadefense	Float64	Defensive component of FPI. Defensive contribution to expected point margin vs average opponent on neutral field.
epaspecialteams	Float64	Special teams component of FPI. Special teams contribution to expected point margin vs average opponent on neutral field.
probwindiv	Float64	Percent of season simulations in which team won its conference division, for those conferences that have divisions.
probmakeplayoffs	Float64	Chance to make the CFB Playoff, according to the Playoff Predictor.
probmaketitlegame	Float64	Chance to make the CFB Playoff National Championship game, according to the Playoff Predictor.
numwins	Float64	Actual wins to date at the time of the snapshot. Distinct from projectedw (full-season projection) and adjwins (opponent-adjusted).
numlosses	Float64	Actual losses to date at the time of the snapshot. Distinct from projectedl (full-season projection) and adjlosses (opponent-adjusted).
numties	Float64	Actual ties to date. Never nonzero -- college football abolished ties in 1996; the column is null or 0 in every published row.
probwintitle	Float64	Chance to win the CFB Playoff National Championship, according to the Playoff Predictor.
rankchange7days	Float64	FPI Rank change from previous week.
prob6wins	Float64	Percent of season simulations in which a team won at least 6 games (typically bowl-eligible).
rank	Float64	FPI 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.
offefficiency	Float64	Offensive efficiency on 0-100 scale; based on offense's contribution to scoring margin on per-play basis, adjusted for strength of opposing defenses faced.
offefficiencyrank	Float64	Team's offensive efficiency rank among all FBS teams.
defefficiency	Float64	Defensive efficiency on 0-100 scale; based on defense's contribution to scoring margin on per-play basis, adjusted for strength of opposing offenses faced.
defefficiencyrank	Float64	Team's defensive efficiency rank among all FBS teams.
stefficiency	Float64	Special 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.
stefficiencyrank	Float64	Team's special teams efficiency rank among all FBS teams.
totefficiency	Float64	Net efficiency on 0-100 scale; incorporates offense, defense and special teams efficiencies into a single schedule-adjusted measure of per-play efficiency.
totefficiencyrank	Float64	Team's overall efficiency rank among all FBS teams.
snapshot_is_contemporaneous	Boolean	True 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_name	type	description
season	Int64	Season (4-digit year).
game_id	Int64	ESPN game identifier.
team_id	Int64	ESPN team id.
teampredptdiff	Float64	Expected margin of victory for the FPI favorite.
gameprojection	Float64	Team's predicted win percentage in this game at time of given BPI run.
matchupquality	Float64	A measure of projected competitiveness and excitement in the game, using a 0 to 100 scale, with 100 as the most exciting.
teamadjgamescore	Float64	A 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
rushing_highlight_yards_per_opp	Float64	Highlight yards per rushing opportunity.
total_pen_yards	Int64	Total penalty yards assessed.
EPA_penalty	Float64	Total EPA attributed to penalties.
penalty_first_downs_created	Int64	Number of first downs the team gained via opponent penalty.
penalty_first_downs_created_rate	Float64	Share of the team's first downs that came via opponent penalty.
penalties	Int64	Number of penalties assessed against the team.
penalty_yards	Int64	Net penalty yardage assessed against the team; can be negative when enforcement moved the team forward on balance.
special_teams_plays	Int64	Number of special-teams plays.
EPA_sp	Float64	Total special-teams EPA, ESPN's abbreviated field for the same phase.
EPA_special_teams	Float64	Total EPA generated on special-teams plays.
field_goals	Int64	Number of field-goal attempts.
EPA_fg	Float64	Total EPA on field-goal attempts.
punt_plays	Int64	Number of punt plays.
EPA_punt	Float64	Total EPA on punt plays.
kickoff_plays	Int64	Number of kickoff plays.
EPA_kickoff	Float64	Total EPA on kickoff plays.
rushes	Int64	Number of rushing attempts.
rush_yards	Float64	Total yards the team gained on rush plays.
yards_per_rush	Float64	Yards gained per rushing attempt.
rushing_power_rate	Float64	Share of carries that were power rushing attempts.
rushing_first_downs_created	Int64	Number of first downs created on rush plays.
rushing_first_downs_created_rate	Float64	Share of rush plays that created a first down.
EPA_rushing_overall	Float64	Total EPA on rush plays.
EPA_rushing_per_play	Float64	EPA per rush play.
EPA_explosive_rushing	Int64	Count of explosive rush plays. A play count, not an EPA total.
EPA_explosive_rushing_rate	Float64	Explosive-play rate on rush plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_rushing	Float64	Total EPA on rush plays with explosive plays excluded.
EPA_non_explosive_rushing_per_play	Float64	EPA per rush play with explosive plays excluded.
passes	Int64	Number of pass plays the team ran.
pass_yards	Float64	Total yards the team gained on pass plays.
yards_per_pass	Float64	Team game yards per pass.
passing_first_downs_created	Int64	Number of first downs created on pass plays.
passing_first_downs_created_rate	Float64	Share of pass plays that created a first down.
EPA_passing_overall	Float64	Total EPA on pass plays.
EPA_passing_per_play	Float64	EPA per pass play.
EPA_explosive_passing	Int64	Count of explosive pass plays. A play count, not an EPA total.
EPA_explosive_passing_rate	Float64	Explosive-play rate on pass plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_passing	Float64	Total EPA on pass plays with explosive plays excluded.
EPA_non_explosive_passing_per_play	Float64	EPA per pass play with explosive plays excluded.
scrimmage_plays	Int64	Number of plays from scrimmage (rushes plus passes), excluding special teams.
EPA_overall_off	Float64	Total offensive EPA for the team. Duplicated exactly by EPA_overall_offense in every published season checked -- prefer one and ignore the other.
EPA_overall_offense	Float64	Total offensive EPA. An exact duplicate of EPA_overall_off.
EPA_per_play	Float64	Offensive EPA per play.
EPA_non_explosive	Float64	Total EPA with explosive plays excluded, isolating the team's routine-down production.
EPA_non_explosive_per_play	Float64	EPA per play with explosive plays excluded.
EPA_explosive	Int64	Count of explosive plays, per ESPN's advanced box score. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_explosive_rate	Float64	Explosive-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_rate	Float64	Share of the team's plays from scrimmage that were pass plays.
off_yards	Int64	Offensive yards gained from scrimmage.
total_off_yards	Int64	Total offensive yards across all plays.
yards_per_play	Float64	Yards gained per play.
EPA_plays	Int64	Number of plays ESPN's advanced box score scored for the team.
total_yards	Int64	Total yards the team gained across all plays.
EPA_overall_total	Float64	Total EPA across all phases, which is why it differs from the offense-only EPA_overall_off.
rushes_rate	Float64	Share of the team's plays from scrimmage that were rush plays.
first_downs_created	Int64	Number of first downs the team created.
first_downs_created_rate	Float64	Share of the team's plays that created a first down.
EPA_rushing_power	Float64	Total EPA on power rushing situations, as classified by ESPN's advanced box score.
EPA_rushing_power_per_play	Float64	EPA per play on power rushing situations.
rushing_power_success	Int64	Count 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_rate	Float64	Share of power rushing attempts that succeeded.
rushing_power	Int64	Count of power rushing attempts, in short-yardage situations as classified by ESPN's advanced box score.
rushing_stuff	Int64	Count of stuffed rushing attempts.
rushing_stuff_rate	Float64	Share of the team's carries that were stuffed at or behind the line of scrimmage.
rushing_stopped	Int64	Count of rushing attempts stopped at or behind the line of scrimmage.
rushing_stopped_rate	Float64	Share of carries stopped at or behind the line of scrimmage.
rushing_opportunity	Int64	Count of rushing opportunities -- carries that reached ESPN's opportunity threshold.
rushing_opportunity_rate	Float64	Share of carries that qualified as rushing opportunities.
rushing_highlight	Int64	Highlight yards -- rushing yardage credited to the back rather than the offensive line.
rushing_highlight_rate	Float64	Share of rushing yardage that was highlight (back-credited) yardage.
rushing_highlight_yards	Float64	Total 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_yards	Float64	Line 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_carry	Float64	Line yards per rushing attempt.
second_level_yards	Float64	Second-level yards -- rushing yardage earned just beyond the line of scrimmage.
open_field_yards	Float64	Open-field yards -- rushing yardage earned well downfield, past the second level.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
passer_player_name	String	Display name of the passer -- the FIRST participant in that role on the play.
Comp	Int64	Completed passes recorded in the advanced box score.
Att	Int64	Pass attempts recorded in the advanced box score.
xComp	Float64	Expected completions, summed from the per-play completion model.
Yds	Float64	Passing yards from the advanced box score.
Pass_TD	Int64	Passing touchdowns.
Int	Int64	Interceptions thrown.
YPA	Float64	Yards per pass attempt.
EPA	Float64	Expected Points Added on the play (cfbfastR EPA model output).
EPA_per_Play	Float64	EPA per play on the passer's plays.
WPA	Float64	Win Probability Added.
SR	Float64	Success rate on the passer's plays.
Sck	Int64	Times the passer was sacked.
CompPct	Float64	Completion percentage from the advanced box score.
xCompPct	Float64	Expected completion percentage from the per-play completion model.
CPOE	Float64	Completion percentage over expected -- actual minus modelled completion rate.
qbr_epa	Float64	EPA variant used as an input to the QBR calculation.
sack_epa	Float64	EPA credited to the player's sacks taken.
pass_epa	Float64	EPA credited to the player's pass plays.
rush_epa	Float64	EPA credited to the player's rush plays.
pen_epa	Float64	EPA attributable to penalties on the player's plays.
spread	Float64	Pre-game point spread from the selected provider.
era0	Int64	Rule-era indicator for the earliest modelled era.
era1	Int64	Rule-era indicator for the second modelled era.
era2	Int64	Rule-era indicator for the third modelled era.
era3	Int64	Rule-era indicator for the most recent modelled era.
exp_qbr	Float64	Expected QBR for the passer.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
rusher_player_name	String	Display name of the ball carrier on a rush -- the FIRST participant in that role on the play.
Car	Int64	Rushing attempts credited to this ball carrier in the game.
Yds	Float64	Passing yards from the advanced box score.
Rush_TD	Int64	Rushing touchdowns scored by this ball carrier in the game.
YPC	Float64	Yards per carry, the mean rushing yardage across the player's attempts in the game.
EPA	Float64	Expected Points Added on the play (cfbfastR EPA model output).
EPA_per_Play	Float64	EPA per play on the passer's plays.
WPA	Float64	Win Probability Added.
SR	Float64	Success rate on the passer's plays.
Fum	Int64	Count 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_Lost	Int64	Count of the carrier's rush attempts on which a fumble was lost to the opponent.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
receiver_player_name	String	Display name of the targeted receiver -- the FIRST participant in that role on the play.
Rec	Int64	Receptions credited to the receiver, the number of completions on plays where this player was the targeted receiver.
Tar	Int64	Times the player was targeted on a pass attempt, the denominator behind YPT.
Yds	Float64	Passing yards from the advanced box score.
Rec_TD	Int64	Receiving touchdowns, the count of the player's targeted plays that ended in a passing touchdown.
YPT	Float64	Receiving yards per target, the mean of receiving yardage over every target rather than over receptions only.
EPA	Float64	Expected Points Added on the play (cfbfastR EPA model output).
EPA_per_Play	Float64	EPA per play on the passer's plays.
WPA	Float64	Win Probability Added.
SR	Float64	Success rate on the passer's plays.
Fum	Int64	Count 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_Lost	Int64	Count of the receiver's targeted plays on which a fumble was lost to the opponent.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
def_pos_team_id	Int64	ESPN team id of the team on defense. Present for every season 2004+.
def_pos_team	String	Team name on defense at the start of the play.
scrimmage_plays	Int64	Number of plays from scrimmage (rushes plus passes), excluding special teams.
TFL	Int64	Count of scrimmage plays the defense held to negative yardage (non-penalty, non-special-teams, ESPN statYardage below zero) plus every sack.
TFL_pass	Int64	The TFL count restricted to plays classified as passes, so it covers sacks together with completions and laterals stopped behind the line.
TFL_rush	Int64	The TFL count restricted to plays classified as rushes, that is rushing attempts the defense stopped for negative yardage.
havoc_total	Int64	Total havoc rate.
havoc_total_rate	Float64	Share of the defense's scrimmage plays producing a havoc event, a 0-to-1 fraction equal to havoc_total divided by scrimmage_plays.
fumbles	Int64	Fumbles the defense forced, counted from plays whose narrative contains the phrase forced by, not the total number of fumbles on the play.
def_int	Int64	Interceptions the defense recorded, counted from plays ESPN types as Interception Return or Interception Return Touchdown.
drive_stopped_rate	Float64	Percentage 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_plays	Int64	Number of pass scrimmage plays the defense faced, the denominator behind havoc_total_pass_rate and sacks_rate.
havoc_total_pass	Int64	Havoc events (tackle for loss, sack, interception, forced fumble, or pass breakup) recorded on the pass plays the defense faced.
havoc_total_pass_rate	Float64	havoc_total_pass divided by num_pass_plays, the defense's havoc rate against the pass as a 0-to-1 fraction.
sacks	Int64	Team sacks.
sacks_rate	Float64	Sacks divided by pass plays faced, the defense's per-pass-play sack rate as a 0-to-1 fraction.
pass_breakups	Int64	Passes the defense broke up, counted from plays whose narrative contains the phrase broken up by.
havoc_total_rush	Int64	Havoc events recorded on the rush plays the defense faced, in practice tackles for loss and forced fumbles.
havoc_total_rush_rate	Float64	Havoc events per rush play faced, the mean of the havoc flag over the defense's rush scrimmage plays.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
def_pos_team_id	Int64	ESPN team id of the team on defense. Present for every season 2004+.
def_pos_team	String	Display 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_name	String	Display name of the defender.
sacks	Int64	Sacks recorded by the defender. Available from 2005 on; null for 2004.
sacks_yards	Int64	Yards lost by the offense on the defender's sacks. Available from 2005 on; null for 2004.
fumble_recoveries	Int64	Fumbles recovered by the defender. Available for every season 2004+.
fumble_recoveries_yards	Int64	Yards returned on the defender's fumble recoveries. Available for every season 2004+.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game week of the season.
pass_breakups	Int64	Passes broken up by the defender. Available from 2005 on; null for 2004.
interceptions	Int64	Passes intercepted by the defender. Available from 2014 on; null for 2004-2013, which ESPN ships without interception statistics in this block.
interceptions_yards	Int64	Yards returned on the defender's interceptions. Available from 2014 on; null for 2004-2013.
forced_fumbles	Int64	Fumbles 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
drive_total_available_yards	Float64	Sum 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_yards	Int64	Sum 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_position	Float64	Mean 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_drive	Float64	Mean of ESPN's per-drive offensivePlays taken over plays rather than over drives, which weights every drive by its own length.
yards_per_drive	Float64	Mean 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.
drives	Int64	Number of distinct ESPN drive ids on which the team ran at least one scrimmage play.
drive_total_gained_yards_rate	Float64	Available-yards conversion as a percentage, 100 times drive_total_gained_yards over drive_total_available_yards with both sums play-weighted.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Display name of the team on offense (e.g. 'Ohio State Buckeyes').
EPA_success	Int64	Count of successful plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rate	Float64	Success rate -- the share of those plays ESPN scored as successful.
EPA_success_pass	Int64	Count of successful plays on pass plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_pass_rate	Float64	Success rate on pass plays -- the share of those plays ESPN scored as successful.
EPA_success_rush	Int64	Count of successful plays on rush plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rush_rate	Float64	Success rate on rush plays -- the share of those plays ESPN scored as successful.
EPA_success_rz	Int64	Count of successful plays on the red zone. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rate_rz	Float64	Success rate on the red zone -- the share of those plays ESPN scored as successful.
EPA_success_third	Int64	Count of successful plays on third down. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_rate_third	Float64	Success rate on third down -- the share of those plays ESPN scored as successful.
EPA_success_early_down	Int64	Count of successful plays on early downs. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_early_down_rate	Float64	Success rate on early downs -- the share of those plays ESPN scored as successful.
early_downs	Int64	Number of plays the team ran on early downs.
early_down_pass_rate	Float64	Share of the team's plays on early downs that were pass plays.
early_down_rush_rate	Float64	Share of the team's plays on early downs that were rush plays.
EPA_early_down	Float64	Total EPA the team generated on early downs.
EPA_early_down_per_play	Float64	EPA per play on early downs.
early_down_first_down	Int64	Number of early-down plays that produced a first down.
early_down_first_down_rate	Float64	Share of early-down plays that produced a first down.
early_down_pass	Int64	Number of pass plays the team ran on early downs.
EPA_early_down_pass	Float64	Total EPA the team generated on early downs on pass plays.
EPA_early_down_pass_per_play	Float64	EPA per play on early downs on pass plays.
EPA_success_early_down_pass	Int64	Count 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_rate	Float64	Success rate on early downs on pass plays -- the share of those plays ESPN scored as successful.
early_down_rush	Int64	Number of rush plays the team ran on early downs.
EPA_early_down_rush	Float64	Total EPA the team generated on early downs on rush plays.
EPA_early_down_rush_per_play	Float64	EPA per play on early downs on rush plays.
EPA_success_early_down_rush	Int64	Count 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_rate	Float64	Success rate on early downs on rush plays -- the share of those plays ESPN scored as successful.
middle_8	Int64	Number 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_rate	Float64	Share 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_rate	Float64	Share 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_8	Float64	Total 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_play	Float64	EPA per play on the middle eight -- the closing minutes of the first half and opening minutes of the second.
EPA_middle_8_success	Int64	Count 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_rate	Float64	Success 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_pass	Int64	Number 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_pass	Float64	Total 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_play	Float64	EPA 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_pass	Int64	Count 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_rate	Float64	Success 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_rush	Int64	Number 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_rush	Float64	Total 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_play	Float64	EPA 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_rush	Int64	Count 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_rate	Float64	Success 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_down	Int64	Count of successful plays on late downs. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_success_late_down_pass	Int64	Count 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_rush	Int64	Count of successful plays on late downs on rush plays. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
late_downs	Int64	Number of plays the team ran on late downs.
late_down_pass	Int64	Number of pass plays the team ran on late downs.
late_down_rush	Int64	Number of rush plays the team ran on late downs.
EPA_late_down	Float64	Total EPA the team generated on late downs.
EPA_late_down_per_play	Float64	EPA per play on late downs.
EPA_success_late_down_rate	Float64	Success rate on late downs -- the share of those plays ESPN scored as successful.
EPA_success_late_down_pass_rate	Float64	Success rate on late downs on pass plays -- the share of those plays ESPN scored as successful.
EPA_success_late_down_rush_rate	Float64	Success rate on late downs on rush plays -- the share of those plays ESPN scored as successful.
late_down_pass_rate	Float64	Share of the team's plays on late downs that were pass plays.
late_down_rush_rate	Float64	Share of the team's plays on late downs that were rush plays.
EPA_success_standard_down	Int64	Count 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_rate	Float64	Success rate on standard downs (the team ahead of schedule for the series) -- the share of those plays ESPN scored as successful.
EPA_standard_down	Float64	Total EPA the team generated on standard downs (the team ahead of schedule for the series).
EPA_standard_down_per_play	Float64	EPA per play on standard downs (the team ahead of schedule for the series).
standard_downs	Int64	Number of plays the team ran on standard downs (the team ahead of schedule for the series).
EPA_success_passing_down	Int64	Count 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_rate	Float64	Success rate on passing downs (the team behind schedule for the series) -- the share of those plays ESPN scored as successful.
EPA_passing_down	Float64	Total EPA the team generated on passing downs (the team behind schedule for the series).
EPA_passing_down_per_play	Float64	EPA per play on passing downs (the team behind schedule for the series).
passing_downs	Int64	Number of plays the team ran on passing downs (the team behind schedule for the series).
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
player_name	String	Full name of player
field_goals	Int64	Number of field-goal attempts.
field_goals_yards	Int64	Sum 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.
punts	Int64	Punts attempted.
punts_yards	Int64	Total gross punt yardage parsed from the play text for this punter, working out to roughly 42 yards per punt league-wide.
kick_returns	Int64	Number of kick returns.
kick_returns_yards	Int64	Total yards the team gained returning kickoffs.
punt_returns	Int64	Number of punt returns.
punt_returns_yards	Int64	Total punt-return yardage credited to this returner, with fair catches, downed punts, and out-of-bounds punts scored as zero.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
pos_team_id	Int64	ESPN team id of the team on offense. Present for every season 2004+.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
turnovers	Int64	Turnovers total.
st_turnovers_lost	Int64	Turnovers the team lost on special-teams plays.
Int	Int64	Interceptions thrown.
fumbles_lost	Int64	Fumbles lost.
pass_breakups	Int64	Passes thrown by this offense that the opposing defense broke up; it equals the opponent's row in the advanced defensive table exactly.
total_fumbles	Int64	Team total fumbles.
fumbles_recovered	Int64	Team fumbles recovered.
team_id	Int64	ESPN team id.
turnovers_pbp	Int64	Turnover count derived from the play-by-play, retained unchanged so it can be reconciled against the ESPN-sourced turnovers total.
Int_pbp	Int64	Interception count derived from the play-by-play, kept alongside the ESPN-sourced Int for reconciliation.
fumbles_lost_pbp	Int64	Fumbles-lost count derived from the play-by-play, kept alongside the ESPN-sourced fumbles_lost for reconciliation.
espn_sourced	Boolean	CONSTANT: 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_turnovers	Float64	Turnover expectation for this team, computed as half its total fumbles plus 0.22 times the sum of its pass breakups and interceptions.
expected_turnover_margin	Float64	The opponent's expected_turnovers minus this team's, so positive means the team was expected to win the turnover battle.
turnover_margin	Int64	The opponent's turnovers minus this team's turnovers, positive when the team gained more possessions than it gave away.
turnover_luck	Float64	Points of scoring luck attributed to turnovers, five points per turnover times the gap between turnover_margin and expected_turnover_margin.
takeaways	Int64	Takeaways.
st_turnovers_gained	Int64	Special-teams turnovers this team recovered, taken as the opponent's st_turnovers_lost.
fumble_recoveries_gained	Int64	Opponent fumbles this team recovered, taken as the opponent's fumbles_lost.
game_id	Int64	ESPN game identifier.
season	Int64	Season (4-digit year).
week	Int64	Game 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_name	type	description
game_id	Int64	ESPN game identifier.
id	String	247Sports referencing id for the recruit.
sequenceNumber	String	Broadcast sequence order number.
game_play_number	Int64	Sequential play number within the game (excludes timeouts/end markers).
drive.id	String	ESPN's drive identifier, formed as the game id followed by the drive's sequence number within that game.
season	Int64	Season (4-digit year).
week	Int64	Game week of the season.
period	Int64	Period (quarter) number.
pos_team	Int64	Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_team	Int64	Team name on defense at the start of the play.
start.pos_team.name	String	School name of the team with possession at the snap, taken from ESPN's team location field so it carries no mascot.
homeTeamId	Int64	ESPN team id of the home team, read off the game header and stamped on every play.
awayTeamId	Int64	ESPN team id of the away team, read off the game header and stamped on every play.
homeTeamName	String	Home team's school name from ESPN's team location field, without the mascot.
awayTeamName	String	Away team's school name from ESPN's team location field, without the mascot.
type.text	String	ESPN's play-type label, for example Rush, Pass Reception, Sack, Punt, Penalty, or Timeout.
text	String	Full play description.
start.down	Int64	Down 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.distance	Int64	Yards the offense needs for a first down at the snap, carried through from ESPN without correction.
start.yardsToEndzone	Int64	Distance in yards from the offense's spot at the snap to the opponent's end zone, ranging 0 to 100.
pos_score_diff_start	Int64	Score differential for the possession team at the start of the play.
start.TimeSecsRem	Int64	Seconds remaining in the half at the snap, so it tops out at 1800 rather than counting down from a full game.
start.is_home	Boolean	True when the team holding possession at the snap is the home team.
passing_down	Boolean	True on second and eight or longer, third and five or longer, or fourth and five or longer, the standard obvious-passing-situation flag.
pass	Boolean	Binary flag for a passing play (includes sacks).
rush	Boolean	Binary flag for a rushing play.
completion	Boolean	Binary flag for a completed pass.
scoring_play	Boolean	TRUE if the play resulted in a score.
statYardage	Int64	Yards gained on the play as ESPN reports it, negative on plays that lost yardage.
passer_player_name	String	Display name of the passer -- the FIRST participant in that role on the play.
ep_before	Float64	Expected points value before the play (cfbfastR EPA model).
ep_after	Float64	Expected points value after the play (cfbfastR EPA model).
epa	Float64	Expected points added (EPA) by the posteam for the given play.
wp_before	Float64	Win probability for the possession team before the play (0-1).
wp_after	Float64	Win probability for the possession team after the play (0-1).
wpa	Float64	Win Probability Added on the play (cfbfastR WP model output).
completion_prob	Float64	Modelled probability the pass is completed.
cpoe	Float64	For 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_version	String	Version of the model-scored play-by-play build.
cp_model_version	String	Version of the completion-probability model that scored the play.
ep_model_version	String	Version of the expected-points model that scored the play.
wp_model_version	String	Version of the win-probability model that scored the play.
scored_date	String	Date 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_name	type	description
team_id	Int64	ESPN team id.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
division	String	Division in the conference for the team.
conference	String	Conference of the team.
season	Int64	Season (4-digit year).
player_id	Int64	ESPN player id from the roster entry.
passer_player_name	String	Display name of the passer -- the FIRST participant in that role on the play.
plays	UInt32	Total qualifying passing plays included in the WEPA calculation.
games	UInt32	Number of games included in the ATS summary.
team_games	UInt32	Games the team played, used as the per-game denominator.
TEPA	Float64	Total EPA summed over every play.
EPAplay	Float64	EPA generated per play.
yards	Float64	Total yards gained on the drive.
success	Float64	Success rate across the team plays.
comp	Float64	Completed passes.
att	Float64	Pass attempts thrown.
comppct	Float64	Completion percentage.
passing_td	Float64	Passing touchdowns thrown.
playsgame	Float64	Plays per game.
EPAgame	Float64	EPA generated per game.
yardsplay	Float64	Yards per play.
yardsgame	Float64	Yards per game.
sacked	UInt32	Times the passer was sacked.
sack_yds	Int64	Yards lost to sacks.
sack_epa	Float64	EPA lost on the sacks the team's passers took -- the expected-points cost of those plays.
pass_int	UInt32	Interceptions thrown.
int_epa	Float64	EPA lost on the team's interceptions thrown -- the expected-points cost of the turnovers, not a count.
detmer	Float64	Detmer rating -- the composite passing-efficiency measure this pipeline publishes, named for the college passing-efficiency tradition.
detmergame	Float64	Detmer rating expressed per game.
dropbacks	Float64	Dropbacks taken by the passer.
sack_adj_yards	Float64	Passing yards adjusted for sack yardage lost.
yardsdropback	Float64	Yards per dropback.
TEPA_rank	Float64	Rank of the passer's total EPA summed over every play among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
EPAgame_rank	Float64	Rank of the passer's EPA generated per game among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
EPAplay_rank	Float64	Rank of the passer's EPA generated per play among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
success_rank	Float64	Rank of the passer's success rate across their plays among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
comppct_rank	Float64	Rank of the passer's completion percentage among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
yards_rank	Float64	Rank of the passer's total yards among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
yardsplay_rank	Float64	Rank of the passer's yards per play among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
yardsgame_rank	Float64	Rank of the passer's yards per game among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
sack_adj_yards_rank	Float64	Rank of the passer's passing yards adjusted for sack yardage lost among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
yardsdropback_rank	Float64	Rank of the passer's yards per dropback among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
detmer_rank	Float64	Rank of the passer's detmer rating -- the composite passing-efficiency measure this pipeline publishes, named for the college passing-efficiency tradition among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
detmergame_rank	Float64	Rank of the passer's detmer rating expressed per game among passers clearing the leaderboard minimum of 14 dropbacks per team game, where 1 is best.
fbs_class	String	Power/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_name	type	description
pctile	Float64	Percentile bucket the row reports, from 0 to 100.
GEI	Float64	Value of game excitement index at the percentile this row reports.
EPAplay	Float64	Value of EPA generated per play at the percentile this row reports.
pass_success	Float64	Value of success rate on pass plays at the percentile this row reports.
rush_success	Float64	Value of success rate on rush plays at the percentile this row reports.
early_down_success	Float64	Value of success rate on early downs at the percentile this row reports.
early_down_EPA	Float64	Value of EPA per early-down play at the percentile this row reports.
late_down_success	Float64	Value of success rate on late downs at the percentile this row reports.
success	Float64	Value of success rate across the team plays at the percentile this row reports.
yardsplay	Float64	Value of yards per play at the percentile this row reports.
dropbacks	Float64	Value of dropbacks taken by the passer at the percentile this row reports.
rushes	Float64	Value of rushing attempts at the percentile this row reports.
EPAdropback	Float64	Value of EPA generated per dropback at the percentile this row reports.
EPArush	Float64	Value of EPA generated per rushing attempt at the percentile this row reports.
yardsdropback	Float64	Value of yards per dropback at the percentile this row reports.
pass_explosive	Float64	Value of explosive-play rate on pass plays at the percentile this row reports.
rush_explosive	Float64	Value of explosive-play rate on rush plays at the percentile this row reports.
explosive	Float64	Value of explosive-play rate at the percentile this row reports.
third_down_success	Float64	Value of success rate on third down at the percentile this row reports.
red_zone_success	Float64	Value of success rate in the red zone at the percentile this row reports.
play_stuffed	Float64	Value of stuffed-play rate at the percentile this row reports.
nonExplosiveEpaPerPlay	Float64	Value of EPA per play excluding explosive plays at the percentile this row reports.
havoc	Float64	Value of havoc rate at the percentile this row reports.
yardsrush	Float64	Value of yards per rush at the percentile this row reports.
lineyards	Float64	Value of line yards per rush at the percentile this row reports.
opportunity_run	Float64	Value of opportunity-run rate at the percentile this row reports.
third_down_distance	Float64	Value 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_name	type	description
team_id	Int64	ESPN team id.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
division	String	Division in the conference for the team.
conference	String	Conference of the team.
season	Int64	Season (4-digit year).
player_id	Int64	ESPN player id from the roster entry.
receiver_player_name	String	Display name of the targeted receiver -- the FIRST participant in that role on the play.
plays	UInt32	Total qualifying passing plays included in the WEPA calculation.
games	UInt32	Number of games included in the ATS summary.
team_games	UInt32	Games the team played, used as the per-game denominator.
TEPA	Float64	Total EPA summed over every play.
EPAplay	Float64	EPA generated per play.
yards	Int64	Total yards gained on the drive.
success	Float64	Success rate across the team plays.
comp	UInt32	Completed passes.
targets	UInt32	The number of pass plays where the player was the targeted receiver.
passing_td	Float64	Passing touchdowns thrown.
fumbles	Float64	Count of the receiver's targeted pass plays across the season whose play text mentions a fumble by either team.
playsgame	Float64	Plays per game.
EPAgame	Float64	EPA generated per game.
yardsplay	Float64	Yards per play.
yardsgame	Float64	Yards per game.
catchpct	Float64	Catch rate on a 0-to-1 scale, receptions divided by targets for the season.
TEPA_rank	Float64	Rank of the receiver's total EPA summed over every play among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
EPAgame_rank	Float64	Rank of the receiver's EPA generated per game among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
EPAplay_rank	Float64	Rank of the receiver's EPA generated per play among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
success_rank	Float64	Rank of the receiver's success rate across their plays among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
catchpct_rank	Float64	Season 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_rank	Float64	Rank of the receiver's total yards among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
yardsplay_rank	Float64	Rank of the receiver's yards per play among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
yardsgame_rank	Float64	Rank of the receiver's yards per game among receivers clearing the leaderboard minimum of 1.875 targets per team game, where 1 is best.
fbs_class	String	Power/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_name	type	description
team_id	Int64	ESPN team id.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
division	String	Division in the conference for the team.
conference	String	Conference of the team.
season	Int64	Season (4-digit year).
player_id	Int64	ESPN player id from the roster entry.
rusher_player_name	String	Display name of the ball carrier on a rush -- the FIRST participant in that role on the play.
plays	UInt32	Total qualifying passing plays included in the WEPA calculation.
games	UInt32	Number of games included in the ATS summary.
team_games	UInt32	Games the team played, used as the per-game denominator.
TEPA	Float64	Total EPA summed over every play.
EPAplay	Float64	EPA generated per play.
yards	Int64	Total yards gained on the drive.
success	Float64	Success rate across the team plays.
rushing_td	Float64	Rushing touchdowns.
fumbles	Float64	Count of the ball carrier's rush attempts across the season whose play text mentions a fumble by either team.
playsgame	Float64	Plays per game.
EPAgame	Float64	EPA generated per game.
yardsplay	Float64	Yards per play.
yardsgame	Float64	Yards per game.
TEPA_rank	Float64	Rank of the rusher's total EPA summed over every play among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
EPAgame_rank	Float64	Rank of the rusher's EPA generated per game among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
EPAplay_rank	Float64	Rank of the rusher's EPA generated per play among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
success_rank	Float64	Rank of the rusher's success rate across their plays among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
yards_rank	Float64	Rank of the rusher's total yards among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
yardsplay_rank	Float64	Rank of the rusher's yards per play among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
yardsgame_rank	Float64	Rank of the rusher's yards per game among rushers clearing the leaderboard minimum of 6.25 plays per team game, where 1 is best.
fbs_class	String	Power/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_name	type	description
team_id	Int64	ESPN team id.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
division	String	Division in the conference for the team.
conference	String	Conference of the team.
season	Int64	Season (4-digit year).
plays_off	UInt32	Plays run, with the team on offense.
passrate_off	Float64	Share of plays that were pass plays, with the team on offense.
rushrate_off	Float64	Share of plays that were rush plays, with the team on offense.
havoc_off	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on offense.
explosive_off	Float64	Explosive-play rate -- the share of plays carrying the explosive flag, with the team on offense.
TEPA_off	Float64	Total EPA summed over every play, with the team on offense.
EPAplay_off	Float64	EPA per play, with the team on offense.
yards_off	Int64	Total yards gained, with the team on offense.
yardsplay_off	Float64	Yards gained per play, with the team on offense.
play_stuffed_off	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on offense.
success_off	Float64	Success rate -- the share of plays flagged as successful by EPA, with the team on offense.
red_zone_success_off	Float64	Success rate on red-zone plays, with the team on offense.
third_down_success_off	Float64	Success rate on third-down plays, with the team on offense.
third_down_distance_off	Float64	Average yards to go on third down, with the team on offense.
late_down_success_off	Float64	Success rate on late-down plays, with the team on offense.
early_down_EPA_off	Float64	EPA per early-down play, with the team on offense.
start_position_off	Float64	Average drive start position, measured in yards from the opponent goal line, with the team on offense.
nonExplosiveEpaPerPlay_off	Float64	EPA per play with explosive plays excluded, with the team on offense.
line_yards_off	Float64	Average line yards credited to the offensive line on rushes, with the team on offense.
opportunity_rate_off	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on offense.
playsgame_off	Float64	Plays run per game, with the team on offense.
EPAdrive_off	Float64	EPA per drive (total EPA divided by drives), with the team on offense.
EPAgame_off	Float64	EPA per game (total EPA divided by games), with the team on offense.
yardsgame_off	Float64	Yards gained per game, with the team on offense.
drives_off	UInt32	Offensive drives, with the team on offense.
drivesgame_off	Float64	Drives per game, with the team on offense.
yardsdrive_off	Float64	Yards gained per drive, with the team on offense.
playsdrive_off	Float64	Plays run per drive, with the team on offense.
playsgame_off_rank	Float64	National rank of the team's plays run per game with the team on offense, where 1 is best.
TEPA_off_rank	Float64	National rank of the team's total EPA summed over every play with the team on offense, where 1 is best.
EPAgame_off_rank	Float64	National rank of the team's EPA per game (total EPA divided by games) with the team on offense, where 1 is best.
EPAplay_off_rank	Float64	National rank of the team's EPA per play with the team on offense, where 1 is best.
EPAdrive_off_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per early-down play with the team on offense, where 1 is best.
success_off_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained with the team on offense, where 1 is best.
yardsplay_off_rank	Float64	National rank of the team's yards gained per play with the team on offense, where 1 is best.
yardsgame_off_rank	Float64	National rank of the team's yards gained per game with the team on offense, where 1 is best.
drivesgame_off_rank	Float64	National rank of the team's drives per game with the team on offense, where 1 is best.
yardsdrive_off_rank	Float64	National rank of the team's yards gained per drive with the team on offense, where 1 is best.
playsdrive_off_rank	Float64	National rank of the team's plays run per drive with the team on offense, where 1 is best.
play_stuffed_off_rank	Float64	National 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_rank	Float64	National rank of the team's success rate on red-zone plays with the team on offense, where 1 is best.
third_down_success_off_rank	Float64	National rank of the team's success rate on third-down plays with the team on offense, where 1 is best.
late_down_success_off_rank	Float64	National rank of the team's success rate on late-down plays with the team on offense, where 1 is best.
third_down_distance_off_rank	Float64	National rank of the team's average yards to go on third down with the team on offense, where 1 is best.
start_position_off_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's share of plays that were pass plays with the team on offense, where 1 is best.
rushrate_off_rank	Float64	National rank of the team's share of plays that were rush plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_rank	Float64	National rank of the team's EPA per play with explosive plays excluded with the team on offense, where 1 is best.
line_yards_off_rank	Float64	National 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_rank	Float64	National 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_def	UInt32	Plays run, with the team on defense (i.e. allowed to opponents).
passrate_def	Float64	Share of plays that were pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_def	Float64	Share of plays that were rush plays, with the team on defense (i.e. allowed to opponents).
havoc_def	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on defense (i.e. allowed to opponents).
explosive_def	Float64	Explosive-play rate -- the share of plays carrying the explosive flag, with the team on defense (i.e. allowed to opponents).
TEPA_def	Float64	Total EPA summed over every play, with the team on defense (i.e. allowed to opponents).
EPAplay_def	Float64	EPA per play, with the team on defense (i.e. allowed to opponents).
yards_def	Int64	Total yards gained, with the team on defense (i.e. allowed to opponents).
yardsplay_def	Float64	Yards gained per play, with the team on defense (i.e. allowed to opponents).
play_stuffed_def	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on defense (i.e. allowed to opponents).
success_def	Float64	Success rate -- the share of plays flagged as successful by EPA, with the team on defense (i.e. allowed to opponents).
red_zone_success_def	Float64	Success rate on red-zone plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def	Float64	Success rate on third-down plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def	Float64	Average yards to go on third down, with the team on defense (i.e. allowed to opponents).
late_down_success_def	Float64	Success rate on late-down plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def	Float64	EPA per early-down play, with the team on defense (i.e. allowed to opponents).
start_position_def	Float64	Average drive start position, measured in yards from the opponent goal line, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def	Float64	EPA per play with explosive plays excluded, with the team on defense (i.e. allowed to opponents).
line_yards_def	Float64	Average line yards credited to the offensive line on rushes, with the team on defense (i.e. allowed to opponents).
opportunity_rate_def	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on defense (i.e. allowed to opponents).
playsgame_def	Float64	Plays run per game, with the team on defense (i.e. allowed to opponents).
EPAdrive_def	Float64	EPA per drive (total EPA divided by drives), with the team on defense (i.e. allowed to opponents).
EPAgame_def	Float64	EPA per game (total EPA divided by games), with the team on defense (i.e. allowed to opponents).
yardsgame_def	Float64	Yards gained per game, with the team on defense (i.e. allowed to opponents).
drives_def	UInt32	Offensive drives, with the team on defense (i.e. allowed to opponents).
drivesgame_def	Float64	Drives per game, with the team on defense (i.e. allowed to opponents).
yardsdrive_def	Float64	Yards gained per drive, with the team on defense (i.e. allowed to opponents).
playsdrive_def	Float64	Plays run per drive, with the team on defense (i.e. allowed to opponents).
playsgame_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per play with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's drives per game with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_margin	Float64	Margin in total EPA summed over every play: the team's offensive value minus the value it allowed on defense.
EPAplay_margin	Float64	Margin in EPA per play: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin	Float64	Margin in EPA per drive (total EPA divided by drives): the team's offensive value minus the value it allowed on defense.
EPAgame_margin	Float64	Margin in EPA per game (total EPA divided by games): the team's offensive value minus the value it allowed on defense.
success_margin	Float64	Margin 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_margin	Float64	Margin in yards gained per play: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_margin	Float64	Field-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_rank	Float64	Field-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_off	Float64	Available 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_off	Int64	Total yards the team actually gained across its own drives.
available_yards_pct_off	Float64	Share 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_rank	Float64	National rank of the team's offensive available-yards share, where 1 is best.
total_available_yards_def	Float64	Available 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_def	Int64	Total yards the team allowed across the drives it defended.
available_yards_pct_def	Float64	Share of available yards the team's defense allowed opponents to gain. Lower is better.
available_yards_pct_def_rank	Float64	National rank of the team's defensive available-yards share, where 1 is best.
total_available_yards_margin	Float64	Available yards on the team's own drives minus available yards on drives it defended.
total_gained_yards_margin	Int64	Yards the team gained minus yards it allowed.
available_yards_pct_margin	Float64	Available-yards share gained by the offense minus the share allowed by the defense. Higher is better.
total_available_yards_margin_rank	Float64	National rank of total_available_yards_margin, 1 = largest margin.
total_gained_yards_margin_rank	Float64	National rank of total_gained_yards_margin, 1 = largest margin.
available_yards_pct_margin_rank	Float64	National rank of available_yards_pct_margin, 1 = largest margin.
plays_off_pass	UInt32	Plays run on pass plays, with the team on offense.
passrate_off_pass	Float64	Share of plays that were pass plays on pass plays, with the team on offense.
rushrate_off_pass	Float64	Share of plays that were rush plays on pass plays, with the team on offense.
havoc_off_pass	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays, with the team on offense.
explosive_off_pass	Float64	Explosive-play rate -- the share of plays carrying the explosive flag on pass plays, with the team on offense.
TEPA_off_pass	Float64	Total EPA summed over every play on pass plays, with the team on offense.
EPAplay_off_pass	Float64	EPA per play on pass plays, with the team on offense.
yards_off_pass	Int64	Total yards gained on pass plays, with the team on offense.
yardsplay_off_pass	Float64	Yards gained per play on pass plays, with the team on offense.
play_stuffed_off_pass	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays, with the team on offense.
success_off_pass	Float64	Success rate -- the share of plays flagged as successful by EPA on pass plays, with the team on offense.
red_zone_success_off_pass	Float64	Success rate on red-zone plays on pass plays, with the team on offense.
third_down_success_off_pass	Float64	Success rate on third-down plays on pass plays, with the team on offense.
third_down_distance_off_pass	Float64	Average yards to go on third down on pass plays, with the team on offense.
late_down_success_off_pass	Float64	Success rate on late-down plays on pass plays, with the team on offense.
early_down_EPA_off_pass	Float64	EPA per early-down play on pass plays, with the team on offense.
nonExplosiveEpaPerPlay_off_pass	Float64	EPA per play with explosive plays excluded on pass plays, with the team on offense.
line_yards_off_pass	Float64	Average line yards credited to the offensive line on rushes on pass plays, with the team on offense.
opportunity_rate_off_pass	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on offense.
playsgame_off_pass	Float64	Plays run per game on pass plays, with the team on offense.
EPAdrive_off_pass	Float64	EPA per drive (total EPA divided by drives) on pass plays, with the team on offense.
EPAgame_off_pass	Float64	EPA per game (total EPA divided by games) on pass plays, with the team on offense.
yardsgame_off_pass	Float64	Yards gained per game on pass plays, with the team on offense.
drives_off_pass	UInt32	Offensive drives on pass plays, with the team on offense.
drivesgame_off_pass	Float64	Drives per game on pass plays, with the team on offense.
yardsdrive_off_pass	Float64	Yards gained per drive on pass plays, with the team on offense.
playsdrive_off_pass	Float64	Plays run per drive on pass plays, with the team on offense.
playsgame_off_pass_rank	Float64	National rank of the team's plays run per game on pass plays with the team on offense, where 1 is best.
TEPA_off_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per play on pass plays with the team on offense, where 1 is best.
EPAdrive_off_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained on pass plays with the team on offense, where 1 is best.
yardsplay_off_pass_rank	Float64	National rank of the team's yards gained per play on pass plays with the team on offense, where 1 is best.
yardsgame_off_pass_rank	Float64	National rank of the team's yards gained per game on pass plays with the team on offense, where 1 is best.
drivesgame_off_pass_rank	Float64	National rank of the team's drives per game on pass plays with the team on offense, where 1 is best.
yardsdrive_off_pass_rank	Float64	National rank of the team's yards gained per drive on pass plays with the team on offense, where 1 is best.
playsdrive_off_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_pass	UInt32	Plays run on pass plays, with the team on defense (i.e. allowed to opponents).
passrate_def_pass	Float64	Share of plays that were pass plays on pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_pass	Float64	Share of plays that were rush plays on pass plays, with the team on defense (i.e. allowed to opponents).
havoc_def_pass	Float64	Havoc 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_pass	Float64	Explosive-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_pass	Float64	Total EPA summed over every play on pass plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_pass	Float64	EPA per play on pass plays, with the team on defense (i.e. allowed to opponents).
yards_def_pass	Int64	Total yards gained on pass plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_pass	Float64	Yards gained per play on pass plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_pass	Float64	Stuffed-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_pass	Float64	Success 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_pass	Float64	Success rate on red-zone plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_pass	Float64	Success rate on third-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_pass	Float64	Average yards to go on third down on pass plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_pass	Float64	Success rate on late-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_pass	Float64	EPA per early-down play on pass plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_pass	Float64	EPA per play with explosive plays excluded on pass plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_pass	Float64	Average 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_pass	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_pass	Float64	Plays run per game on pass plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_pass	Float64	EPA per drive (total EPA divided by drives) on pass plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_pass	Float64	EPA per game (total EPA divided by games) on pass plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_pass	Float64	Yards gained per game on pass plays, with the team on defense (i.e. allowed to opponents).
drives_def_pass	UInt32	Offensive drives on pass plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_pass	Float64	Drives per game on pass plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_pass	Float64	Yards gained per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_pass	Float64	Plays run per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_pass	Float64	Margin in total EPA summed over every play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_pass	Float64	Margin in EPA per play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_pass	Float64	Margin 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_pass	Float64	Margin 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_pass	Float64	Margin 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_pass	Float64	Margin in yards gained per play on pass plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_pass_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rush	UInt32	Plays run on rush plays, with the team on offense.
passrate_off_rush	Float64	Share of plays that were pass plays on rush plays, with the team on offense.
rushrate_off_rush	Float64	Share of plays that were rush plays on rush plays, with the team on offense.
havoc_off_rush	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays, with the team on offense.
explosive_off_rush	Float64	Explosive-play rate -- the share of plays carrying the explosive flag on rush plays, with the team on offense.
TEPA_off_rush	Float64	Total EPA summed over every play on rush plays, with the team on offense.
EPAplay_off_rush	Float64	EPA per play on rush plays, with the team on offense.
yards_off_rush	Int64	Total yards gained on rush plays, with the team on offense.
yardsplay_off_rush	Float64	Yards gained per play on rush plays, with the team on offense.
play_stuffed_off_rush	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays, with the team on offense.
success_off_rush	Float64	Success rate -- the share of plays flagged as successful by EPA on rush plays, with the team on offense.
red_zone_success_off_rush	Float64	Success rate on red-zone plays on rush plays, with the team on offense.
third_down_success_off_rush	Float64	Success rate on third-down plays on rush plays, with the team on offense.
third_down_distance_off_rush	Float64	Average yards to go on third down on rush plays, with the team on offense.
late_down_success_off_rush	Float64	Success rate on late-down plays on rush plays, with the team on offense.
early_down_EPA_off_rush	Float64	EPA per early-down play on rush plays, with the team on offense.
nonExplosiveEpaPerPlay_off_rush	Float64	EPA per play with explosive plays excluded on rush plays, with the team on offense.
line_yards_off_rush	Float64	Average line yards credited to the offensive line on rushes on rush plays, with the team on offense.
opportunity_rate_off_rush	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on offense.
playsgame_off_rush	Float64	Plays run per game on rush plays, with the team on offense.
EPAdrive_off_rush	Float64	EPA per drive (total EPA divided by drives) on rush plays, with the team on offense.
EPAgame_off_rush	Float64	EPA per game (total EPA divided by games) on rush plays, with the team on offense.
yardsgame_off_rush	Float64	Yards gained per game on rush plays, with the team on offense.
drives_off_rush	UInt32	Offensive drives on rush plays, with the team on offense.
drivesgame_off_rush	Float64	Drives per game on rush plays, with the team on offense.
yardsdrive_off_rush	Float64	Yards gained per drive on rush plays, with the team on offense.
playsdrive_off_rush	Float64	Plays run per drive on rush plays, with the team on offense.
playsgame_off_rush_rank	Float64	National rank of the team's plays run per game on rush plays with the team on offense, where 1 is best.
TEPA_off_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per play on rush plays with the team on offense, where 1 is best.
EPAdrive_off_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained on rush plays with the team on offense, where 1 is best.
yardsplay_off_rush_rank	Float64	National rank of the team's yards gained per play on rush plays with the team on offense, where 1 is best.
yardsgame_off_rush_rank	Float64	National rank of the team's yards gained per game on rush plays with the team on offense, where 1 is best.
drivesgame_off_rush_rank	Float64	National rank of the team's drives per game on rush plays with the team on offense, where 1 is best.
yardsdrive_off_rush_rank	Float64	National rank of the team's yards gained per drive on rush plays with the team on offense, where 1 is best.
playsdrive_off_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rush	UInt32	Plays run on rush plays, with the team on defense (i.e. allowed to opponents).
passrate_def_rush	Float64	Share of plays that were pass plays on rush plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_rush	Float64	Share of plays that were rush plays on rush plays, with the team on defense (i.e. allowed to opponents).
havoc_def_rush	Float64	Havoc 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_rush	Float64	Explosive-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_rush	Float64	Total EPA summed over every play on rush plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_rush	Float64	EPA per play on rush plays, with the team on defense (i.e. allowed to opponents).
yards_def_rush	Int64	Total yards gained on rush plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_rush	Float64	Yards gained per play on rush plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_rush	Float64	Stuffed-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_rush	Float64	Success 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_rush	Float64	Success rate on red-zone plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_rush	Float64	Success rate on third-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_rush	Float64	Average yards to go on third down on rush plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_rush	Float64	Success rate on late-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_rush	Float64	EPA per early-down play on rush plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_rush	Float64	EPA per play with explosive plays excluded on rush plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_rush	Float64	Average 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_rush	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rush	Float64	Plays run per game on rush plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_rush	Float64	EPA per drive (total EPA divided by drives) on rush plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_rush	Float64	EPA per game (total EPA divided by games) on rush plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_rush	Float64	Yards gained per game on rush plays, with the team on defense (i.e. allowed to opponents).
drives_def_rush	UInt32	Offensive drives on rush plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_rush	Float64	Drives per game on rush plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_rush	Float64	Yards gained per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_rush	Float64	Plays run per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rush	Float64	Margin in total EPA summed over every play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_rush	Float64	Margin in EPA per play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_rush	Float64	Margin 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_rush	Float64	Margin 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_rush	Float64	Margin 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_rush	Float64	Margin in yards gained per play on rush plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rush_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_class	String	Power/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_games	UInt32	Number 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_epa	Float64	Offensive 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_epa	Float64	Defensive 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_faced	Float64	Average 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_faced	Float64	Average 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_epa	Float64	Net opponent-adjusted EPA per play: adj_off_epa minus adj_def_epa. Higher is better.
adj_off_epa_rank	Float64	National rank of the team's adj_off_epa, where 1 is best.
adj_def_epa_rank	Float64	National rank of the team's adj_def_epa, where 1 is best (fewest EPA allowed).
net_adj_epa_rank	Float64	National 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_name	type	description
season	Int64	Season (4-digit year).
week	Int64	Game week of the season.
season_type	Int32	ESPN season type (2 = regular, 3 = postseason).
game_id	Int64	ESPN game identifier.
start_date	String	Season start timestamp (ISO 8601, UTC).
team_id	Int64	ESPN team id.
team	String	Team name.
opponent_id	Int64	ESPN team id of the opponent.
opponent	String	Opponent team name.
is_home	Boolean	Whether the subject team was the home team.
neutral_site	Boolean	TRUE/FALSE flag for if the game took place at a neutral site.
points_for	Int64	Goals/points scored.
points_against	Int64	Points allowed.
margin	Int64	Final scoring margin from this team's perspective, exactly points_for minus points_against.
win	Boolean	Whether the game was a win (goalie).
rushing_highlight_yards_per_opp	Float64	Highlight yards per rushing opportunity.
total_pen_yards	Int64	Total penalty yards assessed.
EPA_penalty	Float64	Total EPA attributed to penalties.
penalty_first_downs_created	Int64	Number of first downs the team gained via opponent penalty.
penalty_first_downs_created_rate	Float64	Share of the team's first downs that came via opponent penalty.
penalties	Int64	Number of penalties assessed against the team.
penalty_yards	Int64	Net penalty yardage assessed against the team; can be negative when enforcement moved the team forward on balance.
special_teams_plays	Int64	Number of special-teams plays.
EPA_sp	Float64	Total special-teams EPA, ESPN's abbreviated field for the same phase.
EPA_special_teams	Float64	Total EPA generated on special-teams plays.
field_goals	Int64	Number of field-goal attempts.
EPA_fg	Float64	Total EPA on field-goal attempts.
punt_plays	Int64	Number of punt plays.
EPA_punt	Float64	Total EPA on punt plays.
kickoff_plays	Int64	Number of kickoff plays.
EPA_kickoff	Float64	Total EPA on kickoff plays.
rushes	Int64	Number of rushing attempts.
rush_yards	Float64	Total yards the team gained on rush plays.
yards_per_rush	Float64	Yards gained per rushing attempt.
rushing_power_rate	Float64	Share of carries that were power rushing attempts.
rushing_first_downs_created	Int64	Number of first downs created on rush plays.
rushing_first_downs_created_rate	Float64	Share of rush plays that created a first down.
EPA_rushing_overall	Float64	Total EPA on rush plays.
EPA_rushing_per_play	Float64	EPA per rush play.
EPA_explosive_rushing	Int64	Count of explosive rush plays. A play count, not an EPA total.
EPA_explosive_rushing_rate	Float64	Explosive-play rate on rush plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_rushing	Float64	Total EPA on rush plays with explosive plays excluded.
EPA_non_explosive_rushing_per_play	Float64	EPA per rush play with explosive plays excluded.
passes	Int64	Number of pass plays the team ran.
pass_yards	Float64	Total yards the team gained on pass plays.
yards_per_pass	Float64	Team game yards per pass.
passing_first_downs_created	Int64	Number of first downs created on pass plays.
passing_first_downs_created_rate	Float64	Share of pass plays that created a first down.
EPA_passing_overall	Float64	Total EPA on pass plays.
EPA_passing_per_play	Float64	EPA per pass play.
EPA_explosive_passing	Int64	Count of explosive pass plays. A play count, not an EPA total.
EPA_explosive_passing_rate	Float64	Explosive-play rate on pass plays, over ESPN's qualifying-play denominator.
EPA_non_explosive_passing	Float64	Total EPA on pass plays with explosive plays excluded.
EPA_non_explosive_passing_per_play	Float64	EPA per pass play with explosive plays excluded.
scrimmage_plays	Int64	Number of plays from scrimmage (rushes plus passes), excluding special teams.
EPA_overall_off	Float64	Total offensive EPA for the team. Duplicated exactly by EPA_overall_offense in every published season checked -- prefer one and ignore the other.
EPA_overall_offense	Float64	Total offensive EPA. An exact duplicate of EPA_overall_off.
EPA_per_play	Float64	Offensive EPA per play.
EPA_non_explosive	Float64	Total EPA with explosive plays excluded, isolating the team's routine-down production.
EPA_non_explosive_per_play	Float64	EPA per play with explosive plays excluded.
EPA_explosive	Int64	Count of explosive plays, per ESPN's advanced box score. Despite the EPA_ prefix this is a play COUNT, not an EPA total.
EPA_explosive_rate	Float64	Explosive-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_rate	Float64	Share of the team's plays from scrimmage that were pass plays.
off_yards	Int64	Offensive yards gained from scrimmage.
total_off_yards	Int64	Total offensive yards across all plays.
yards_per_play	Float64	Yards gained per play.
EPA_plays	Int64	Number of plays ESPN's advanced box score scored for the team.
total_yards	Int64	Total yards the team gained across all plays.
EPA_overall_total	Float64	Total EPA across all phases, which is why it differs from the offense-only EPA_overall_off.
rushes_rate	Float64	Share of the team's plays from scrimmage that were rush plays.
first_downs_created	Int64	Number of first downs the team created.
first_downs_created_rate	Float64	Share of the team's plays that created a first down.
EPA_rushing_power	Float64	Total EPA on power rushing situations, as classified by ESPN's advanced box score.
EPA_rushing_power_per_play	Float64	EPA per play on power rushing situations.
rushing_power_success	Int64	Count 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_rate	Float64	Share of power rushing attempts that succeeded.
rushing_power	Int64	Count of power rushing attempts, in short-yardage situations as classified by ESPN's advanced box score.
rushing_stuff	Int64	Count of stuffed rushing attempts.
rushing_stuff_rate	Float64	Share of the team's carries that were stuffed at or behind the line of scrimmage.
rushing_stopped	Int64	Count of rushing attempts stopped at or behind the line of scrimmage.
rushing_stopped_rate	Float64	Share of carries stopped at or behind the line of scrimmage.
rushing_opportunity	Int64	Count of rushing opportunities -- carries that reached ESPN's opportunity threshold.
rushing_opportunity_rate	Float64	Share of carries that qualified as rushing opportunities.
rushing_highlight	Int64	Highlight yards -- rushing yardage credited to the back rather than the offensive line.
rushing_highlight_rate	Float64	Share of rushing yardage that was highlight (back-credited) yardage.
rushing_highlight_yards	Float64	Total 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_yards	Float64	Line 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_carry	Float64	Line yards per rushing attempt.
second_level_yards	Float64	Second-level yards -- rushing yardage earned just beyond the line of scrimmage.
open_field_yards	Float64	Open-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_name	type	description
season	Int64	Season (4-digit year).
team_id	Int64	ESPN team id.
adj_off_epa	Float64	Opponent-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_epa	Float64	Opponent-adjusted EPA per play allowed as of the snapshot week, netted the same way as the offensive rating, so lower is better.
adj_st_epa	Float64	Special-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_net	Float64	adj_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_off	Float64	Drive-level offensive rating at the snapshot week, from a ridge fit on per-drive EPA.
fei_def	Float64	Drive-level defensive rating at the snapshot week, from the same per-drive ridge fit and on the same scale as fei_off.
fei_net	Float64	fei_off minus fei_def at the snapshot week, the team's overall drive-efficiency rating.
games	Int64	Number of games included in the ATS summary.
off_pace	Float64	Scrimmage plays per game through the snapshot week, the tempo input consumed by the totals model.
off_rank	Int64	Dense rank of adj_off_epa in descending order within the snapshot week, so rank 1 is the most efficient offense at that point.
def_rank	Int64	Dense rank of adj_def_epa in ascending order within the snapshot week, so rank 1 is the stingiest defense at that point.
net_rank	Int64	Dense rank of adj_net in descending order within the snapshot week, so rank 1 is the strongest overall team at that point.
net_z	Float64	adj_net restated as a z-score against the mean and standard deviation of adj_net across the teams rated in that snapshot week.
through_week	Int32	Regular-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_name	type	description
team_id	Int64	ESPN team id.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
division	String	Division in the conference for the team.
conference	String	Conference of the team.
season	Int64	Season (4-digit year).
plays_off	UInt32	Plays run, with the team on offense.
passrate_off	Float64	Share of plays that were pass plays, with the team on offense.
rushrate_off	Float64	Share of plays that were rush plays, with the team on offense.
havoc_off	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on offense.
explosive_off	Float64	Explosive-play rate -- the share of plays carrying the explosive flag, with the team on offense.
TEPA_off	Float64	Total EPA summed over every play, with the team on offense.
EPAplay_off	Float64	EPA per play, with the team on offense.
yards_off	Int64	Total yards gained, with the team on offense.
yardsplay_off	Float64	Yards gained per play, with the team on offense.
play_stuffed_off	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on offense.
success_off	Float64	Success rate -- the share of plays flagged as successful by EPA, with the team on offense.
red_zone_success_off	Float64	Success rate on red-zone plays, with the team on offense.
third_down_success_off	Float64	Success rate on third-down plays, with the team on offense.
third_down_distance_off	Float64	Average yards to go on third down, with the team on offense.
late_down_success_off	Float64	Success rate on late-down plays, with the team on offense.
early_down_EPA_off	Float64	EPA per early-down play, with the team on offense.
start_position_off	Float64	Average drive start position, measured in yards from the opponent goal line, with the team on offense.
nonExplosiveEpaPerPlay_off	Float64	EPA per play with explosive plays excluded, with the team on offense.
line_yards_off	Float64	Average line yards credited to the offensive line on rushes, with the team on offense.
opportunity_rate_off	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on offense.
playsgame_off	Float64	Plays run per game, with the team on offense.
EPAdrive_off	Float64	EPA per drive (total EPA divided by drives), with the team on offense.
EPAgame_off	Float64	EPA per game (total EPA divided by games), with the team on offense.
yardsgame_off	Float64	Yards gained per game, with the team on offense.
drives_off	UInt32	Offensive drives, with the team on offense.
drivesgame_off	Float64	Drives per game, with the team on offense.
yardsdrive_off	Float64	Yards gained per drive, with the team on offense.
playsdrive_off	Float64	Plays run per drive, with the team on offense.
playsgame_off_rank	Float64	National rank of the team's plays run per game with the team on offense, where 1 is best.
TEPA_off_rank	Float64	National rank of the team's total EPA summed over every play with the team on offense, where 1 is best.
EPAgame_off_rank	Float64	National rank of the team's EPA per game (total EPA divided by games) with the team on offense, where 1 is best.
EPAplay_off_rank	Float64	National rank of the team's EPA per play with the team on offense, where 1 is best.
EPAdrive_off_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per early-down play with the team on offense, where 1 is best.
success_off_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained with the team on offense, where 1 is best.
yardsplay_off_rank	Float64	National rank of the team's yards gained per play with the team on offense, where 1 is best.
yardsgame_off_rank	Float64	National rank of the team's yards gained per game with the team on offense, where 1 is best.
drivesgame_off_rank	Float64	National rank of the team's drives per game with the team on offense, where 1 is best.
yardsdrive_off_rank	Float64	National rank of the team's yards gained per drive with the team on offense, where 1 is best.
playsdrive_off_rank	Float64	National rank of the team's plays run per drive with the team on offense, where 1 is best.
play_stuffed_off_rank	Float64	National 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_rank	Float64	National rank of the team's success rate on red-zone plays with the team on offense, where 1 is best.
third_down_success_off_rank	Float64	National rank of the team's success rate on third-down plays with the team on offense, where 1 is best.
late_down_success_off_rank	Float64	National rank of the team's success rate on late-down plays with the team on offense, where 1 is best.
third_down_distance_off_rank	Float64	National rank of the team's average yards to go on third down with the team on offense, where 1 is best.
start_position_off_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's share of plays that were pass plays with the team on offense, where 1 is best.
rushrate_off_rank	Float64	National rank of the team's share of plays that were rush plays with the team on offense, where 1 is best.
nonExplosiveEpaPerPlay_off_rank	Float64	National rank of the team's EPA per play with explosive plays excluded with the team on offense, where 1 is best.
line_yards_off_rank	Float64	National 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_rank	Float64	National 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_def	UInt32	Plays run, with the team on defense (i.e. allowed to opponents).
passrate_def	Float64	Share of plays that were pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_def	Float64	Share of plays that were rush plays, with the team on defense (i.e. allowed to opponents).
havoc_def	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag, with the team on defense (i.e. allowed to opponents).
explosive_def	Float64	Explosive-play rate -- the share of plays carrying the explosive flag, with the team on defense (i.e. allowed to opponents).
TEPA_def	Float64	Total EPA summed over every play, with the team on defense (i.e. allowed to opponents).
EPAplay_def	Float64	EPA per play, with the team on defense (i.e. allowed to opponents).
yards_def	Int64	Total yards gained, with the team on defense (i.e. allowed to opponents).
yardsplay_def	Float64	Yards gained per play, with the team on defense (i.e. allowed to opponents).
play_stuffed_def	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag, with the team on defense (i.e. allowed to opponents).
success_def	Float64	Success rate -- the share of plays flagged as successful by EPA, with the team on defense (i.e. allowed to opponents).
red_zone_success_def	Float64	Success rate on red-zone plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def	Float64	Success rate on third-down plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def	Float64	Average yards to go on third down, with the team on defense (i.e. allowed to opponents).
late_down_success_def	Float64	Success rate on late-down plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def	Float64	EPA per early-down play, with the team on defense (i.e. allowed to opponents).
start_position_def	Float64	Average drive start position, measured in yards from the opponent goal line, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def	Float64	EPA per play with explosive plays excluded, with the team on defense (i.e. allowed to opponents).
line_yards_def	Float64	Average line yards credited to the offensive line on rushes, with the team on defense (i.e. allowed to opponents).
opportunity_rate_def	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag, with the team on defense (i.e. allowed to opponents).
playsgame_def	Float64	Plays run per game, with the team on defense (i.e. allowed to opponents).
EPAdrive_def	Float64	EPA per drive (total EPA divided by drives), with the team on defense (i.e. allowed to opponents).
EPAgame_def	Float64	EPA per game (total EPA divided by games), with the team on defense (i.e. allowed to opponents).
yardsgame_def	Float64	Yards gained per game, with the team on defense (i.e. allowed to opponents).
drives_def	UInt32	Offensive drives, with the team on defense (i.e. allowed to opponents).
drivesgame_def	Float64	Drives per game, with the team on defense (i.e. allowed to opponents).
yardsdrive_def	Float64	Yards gained per drive, with the team on defense (i.e. allowed to opponents).
playsdrive_def	Float64	Plays run per drive, with the team on defense (i.e. allowed to opponents).
playsgame_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per play with the team on defense (i.e. allowed to opponents), where 1 is best.
EPAdrive_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsplay_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's drives per game with the team on defense (i.e. allowed to opponents), where 1 is best.
yardsdrive_def_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_margin	Float64	Margin in total EPA summed over every play: the team's offensive value minus the value it allowed on defense.
EPAplay_margin	Float64	Margin in EPA per play: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin	Float64	Margin in EPA per drive (total EPA divided by drives): the team's offensive value minus the value it allowed on defense.
EPAgame_margin	Float64	Margin in EPA per game (total EPA divided by games): the team's offensive value minus the value it allowed on defense.
success_margin	Float64	Margin 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_margin	Float64	Margin in yards gained per play: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_margin	Float64	Field-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_rank	Float64	Field-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_off	Float64	Available 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_off	Int64	Total yards the team actually gained across its own drives.
available_yards_pct_off	Float64	Share 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_rank	Float64	National rank of the team's offensive available-yards share, where 1 is best.
total_available_yards_def	Float64	Available 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_def	Int64	Total yards the team allowed across the drives it defended.
available_yards_pct_def	Float64	Share of available yards the team's defense allowed opponents to gain. Lower is better.
available_yards_pct_def_rank	Float64	National rank of the team's defensive available-yards share, where 1 is best.
total_available_yards_margin	Float64	Available yards on the team's own drives minus available yards on drives it defended.
total_gained_yards_margin	Int64	Yards the team gained minus yards it allowed.
available_yards_pct_margin	Float64	Available-yards share gained by the offense minus the share allowed by the defense. Higher is better.
total_available_yards_margin_rank	Float64	National rank of total_available_yards_margin, 1 = largest margin.
total_gained_yards_margin_rank	Float64	National rank of total_gained_yards_margin, 1 = largest margin.
available_yards_pct_margin_rank	Float64	National rank of available_yards_pct_margin, 1 = largest margin.
plays_off_pass	UInt32	Plays run on pass plays, with the team on offense.
passrate_off_pass	Float64	Share of plays that were pass plays on pass plays, with the team on offense.
rushrate_off_pass	Float64	Share of plays that were rush plays on pass plays, with the team on offense.
havoc_off_pass	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag on pass plays, with the team on offense.
explosive_off_pass	Float64	Explosive-play rate -- the share of plays carrying the explosive flag on pass plays, with the team on offense.
TEPA_off_pass	Float64	Total EPA summed over every play on pass plays, with the team on offense.
EPAplay_off_pass	Float64	EPA per play on pass plays, with the team on offense.
yards_off_pass	Int64	Total yards gained on pass plays, with the team on offense.
yardsplay_off_pass	Float64	Yards gained per play on pass plays, with the team on offense.
play_stuffed_off_pass	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag on pass plays, with the team on offense.
success_off_pass	Float64	Success rate -- the share of plays flagged as successful by EPA on pass plays, with the team on offense.
red_zone_success_off_pass	Float64	Success rate on red-zone plays on pass plays, with the team on offense.
third_down_success_off_pass	Float64	Success rate on third-down plays on pass plays, with the team on offense.
third_down_distance_off_pass	Float64	Average yards to go on third down on pass plays, with the team on offense.
late_down_success_off_pass	Float64	Success rate on late-down plays on pass plays, with the team on offense.
early_down_EPA_off_pass	Float64	EPA per early-down play on pass plays, with the team on offense.
nonExplosiveEpaPerPlay_off_pass	Float64	EPA per play with explosive plays excluded on pass plays, with the team on offense.
line_yards_off_pass	Float64	Average line yards credited to the offensive line on rushes on pass plays, with the team on offense.
opportunity_rate_off_pass	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on offense.
playsgame_off_pass	Float64	Plays run per game on pass plays, with the team on offense.
EPAdrive_off_pass	Float64	EPA per drive (total EPA divided by drives) on pass plays, with the team on offense.
EPAgame_off_pass	Float64	EPA per game (total EPA divided by games) on pass plays, with the team on offense.
yardsgame_off_pass	Float64	Yards gained per game on pass plays, with the team on offense.
drives_off_pass	UInt32	Offensive drives on pass plays, with the team on offense.
drivesgame_off_pass	Float64	Drives per game on pass plays, with the team on offense.
yardsdrive_off_pass	Float64	Yards gained per drive on pass plays, with the team on offense.
playsdrive_off_pass	Float64	Plays run per drive on pass plays, with the team on offense.
playsgame_off_pass_rank	Float64	National rank of the team's plays run per game on pass plays with the team on offense, where 1 is best.
TEPA_off_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per play on pass plays with the team on offense, where 1 is best.
EPAdrive_off_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained on pass plays with the team on offense, where 1 is best.
yardsplay_off_pass_rank	Float64	National rank of the team's yards gained per play on pass plays with the team on offense, where 1 is best.
yardsgame_off_pass_rank	Float64	National rank of the team's yards gained per game on pass plays with the team on offense, where 1 is best.
drivesgame_off_pass_rank	Float64	National rank of the team's drives per game on pass plays with the team on offense, where 1 is best.
yardsdrive_off_pass_rank	Float64	National rank of the team's yards gained per drive on pass plays with the team on offense, where 1 is best.
playsdrive_off_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_pass	UInt32	Plays run on pass plays, with the team on defense (i.e. allowed to opponents).
passrate_def_pass	Float64	Share of plays that were pass plays on pass plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_pass	Float64	Share of plays that were rush plays on pass plays, with the team on defense (i.e. allowed to opponents).
havoc_def_pass	Float64	Havoc 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_pass	Float64	Explosive-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_pass	Float64	Total EPA summed over every play on pass plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_pass	Float64	EPA per play on pass plays, with the team on defense (i.e. allowed to opponents).
yards_def_pass	Int64	Total yards gained on pass plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_pass	Float64	Yards gained per play on pass plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_pass	Float64	Stuffed-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_pass	Float64	Success 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_pass	Float64	Success rate on red-zone plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_pass	Float64	Success rate on third-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_pass	Float64	Average yards to go on third down on pass plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_pass	Float64	Success rate on late-down plays on pass plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_pass	Float64	EPA per early-down play on pass plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_pass	Float64	EPA per play with explosive plays excluded on pass plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_pass	Float64	Average 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_pass	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_pass	Float64	Plays run per game on pass plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_pass	Float64	EPA per drive (total EPA divided by drives) on pass plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_pass	Float64	EPA per game (total EPA divided by games) on pass plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_pass	Float64	Yards gained per game on pass plays, with the team on defense (i.e. allowed to opponents).
drives_def_pass	UInt32	Offensive drives on pass plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_pass	Float64	Drives per game on pass plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_pass	Float64	Yards gained per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_pass	Float64	Plays run per drive on pass plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_pass_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_pass	Float64	Margin in total EPA summed over every play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_pass	Float64	Margin in EPA per play on pass plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_pass	Float64	Margin 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_pass	Float64	Margin 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_pass	Float64	Margin 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_pass	Float64	Margin in yards gained per play on pass plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_pass_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rush	UInt32	Plays run on rush plays, with the team on offense.
passrate_off_rush	Float64	Share of plays that were pass plays on rush plays, with the team on offense.
rushrate_off_rush	Float64	Share of plays that were rush plays on rush plays, with the team on offense.
havoc_off_rush	Float64	Havoc rate -- the share of plays carrying the defensive-disruption flag on rush plays, with the team on offense.
explosive_off_rush	Float64	Explosive-play rate -- the share of plays carrying the explosive flag on rush plays, with the team on offense.
TEPA_off_rush	Float64	Total EPA summed over every play on rush plays, with the team on offense.
EPAplay_off_rush	Float64	EPA per play on rush plays, with the team on offense.
yards_off_rush	Int64	Total yards gained on rush plays, with the team on offense.
yardsplay_off_rush	Float64	Yards gained per play on rush plays, with the team on offense.
play_stuffed_off_rush	Float64	Stuffed-play rate -- the share of plays carrying the stuffed flag on rush plays, with the team on offense.
success_off_rush	Float64	Success rate -- the share of plays flagged as successful by EPA on rush plays, with the team on offense.
red_zone_success_off_rush	Float64	Success rate on red-zone plays on rush plays, with the team on offense.
third_down_success_off_rush	Float64	Success rate on third-down plays on rush plays, with the team on offense.
third_down_distance_off_rush	Float64	Average yards to go on third down on rush plays, with the team on offense.
late_down_success_off_rush	Float64	Success rate on late-down plays on rush plays, with the team on offense.
early_down_EPA_off_rush	Float64	EPA per early-down play on rush plays, with the team on offense.
nonExplosiveEpaPerPlay_off_rush	Float64	EPA per play with explosive plays excluded on rush plays, with the team on offense.
line_yards_off_rush	Float64	Average line yards credited to the offensive line on rushes on rush plays, with the team on offense.
opportunity_rate_off_rush	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on offense.
playsgame_off_rush	Float64	Plays run per game on rush plays, with the team on offense.
EPAdrive_off_rush	Float64	EPA per drive (total EPA divided by drives) on rush plays, with the team on offense.
EPAgame_off_rush	Float64	EPA per game (total EPA divided by games) on rush plays, with the team on offense.
yardsgame_off_rush	Float64	Yards gained per game on rush plays, with the team on offense.
drives_off_rush	UInt32	Offensive drives on rush plays, with the team on offense.
drivesgame_off_rush	Float64	Drives per game on rush plays, with the team on offense.
yardsdrive_off_rush	Float64	Yards gained per drive on rush plays, with the team on offense.
playsdrive_off_rush	Float64	Plays run per drive on rush plays, with the team on offense.
playsgame_off_rush_rank	Float64	National rank of the team's plays run per game on rush plays with the team on offense, where 1 is best.
TEPA_off_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's EPA per play on rush plays with the team on offense, where 1 is best.
EPAdrive_off_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National rank of the team's total yards gained on rush plays with the team on offense, where 1 is best.
yardsplay_off_rush_rank	Float64	National rank of the team's yards gained per play on rush plays with the team on offense, where 1 is best.
yardsgame_off_rush_rank	Float64	National rank of the team's yards gained per game on rush plays with the team on offense, where 1 is best.
drivesgame_off_rush_rank	Float64	National rank of the team's drives per game on rush plays with the team on offense, where 1 is best.
yardsdrive_off_rush_rank	Float64	National rank of the team's yards gained per drive on rush plays with the team on offense, where 1 is best.
playsdrive_off_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rush	UInt32	Plays run on rush plays, with the team on defense (i.e. allowed to opponents).
passrate_def_rush	Float64	Share of plays that were pass plays on rush plays, with the team on defense (i.e. allowed to opponents).
rushrate_def_rush	Float64	Share of plays that were rush plays on rush plays, with the team on defense (i.e. allowed to opponents).
havoc_def_rush	Float64	Havoc 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_rush	Float64	Explosive-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_rush	Float64	Total EPA summed over every play on rush plays, with the team on defense (i.e. allowed to opponents).
EPAplay_def_rush	Float64	EPA per play on rush plays, with the team on defense (i.e. allowed to opponents).
yards_def_rush	Int64	Total yards gained on rush plays, with the team on defense (i.e. allowed to opponents).
yardsplay_def_rush	Float64	Yards gained per play on rush plays, with the team on defense (i.e. allowed to opponents).
play_stuffed_def_rush	Float64	Stuffed-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_rush	Float64	Success 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_rush	Float64	Success rate on red-zone plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_success_def_rush	Float64	Success rate on third-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
third_down_distance_def_rush	Float64	Average yards to go on third down on rush plays, with the team on defense (i.e. allowed to opponents).
late_down_success_def_rush	Float64	Success rate on late-down plays on rush plays, with the team on defense (i.e. allowed to opponents).
early_down_EPA_def_rush	Float64	EPA per early-down play on rush plays, with the team on defense (i.e. allowed to opponents).
nonExplosiveEpaPerPlay_def_rush	Float64	EPA per play with explosive plays excluded on rush plays, with the team on defense (i.e. allowed to opponents).
line_yards_def_rush	Float64	Average 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_rush	Float64	Opportunity rate -- the share of rushes carrying the opportunity flag on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rush	Float64	Plays run per game on rush plays, with the team on defense (i.e. allowed to opponents).
EPAdrive_def_rush	Float64	EPA per drive (total EPA divided by drives) on rush plays, with the team on defense (i.e. allowed to opponents).
EPAgame_def_rush	Float64	EPA per game (total EPA divided by games) on rush plays, with the team on defense (i.e. allowed to opponents).
yardsgame_def_rush	Float64	Yards gained per game on rush plays, with the team on defense (i.e. allowed to opponents).
drives_def_rush	UInt32	Offensive drives on rush plays, with the team on defense (i.e. allowed to opponents).
drivesgame_def_rush	Float64	Drives per game on rush plays, with the team on defense (i.e. allowed to opponents).
yardsdrive_def_rush	Float64	Yards gained per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsdrive_def_rush	Float64	Plays run per drive on rush plays, with the team on defense (i.e. allowed to opponents).
playsgame_def_rush_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rank	Float64	National 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_rush	Float64	Margin in total EPA summed over every play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAplay_margin_rush	Float64	Margin in EPA per play on rush plays: the team's offensive value minus the value it allowed on defense.
EPAdrive_margin_rush	Float64	Margin 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_rush	Float64	Margin 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_rush	Float64	Margin 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_rush	Float64	Margin in yards gained per play on rush plays: the team's offensive value minus the value it allowed on defense.
TEPA_margin_rush_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_rank	Float64	Margin 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_class	String	Power/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_games	UInt32	Number 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_epa	Float64	Offensive 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_epa	Float64	Defensive 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_faced	Float64	Average 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_faced	Float64	Average 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_epa	Float64	Net opponent-adjusted EPA per play: adj_off_epa minus adj_def_epa. Higher is better.
adj_off_epa_rank	Float64	National rank of the team's adj_off_epa, where 1 is best.
adj_def_epa_rank	Float64	National rank of the team's adj_def_epa, where 1 is best (fewest EPA allowed).
net_adj_epa_rank	Float64	National rank of the team's net_adj_epa, 1 = largest net adjusted EPA.
through_week	Int32	Regular-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_name	type	description
year	Int32	Four-digit season year (e.g. 2019).
week	Int32	Game week of the season.
id_play	Float64	Unique CFBD play identifier (concatenates game_id and play index).
game_id	Int32	ESPN game identifier.
game_play_number	Float64	Sequential play number within the game (excludes timeouts/end markers).
half_play_number	Float64	Sequential play number within the current half.
drive_play_number	Float64	Sequential play number within the current drive.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_team	String	Team name on defense at the start of the play.
pos_team_score	Int32	Score for the team in possession at the start of the play.
def_pos_team_score	Int32	Score for the defensive team at the start of the play.
half	Float64	Half indicator (1 or 2).
period	Int32	Period (quarter) number.
clock_minutes	Int32	Minutes remaining on the period clock at the start of the play.
clock_seconds	Int32	Game clock value in seconds at the play.
play_type	String	CFBD play type label (e.g. "Rush", "Pass Reception", "Field Goal Good").
play_text	String	Free-form text description of the play from the CFBD feed.
down	Float64	Down of the play (1-4).
distance	Float64	Yards to gain for a first down (or to the goal line in goal-to-go situations).
yards_to_goal	Float64	Distance in yards from the offense's spot to the opponent's goal line (0-100).
yards_gained	Float64	Net yards gained by the offense on the play.
EPA	Float64	Expected Points Added on the play (cfbfastR EPA model output).
ep_before	Float64	Expected points value before the play (cfbfastR EPA model).
ep_after	Float64	Expected points value after the play (cfbfastR EPA model).
wpa	Float64	Win Probability Added on the play (cfbfastR WP model output).
wp_before	Float64	Win probability for the possession team before the play (0-1).
wp_after	Float64	Win probability for the possession team after the play (0-1).
def_wp_before	Float64	Win probability for the defensive team before the play (0-1).
def_wp_after	Float64	Win probability for the defensive team after the play (0-1).
penalty_detail	String	Parsed penalty description extracted from play text.
yds_penalty	Float64	Yardage assessed on the penalty.
penalty_1st_conv	Boolean	TRUE when the penalty resulted in a first down conversion.
new_series	Float64	Binary flag for the start of a new series of downs.
firstD_by_kickoff	Float64	Binary flag for a new first down arising from a kickoff.
firstD_by_poss	Float64	Binary flag for a new first down via change of possession.
firstD_by_penalty	Float64	Binary flag for a new first down via penalty.
firstD_by_yards	Float64	Binary flag for a new first down via yards gained.
def_EPA	Float64	EPA for the defensive team on the play (sign-flipped offense EPA).
home_EPA	Float64	EPA for the home team on the play.
away_EPA	Float64	EPA for the away team on the play.
home_EPA_rush	Float64	Rushing EPA for the home team on the play.
away_EPA_rush	Float64	Rushing EPA for the away team on the play.
home_EPA_pass	Float64	Passing EPA for the home team on the play.
away_EPA_pass	Float64	Passing EPA for the away team on the play.
total_home_EPA	Float64	Cumulative total EPA for the home team through the play.
total_away_EPA	Float64	Cumulative total EPA for the away team through the play.
total_home_EPA_rush	Float64	Cumulative rushing EPA for the home team through the play.
total_away_EPA_rush	Float64	Cumulative rushing EPA for the away team through the play.
total_home_EPA_pass	Float64	Cumulative passing EPA for the home team through the play.
total_away_EPA_pass	Float64	Cumulative passing EPA for the away team through the play.
net_home_EPA	Float64	Net EPA differential (home minus away) through the play.
net_away_EPA	Float64	Net EPA differential (away minus home) through the play.
net_home_EPA_rush	Float64	Net rushing EPA differential for the home team through the play.
net_away_EPA_rush	Float64	Net rushing EPA differential for the away team through the play.
net_home_EPA_pass	Float64	Net passing EPA differential for the home team through the play.
net_away_EPA_pass	Float64	Net passing EPA differential for the away team through the play.
success	Float64	Binary success-rate flag using the 50/70/100 percent down-state thresholds.
epa_success	Float64	Binary flag for plays with positive EPA (EPA > 0).
rz_play	Float64	Binary flag for a red-zone play (yards_to_goal <= 20).
scoring_opp	Float64	Binary flag for a scoring opportunity (yards_to_goal <= 40).
middle_8	Boolean	TRUE for plays in the middle-8 window (final 4 min of 1H, first 4 min of 2H).
stuffed_run	Float64	Binary flag for a stuffed run (zero or negative yards gained).
change_of_pos_team	Float64	Binary flag for change of possession-team on the play.
downs_turnover	Float64	Binary flag for a turnover on downs.
turnover	Float64	Binary flag for any turnover on the play.
pos_score_diff_start	Float64	Score differential for the possession team at the start of the play.
pos_score_pts	Float64	Points scored on the play attributed to the possession team.
log_ydstogo	Float64	Natural log of distance-to-go (model feature).
ExpScoreDiff	Float64	Expected score differential at the start of the play (EPA-adjusted).
ExpScoreDiff_Time_Ratio	Float64	Expected score differential scaled by share of time remaining.
half_clock_minutes	Float64	Minutes remaining in the half (15 + clock_minutes when in Q1/Q3).
TimeSecsRem	Float64	Seconds remaining in the half at the start of the play.
adj_TimeSecsRem	Float64	Adjusted seconds remaining used by the EPA/WP models.
Goal_To_Go	Boolean	TRUE when the offense is in a goal-to-go situation.
Under_two	Boolean	TRUE when under two minutes remain in the half.
home	String	Home team name.
away	String	Away team name.
home_wp_before	Float64	Home team win probability before the play (0-1).
away_wp_before	Float64	Away team win probability before the play (0-1).
home_wp_after	Float64	Home team win probability after the play (0-1).
away_wp_after	Float64	Away team win probability after the play (0-1).
end_of_half	Float64	Binary flag for the last play of a half.
pos_team_receives_2H_kickoff	Float64	Binary flag indicating possession team receives the second-half kickoff.
lead_pos_team	String	Possession team on the next play (lead value).
lead_play_type	String	Play type on the next play (lead value).
lag_pos_team	String	Possession team on the previous play (lag value).
lag_play_type	String	Play type on the previous play (lag value).
orig_play_type	String	Original CFBD play type label before cfbfastR cleaning.
Under_three	Boolean	TRUE when under three minutes remain in the half.
row	Int32	Row index within the game grouping (sequencing helper).
drive_event_number	Float64	Sequential event number within the current drive.
play_number	Int32	Sequential play number within the game (1-indexed).
wallclock	String	Real-world ISO timestamp of the play.
provider	String	Sportsbook provider used for spread/over_under joined onto the play.
spread	Float64	Pre-game point spread from the selected provider.
formatted_spread	String	Human-readable formatted spread string from the betting provider.
over_under	Float64	Pre-game over/under total from the selected provider.
drive_is_home_offense	Boolean	TRUE when the home team is on offense for the drive.
drive_start_offense_score	Int32	Offense score at the start of the drive.
drive_start_defense_score	Int32	Defense score at the start of the drive.
drive_end_offense_score	Int32	Offense score at the end of the drive.
drive_end_defense_score	Int32	Defense score at the end of the drive.
play	Float64	Binary flag indicating the row is a counted play (excludes end markers/timeouts/penalties).
event	Float64	Binary flag indicating the row is a counted game event (excludes end markers).
game_event_number	Float64	Sequential event number within the game.
game_row_number	Int32	Row index within the game grouping.
half_play	Float64	Binary flag indicating a counted play within the half.
half_event	Float64	Binary flag indicating a counted event within the half.
half_event_number	Float64	Sequential event number within the half.
half_row_number	Int32	Row index within the half grouping.
pos_unit	String	Possession-team unit label (offense or special teams).
def_pos_unit	String	Defensive possession-team unit label (defense or special teams).
drive_play	Float64	Binary flag indicating a counted play within the drive.
drive_event	Float64	Binary flag indicating a counted event within the drive.
venue_id	Int32	Referencing venue id.
venue	String	Venue name.
neutral_site	Boolean	TRUE/FALSE flag for if the game took place at a neutral site.
conference_game	Boolean	TRUE/FALSE flag for this game qualifying as a conference game.
season_type	String	ESPN season type (2 = regular, 3 = postseason).
start_date	String	Season start timestamp (ISO 8601, UTC).
completed	Boolean	TRUE if the game is complete.
home_team_id	Int32	ESPN home team id (parsed from home_team_ref).
home_team	String	Home team name.
home_team_division	String	Home team NCAA division (1, 2, 3).
home_team_conference	String	Conference name of the home team.
home_team_pregame_elo	Int32	Home team's pregame Elo rating, carried on the cfbfastR-shaped schema.
away_team_id	Int32	ESPN away team id (parsed from away_team_ref).
away_team	String	Away team name.
away_team_division	String	Away team NCAA division (1, 2, 3).
away_team_conference	String	Conference name of the away team.
away_team_pregame_elo	Int32	Away team's pregame Elo rating, carried on the cfbfastR-shaped schema.
season	Int32	Season (4-digit year).
team	String	Team name.
conference	String	Conference of the team.
opponent	String	Opponent team name.
team_score	Int32	Offense team score at the time of the play.
opponent_score	Int32	Defense / opponent team score at the time of the play.
down_end	Float64	Down number at the end of the play (post-play state).
distance_end	Float64	Distance-to-go at the end of the play (post-play state).
log_ydstogo_end	Float64	Natural log of post-play distance-to-go (model feature).
yards_to_goal_end	Float64	Yards to opponent end zone at the end of the play.
TimeSecsRem_end	Float64	Seconds remaining in the half at the end of the play.
Goal_To_Go_end	Boolean	TRUE when the post-play state is goal-to-go.
Under_two_end	Boolean	TRUE when the post-play state is under two minutes.
offense_score_play	Float64	Binary flag for an offensive scoring play.
defense_score_play	Float64	Binary flag for a defensive scoring play.
ppa	Float64	Predicted Points Added from the CFBD ppa endpoint (CFB-EPA analogue).
yard_line	Int32	Field-position yard line at the start of the play (0-50 scale from the offense's side).
scoring	Boolean	TRUE when the play results in a score (TD, FG, safety, two-point conversion).
pos_team_timeouts_rem_before	Float64	Possession team timeouts remaining before the play.
def_pos_team_timeouts_rem_before	Float64	Defensive team timeouts remaining before the play.
pos_team_timeouts	Float64	Possession team timeouts remaining after the play.
def_pos_team_timeouts	Float64	Defensive team timeouts remaining after the play.
pos_score_diff	Int32	Score differential from the possession team's perspective.
pos_score_diff_start_end	Float64	Score differential aggregated from start to end of the play.
offense_play	String	Offensive team name as labeled by CFBD on the play.
defense_play	String	Defensive team name as labeled by CFBD on the play.
offense_receives_2H_kickoff	Float64	Binary flag indicating offense receives the second-half kickoff.
change_of_poss	Float64	Binary flag for change of possession on the play (CFBD offense field).
score_pts	Float64	Points scored on the play.
score_diff_start	Float64	Score differential at the start of the play.
score_diff	Int32	Score differential (offense_score - defense_score) at the start.
offense_score	Int32	Offense team score at the start of the play.
defense_score	Int32	Defense team score at the start of the play.
offense_conference	String	Conference name of the offense (e.g. "SEC", "ACC").
defense_conference	String	Conference name of the defense (e.g. "SEC", "ACC").
off_timeout_called	Float64	Binary flag for an offensive timeout called during the play.
def_timeout_called	Float64	Binary flag for a defensive timeout called during the play.
offense_timeouts	Float64	Timeouts remaining for the offense at the end of the play.
defense_timeouts	Float64	Timeouts remaining for the defense at the end of the play.
off_timeouts_rem_before	Float64	Offense timeouts remaining before the play.
def_timeouts_rem_before	Float64	Defense timeouts remaining before the play.
rusher_player_name	String	Name of the rusher on a rushing play.
yds_rushed	Float64	Rushing yards gained on the play.
passer_player_name	String	Name of the passer on a passing play.
receiver_player_name	String	Name of the receiver on a passing play.
yds_receiving	Float64	Receiving yards gained on the play.
yds_sacked	Float64	Yards lost on the sack.
sack_players	String	Combined names of all sack participants.
sack_player_name	String	Primary sack player name.
sack_player_name2	String	Secondary sack player name (when split between two defenders).
pass_breakup_player_name	String	Name of the defender credited with the pass breakup.
interception_player_name	String	Name of the defender credited with the interception.
yds_int_return	Float64	Yards gained on an interception return.
fumble_player_name	String	Name of the player who fumbled.
fumble_forced_player_name	String	Name of the player who forced the fumble.
fumble_recovered_player_name	String	Name of the player who recovered the fumble.
yds_fumble_return	Float64	Yards gained on a fumble return.
punter_player_name	String	Name of the punter.
yds_punted	Float64	Yards the ball traveled on the punt.
punt_returner_player_name	String	Name of the punt returner.
yds_punt_return	Float64	Yards gained on the punt return.
yds_punt_gained	Float64	Net yards gained on the punt (punt distance minus return).
punt_block_player_name	String	Name of the player credited with blocking the punt.
punt_block_return_player_name	String	Name of the player returning a blocked punt.
fg_kicker_player_name	String	Name of the field goal kicker.
yds_fg	Float64	Distance of the field goal attempt in yards.
fg_block_player_name	String	Name of the player credited with blocking the field goal.
fg_return_player_name	String	Name of the player returning the blocked/missed field goal.
kickoff_player_name	String	Name of the kickoff specialist.
yds_kickoff	Float64	Yards the ball traveled on the kickoff.
kickoff_returner_player_name	String	Name of the kickoff returner.
yds_kickoff_return	Float64	Yards gained on the kickoff return.
new_id	Float64	Numeric play index within the game (id_play with game_id stripped).
orig_drive_number	Int32	Original CFBD drive number for the play.
drive_number	Int32	Sequential drive number within the game (1-indexed).
drive_result_detailed	String	Detailed drive result label (e.g. "Punt", "Passing Touchdown", "Downs Turnover").
new_drive_pts	Float64	Points scored on the drive (signed for offense/defense).
drive_id	Float64	CFBD drive identifier the play belongs to.
drive_result	String	Drive result code (drive_-prefixed; every drive-level column is carried with this prefix).
drive_start_yards_to_goal	Float64	Yards to opponent's end zone at drive start (0-100).
drive_end_yards_to_goal	Int32	Yards to opponent's end zone at drive end (0-100).
drive_yards	Int32	Net yards gained on the drive.
drive_scoring	Float64	Binary flag for a scoring drive.
drive_pts	Float64	Points scored on the drive (CFBD/cfbfastR reconciled value).
drive_start_period	Int32	Period (quarter) at the start of the drive.
drive_end_period	Int32	Period (quarter) at the end of the drive.
drive_time_minutes_start	Int32	Minutes on the clock at the start of the drive.
drive_time_seconds_start	Int32	Seconds on the clock at the start of the drive.
drive_time_minutes_end	Int32	Minutes on the clock at the end of the drive.
drive_time_seconds_end	Int32	Seconds on the clock at the end of the drive.
drive_time_minutes_elapsed	Int32	Minutes elapsed during the drive.
drive_time_seconds_elapsed	Int32	Seconds elapsed during the drive.
drive_numbers	Float64	Binary flag marking the first play of a new drive.
number_of_drives	Float64	Cumulative count of drives in the game.
pts_scored	Float64	Points scored on the play, signed by play_type rule.
drive_result_detailed_flag	String	Pre-fill copy of drive_result_detailed used during drive reconciliation.
drive_result2	String	Short-form drive result label (e.g. "TD", "PUNT", "DOWNS").
drive_num	Float64	Game-scoped drive sequence number.
lag_drive_result_detailed	String	Drive result detailed on the previous play (lag value).
lead_drive_result_detailed	String	Drive result detailed on the next play (lead value).
lag_new_drive_pts	Float64	Drive points on the previous play (lag value).
id_drive	Float64	Composite drive identifier (game_id concatenated with drive_num).
rush	Float64	Binary flag for a rushing play.
rush_td	Float64	Binary flag for a rushing touchdown.
pass	Float64	Binary flag for a passing play (includes sacks).
pass_td	Float64	Binary flag for a passing touchdown.
completion	Float64	Binary flag for a completed pass.
pass_attempt	Float64	Binary flag for a pass attempt.
target	Float64	Binary flag for a targeted receiver on the play.
sack_vec	Float64	Binary flag for a sack play.
sack	Float64	Binary flag for a sack (duplicate of sack_vec for downstream use).
int	Float64	Binary flag for an interception.
int_td	Float64	Binary flag for an interception returned for a touchdown.
turnover_vec	Float64	Binary flag for any play classified as a turnover.
turnover_vec_lag	Float64	Lag of turnover_vec (previous-play turnover flag).
turnover_indicator	Float64	Composite turnover indicator including failed 4th downs.
kickoff_play	Float64	Binary flag for a kickoff play.
receives_2H_kickoff	Float64	Binary flag for the team receiving the second-half kickoff.
missing_yard_flag	Boolean	TRUE when post-play yardage had to be imputed.
scoring_play	Float64	TRUE if the play resulted in a score.
td_play	Float64	Binary flag for a touchdown play.
touchdown	Float64	Binary flag for a touchdown (duplicate of td_play for downstream use).
safety	Float64	Binary flag for a safety.
fumble_vec	Float64	Binary flag for a play involving a fumble.
kickoff_tb	Float64	Binary flag for a kickoff touchback.
kickoff_onside	Float64	Binary flag for an onside kickoff attempt.
kickoff_oob	Float64	Binary flag for a kickoff out of bounds.
kickoff_fair_catch	Float64	Binary flag for a kickoff fair catch.
kickoff_downed	Float64	Binary flag for a kickoff downed in the field of play.
kickoff_safety	Float64	Binary flag for a kickoff safety.
kick_play	Float64	Binary flag for any kicking play (kickoff or field goal).
punt	Float64	Binary flag for a punt play.
punt_play	Float64	Binary flag for any punt-related play (includes blocks/returns).
punt_tb	Float64	Binary flag for a punt touchback.
punt_oob	Float64	Binary flag for a punt out of bounds.
punt_fair_catch	Float64	Binary flag for a punt fair catch.
punt_downed	Float64	Binary flag for a punt downed in the field of play.
punt_safety	Float64	Binary flag for a punt safety.
punt_blocked	Float64	Binary flag for a blocked punt.
penalty_safety	Float64	Binary flag for a safety scored on a penalty.
fg_inds	Float64	Binary flag for a field goal attempt.
fg_made	Boolean	TRUE when the field goal attempt was successful.
fg_make_prob	Float64	Predicted probability of making the field goal (cfbfastR FG model, 0-1).
No_Score_before	Float64	Pre-play predicted probability of no score before end of half (cfbfastR EP model, 0-1).
FG_before	Float64	Pre-play predicted probability of a posteam field goal next (0-1).
Opp_FG_before	Float64	Pre-play predicted probability of a defteam field goal next (0-1).
Opp_Safety_before	Float64	Pre-play predicted probability of a defteam safety next (0-1).
Opp_TD_before	Float64	Pre-play predicted probability of a defteam touchdown next (0-1).
Safety_before	Float64	Pre-play predicted probability of a posteam safety next (0-1).
TD_before	Float64	Pre-play predicted probability of a posteam touchdown next (0-1).
No_Score_after	Float64	Post-play predicted probability of no score before end of half (0-1).
FG_after	Float64	Post-play predicted probability of a posteam field goal next (0-1).
Opp_FG_after	Float64	Post-play predicted probability of a defteam field goal next (0-1).
Opp_Safety_after	Float64	Post-play predicted probability of a defteam safety next (0-1).
Opp_TD_after	Float64	Post-play predicted probability of a defteam touchdown next (0-1).
Safety_after	Float64	Post-play predicted probability of a posteam safety next (0-1).
TD_after	Float64	Post-play predicted probability of a posteam touchdown next (0-1).
position_reception	String	Position of the player credited with the reception on the play (cfbfastR-shaped player-position column).
position_target	String	Position of the receiver targeted on the play (cfbfastR-shaped player-position column).
position_completion	String	Position of the passer credited with the completion (cfbfastR-shaped player-position column).
position_incompletion	String	Position of the passer charged with the incompletion (cfbfastR-shaped player-position column).
position_sack_taken	String	Position of the quarterback who took the sack (cfbfastR-shaped player-position column).
position_sack	String	Position of the defender credited with the sack (cfbfastR-shaped player-position column).
position_interception_thrown	String	Position of the passer who threw the interception (cfbfastR-shaped player-position column).
position_interception	String	Position of the defender who made the interception (cfbfastR-shaped player-position column).
position_fumble	String	Position of the player who fumbled (cfbfastR-shaped player-position column).
position_fumble_forced	String	Position of the defender who forced the fumble (cfbfastR-shaped player-position column).
position_fumble_recovered	String	Position of the player who recovered the fumble (cfbfastR-shaped player-position column).
position_pass_breakup	String	Position of the defender credited with the pass breakup (cfbfastR-shaped player-position column).
position_rush	String	Position of the player credited with the rush on the play (cfbfastR-shaped player-position column).
position_touchdown	String	Position of the player who scored the touchdown (cfbfastR-shaped player-position column).
rush_player_id	Float64	CFBD athlete_id of the player credited with a rush attempt.
rush_player	String	Name of the player credited with a rush attempt.
rush_yds	Int32	Rushing yards gained on the play.
reception_player_id	Float64	CFBD athlete_id of the receiver credited with a reception.
reception_player	String	Name of the receiver credited with a reception.
reception_yds	Int32	Reception yards gained on the play.
completion_player_id	Float64	CFBD athlete_id of the passer credited with a completion.
completion_player	String	Name of the passer credited with a completion.
completion_yds	Int32	Passing yards gained on the completion.
interception_player_id	Float64	CFBD athlete_id of the defender credited with an interception.
interception_player	String	Name of the defender credited with an interception.
interception_stat	Int32	Interception stat value reported by CFBD (typically 1 per INT).
interception_thrown_player_id	Float64	CFBD athlete_id of the passer charged with the interception.
interception_thrown_player	String	Name of the passer charged with the interception.
interception_thrown_stat	Int32	Interception-thrown stat value reported by CFBD (typically 1 per INT thrown).
touchdown_player_id	Float64	CFBD athlete_id of the player credited with the touchdown.
touchdown_player	String	Name of the player credited with the touchdown.
touchdown_stat	Int32	Touchdown stat value reported by CFBD (typically 1 per TD scored).
incompletion_player_id	Float64	CFBD athlete_id of the targeted receiver on an incompletion.
incompletion_player	String	Name of the targeted receiver on an incompletion.
incompletion_stat	Int32	Incompletion stat value reported by CFBD (typically 1 per incompletion).
target_player_id	Float64	CFBD athlete_id of the targeted receiver on a pass.
target_player	String	Name of the targeted receiver on a pass.
target_stat	Int32	Target stat value reported by CFBD (typically 1 per target).
fumble_recovered_player_id	Float64	CFBD athlete_id of the player recovering the fumble.
fumble_recovered_player	String	Name of the player recovering the fumble.
fumble_recovered_stat	Int32	Fumble-recovered stat value reported by CFBD (typically 1 per recovery).
fumble_forced_player_id	Float64	CFBD athlete_id of the defender credited with forcing the fumble.
fumble_forced_player	String	Name of the defender credited with forcing the fumble.
fumble_forced_stat	Int32	Fumble-forced stat value reported by CFBD (typically 1 per forced fumble).
fumble_player_id	Float64	CFBD athlete_id of the player who fumbled.
fumble_player	String	Name of the player who fumbled.
fumble_stat	Int32	Fumble stat value reported by CFBD (typically 1 per fumble).
sack_player_id	Float64	Comma-separated CFBD athlete_id(s) of the sacking defender(s).
sack_player	String	Comma-separated name(s) of the sacking defender(s).
sack_stat	Int32	Sack stat value reported by CFBD (sack credit can be split between defenders).
sack_taken_player_id	Float64	CFBD athlete_id of the QB charged with taking the sack.
sack_taken_player	String	Name of the QB charged with taking the sack.
sack_taken_stat	Int32	Sack-taken stat value reported by CFBD (typically 1 per sack taken).
pass_breakup_player_id	Float64	CFBD athlete_id of the defender credited with the pass breakup (PBU).
pass_breakup_player	String	Name of the defender credited with the pass breakup (PBU).
pass_breakup_stat	Int32	Pass breakup (PBU) stat value reported by CFBD (typically 1 per PBU).
field_goal_attempt_player_id	String	CFBD athlete_id of the kicker attempting the field goal.
field_goal_attempt_player	String	Name of the kicker attempting the field goal.
field_goal_attempt_stat	Int32	Field goal attempt distance in yards reported by CFBD.
field_goal_made_player_id	String	CFBD athlete_id of the kicker on a made field goal.
field_goal_made_player	String	Name of the kicker on a made field goal.
field_goal_made_stat	Int32	Made-field-goal distance in yards reported by CFBD.
field_goal_missed_player_id	String	CFBD athlete_id of the kicker on a missed field goal.
field_goal_missed_player	String	Name of the kicker on a missed field goal.
field_goal_missed_stat	Int32	Missed-field-goal distance in yards reported by CFBD.
field_goal_blocked_player_id	String	CFBD athlete_id of the defender credited with blocking the field goal.
field_goal_blocked_player	String	Name of the defender credited with blocking the field goal.
field_goal_blocked_stat	Int32	Blocked-field-goal distance in yards reported by CFBD.
penalty_flag	Boolean	TRUE when a penalty was flagged on the play.
penalty_declined	Boolean	TRUE when the penalty was declined.
penalty_no_play	Boolean	TRUE when the penalty nullified the play (no play counted).
penalty_offset	Boolean	TRUE when offsetting penalties were called.
penalty_text	Boolean	TRUE when penalty information is detectable in the play text.
penalty_play_text	String	Penalty-related substring extracted from the play text.

load_cfb_pbp_r(seasons=2024)

load_ncaa_mfb_pbp

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

Returns

col_name	type	description
contest_id	String	stats.ncaa.org contest (game) identifier.
drive_number	Int64	Sequential drive number within the game (1-indexed).
play_number	Int64	Sequential play number within the game (1-indexed).
offense	String	Full name of the offense (team in possession) on the play.
drive_result	String	Drive result code (drive_-prefixed; every drive-level column is carried with this prefix).
drive_scored	Boolean	Whether the possession containing this play ended in points for the offense.
down	Int64	Down of the play (1-4).
distance	Int64	Yards to gain for a first down (or to the goal line in goal-to-go situations).
yard_line	String	Field-position yard line at the start of the play (0-50 scale from the offense's side).
yard_line_side	String	Which team's territory the ball was on at the snap ('OFF' own side, 'DEF' opponent side); pairs with yard_line_number for absolute field position.
yard_line_number	Int64	Yard line at the snap (0-50); pairs with yard_line_side for absolute field position.
play_type	String	CFBD play type label (e.g. "Rush", "Pass Reception", "Field Goal Good").
clock	String	Game clock display value at the play (MM:SS).
yards_gained	Int64	Net yards gained by the offense on the play.
formation	String	Offensive formation or personnel grouping reported for the play (e.g. 'Shotgun', 'I-Formation'), when the source narrative names it.
passer	String	Name of the dropback player (scrambles included) including plays with penalties.
rusher	String	Name of the rusher (no scrambles) including plays with penalties.
receiver	String	Name of the receiver including plays with penalties.
kicker	String	Name of the player who kicked off, punted, or attempted the field goal/PAT on this play.
punter	String	Name of the player who punted on this play.
returner	String	Name of the player who fielded or returned the kickoff or punt on this play.
run_direction	String	Hole or side the ball carrier ran through on a rush play (e.g. 'left end', 'right guard'), when the narrative reports it.
qb_scramble	Boolean	Binary indicator for whether or not the QB scrambled.
pass_complete	Boolean	Whether a pass attempt on this play was completed.
pass_depth	String	Depth classification of a pass attempt (e.g. 'short', 'deep'), when the narrative reports it.
pass_direction	String	Side of the field the pass was thrown to (e.g. 'left', 'middle', 'right'), when the narrative reports it.
tackler_1	String	Name of the primary (first-listed) tackler on the play.
tackler_2	String	Name of the secondary (assisting) tackler on the play, when the narrative credits an assist.
kick_yards	Int64	Yards traveled on a kickoff.
return_yards	Int64	Yards gained by the return team. Returns may occur on any of: interception, fumble, kickoff, punt, or blocked kicks.
punt_yards	Int64	Gross yards traveled on a punt, before any return.
fg_distance	Int64	Distance in yards of a field goal attempt.
fg_made	Boolean	TRUE when the field goal attempt was successful.
is_first_down	Boolean	Whether the play resulted in a first down for the offense.
is_touchdown	Boolean	Whether the play resulted in a touchdown.
is_safety	Boolean	Whether the play resulted in a safety.
is_fumble	Boolean	Whether a fumble occurred on the play, regardless of which team recovered it.
is_turnover	Boolean	TRUE if the play was a turnover.
turnover_type	String	Kind of turnover on the play, if any (e.g. 'interception', 'fumble lost'); null when no turnover occurred.
out_of_bounds	Boolean	1 if play description contains ran ob, pushed ob, or sacked ob; 0 otherwise.
no_play	Boolean	Whether the play was negated (e.g. by a penalty on the preceding down) and is excluded from drive/stat totals.
fair_catch	Boolean	Whether the returner called a fair catch on a kickoff or punt.
penalty_flag	Boolean	TRUE when a penalty was flagged on the play.
penalty_team	String	String abbreviation of the team with the penalty.
penalty_type	String	String indicating the penalty type of the first penalty in the given play. Will be NA if desc is missing the type.
penalty_player	String	Name of the player penalized on the play, when a penalty occurred.
penalty_yards	Int64	Yards gained (or lost) by the posteam from the penalty.
end_yard_line	String	Yard line at the end of the play.
play_text	String	Free-form text description of the play from the CFBD feed.
espn_game_id	String	ESPN game id (NA for bart-only rows).
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_pbp(seasons=2024)

load_ncaa_mfb_pbp_cfbfastr

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

Returns

col_name	type	description
game_id	Int64	ESPN game identifier.
id_play	Int64	Unique CFBD play identifier (concatenates game_id and play index).
drive_id	Int64	CFBD drive identifier the play belongs to.
game_play_number	Int64	Sequential play number within the game (excludes timeouts/end markers).
half_play_number	Int64	Sequential play number within the current half.
drive_play_number	Int64	Sequential play number within the current drive.
drive_number	Int64	Sequential drive number within the game (1-indexed).
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
year	Int64	Four-digit season year (e.g. 2019).
week	Int64	Game week of the season.
period	Int64	Period (quarter) number.
half	Int64	Half indicator (1 or 2).
clock.minutes	Int64	Minutes remaining on the game clock at the start of the play (cfbfastR schema column).
clock.seconds	Int64	Seconds remaining within the current minute on the game clock at the start of the play (cfbfastR schema column).
TimeSecsRem	Int64	Seconds remaining in the half at the start of the play.
Under_two	Boolean	TRUE when under two minutes remain in the half.
pos_team	String	Team name in possession at the start of the play (offense, kickoff-aware).
def_pos_team	String	Team name on defense at the start of the play.
offense_play	String	Offensive team name as labeled by CFBD on the play.
defense_play	String	Defensive team name as labeled by CFBD on the play.
home	String	Home team name.
away	String	Away team name.
pos_team_score	Int64	Score for the team in possession at the start of the play.
def_pos_team_score	Int64	Score for the defensive team at the start of the play.
offense_score	Int64	Offense team score at the start of the play.
defense_score	Int64	Defense team score at the start of the play.
pos_score_diff	Int64	Score differential from the possession team's perspective.
score_pts	Int64	Points scored on the play.
scoring_play	Boolean	TRUE if the play resulted in a score.
scoring	Boolean	TRUE when the play results in a score (TD, FG, safety, two-point conversion).
down	Int64	Down of the play (1-4).
distance	Int64	Yards to gain for a first down (or to the goal line in goal-to-go situations).
yard_line	String	Field-position yard line at the start of the play (0-50 scale from the offense's side).
yards_to_goal	Int64	Distance in yards from the offense's spot to the opponent's goal line (0-100).
yards_to_goal_end	Int64	Yards to opponent end zone at the end of the play.
Goal_To_Go	Boolean	TRUE when the offense is in a goal-to-go situation.
log_ydstogo	Float64	Natural log of distance-to-go (model feature).
yards_gained	Int64	Net yards gained by the offense on the play.
play_type	String	CFBD play type label (e.g. "Rush", "Pass Reception", "Field Goal Good").
orig_play_type	String	Original CFBD play type label before cfbfastR cleaning.
play_text	String	Free-form text description of the play from the CFBD feed.
rush	Boolean	Binary flag for a rushing play.
rush_td	Boolean	Binary flag for a rushing touchdown.
pass	Boolean	Binary flag for a passing play (includes sacks).
pass_td	Boolean	Binary flag for a passing touchdown.
pass_attempt	Boolean	Binary flag for a pass attempt.
completion	Boolean	Binary flag for a completed pass.
target	Boolean	Binary flag for a targeted receiver on the play.
sack	Boolean	Binary flag for a sack (duplicate of sack_vec for downstream use).
sack_vec	Boolean	Binary flag for a sack play.
int	Boolean	Binary flag for an interception.
int_td	Boolean	Binary flag for an interception returned for a touchdown.
turnover_vec	Boolean	Binary flag for any play classified as a turnover.
downs_turnover	Boolean	Binary flag for a turnover on downs.
touchdown	Boolean	Binary flag for a touchdown (duplicate of td_play for downstream use).
td_play	Boolean	Binary flag for a touchdown play.
safety	Boolean	Binary flag for a safety.
fumble_vec	Boolean	Binary flag for a play involving a fumble.
punt	Boolean	Binary flag for a punt play.
punt_play	Boolean	Binary flag for any punt-related play (includes blocks/returns).
kickoff_play	Boolean	Binary flag for a kickoff play.
kick_play	Boolean	Binary flag for any kicking play (kickoff or field goal).
fg_inds	Boolean	Binary flag for a field goal attempt.
fg_made	Boolean	TRUE when the field goal attempt was successful.
punt_blocked	Boolean	Binary flag for a blocked punt.
punt_fair_catch	Boolean	Binary flag for a punt fair catch.
firstD_by_yards	Boolean	Binary flag for a new first down via yards gained.
firstD_by_penalty	Boolean	Binary flag for a new first down via penalty.
penalty_flag	Boolean	TRUE when a penalty was flagged on the play.
penalty_no_play	Boolean	TRUE when the penalty nullified the play (no play counted).
penalty_declined	Boolean	TRUE when the penalty was declined.
penalty_offset	Boolean	TRUE when offsetting penalties were called.
penalty_text	String	TRUE when penalty information is detectable in the play text.
yds_penalty	Int64	Yardage assessed on the penalty.
rusher_player_name	String	Name of the rusher on a rushing play.
passer_player_name	String	Name of the passer on a passing play.
receiver_player_name	String	Name of the receiver on a passing play.
interception_player_name	String	Name of the defender credited with the interception.
punter_player_name	String	Name of the punter.
punt_returner_player_name	String	Name of the punt returner.
fg_kicker_player_name	String	Name of the field goal kicker.
kickoff_player_name	String	Name of the kickoff specialist.
kickoff_returner_player_name	String	Name of the kickoff returner.
yds_rushed	Int64	Rushing yards gained on the play.
yds_receiving	Int64	Receiving yards gained on the play.
yds_sacked	Int64	Yards lost on the sack.
yds_punted	Int64	Yards the ball traveled on the punt.
yds_punt_return	Int64	Yards gained on the punt return.
yds_kickoff	Int64	Yards the ball traveled on the kickoff.
yds_kickoff_return	Int64	Yards gained on the kickoff return.
yds_int_return	Int64	Yards gained on an interception return.
yds_fg	Int64	Distance of the field goal attempt in yards.
drive_result	String	Drive result code (drive_-prefixed; every drive-level column is carried with this prefix).
drive_scoring	Boolean	Binary flag for a scoring drive.
ot_synthesized	Boolean	Whether this row's overtime clock/period fields were synthesized rather than sourced directly -- stats.ncaa.org reports no running clock in overtime, so OT plays are assigned a synthetic countdown.
lag_pos_team	String	Possession team on the previous play (lag value).
lead_pos_team	String	Possession team on the next play (lead value).
lag_play_type	String	Play type on the previous play (lag value).
lead_play_type	String	Play type on the next play (lead value).
lag_play_text	String	Play text from the previous play (lag value).
lead_play_text	String	Play text from the next play (lead value).
change_of_pos_team	Boolean	Binary flag for change of possession-team on the play.
play_after_turnover	Boolean	Binary flag indicating the play immediately following a turnover.
n_plays_in_game	UInt32	Total number of plays in the game this row belongs to, repeated on every row for convenience.
espn_game_id	String	ESPN game id (NA for bart-only rows).

load_ncaa_mfb_pbp_cfbfastr(seasons=2024)

load_ncaa_mfb_drives

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

Returns

col_name	type	description
contest_id	String	stats.ncaa.org contest (game) identifier.
drive_number	Int64	Sequential drive number within the game (1-indexed).
quarter	Int64	Quarter in which the drive started (1-4 for regulation, 5+ for overtime periods).
period	Int64	Period (quarter) number.
team	String	Team name.
start_period	Int64	Period (quarter) in which the drive starts.
start_how	String	How the drive began (e.g. 'Kickoff', 'Interception', 'Fumble', 'Downs', 'Punt').
start_clock	String	Game clock display value at the start of the drive.
start_yard_line	String	Yard line at the start of the play.
end_period	Int64	Period (quarter) in which the drive ends.
end_how	String	How the drive ended (e.g. 'Touchdown', 'Punt', 'Interception', 'Fumble', 'End of Half').
end_clock	String	Game clock display value at the end of the drive.
end_yard_line	String	Yard line at the end of the play.
n_plays	Int64	Number of plays run during the drive.
yards	Int64	Total yards gained on the drive.
espn_game_id	String	ESPN game id (NA for bart-only rows).
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_drives(seasons=2024)

load_ncaa_mfb_schedule

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

Returns

col_name	type	description
team_id	String	ESPN team id.
team_name	String	Team nickname; team_detail = TRUE only.
date	String	Date of the poll release.
opponent_id	String	ESPN team id of the opponent.
opponent	String	Opponent team name.
result	String	Drive result code (e.g. PUNT, TD).
outcome	String	Result of the game from the home team's perspective (e.g. 'W', 'L', 'T').
team_score	Int64	Offense team score at the time of the play.
opponent_score	Int64	Defense / opponent team score at the time of the play.
contest_id	String	stats.ncaa.org contest (game) identifier.
attendance	Int64	Reported attendance at the game.
academic_year	Int32	Academic year the game was played in (the ENDING year of the fall/spring split, e.g. 2025 for the 2024 fall season) -- distinct from season, which is the STARTING year.
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_schedule(seasons=2024)

load_ncaa_mfb_rosters

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

Returns

col_name	type	description
team_id	String	ESPN team id.
team_name	String	Team nickname; team_detail = TRUE only.
player_id	String	ESPN player id from the roster entry.
player_name	String	Full name of player
jersey	String	Jersey number.
statcrew_jersey	String	Jersey number as recorded in the NCAA StatCrew roster feed; can differ from the number a player actually wears on a given game day.
player_class	String	Player's academic/eligibility class (e.g. 'FR', 'SO', 'JR', 'SR', 'GR').
position	String	Athlete position.
height	String	Listed height (inches).
weight	Int64	Listed weight (lbs).
hometown	String	Prospect hometown.
high_school	String	High school
games_played	Int64	Games played.
games_started	Int64	Games started (goalies).
academic_year	Int32	Academic year the roster snapshot covers (the ENDING year of the fall/spring split) -- distinct from season, which is the STARTING year.
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_rosters(seasons=2024)

load_ncaa_mfb_teams

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

Returns

col_name	type	description
team_id	String	ESPN team id.
team_name	String	Team nickname; team_detail = TRUE only.
academic_year	Int32	Academic year the team record covers (the ENDING year of the fall/spring split) -- distinct from season, which is the STARTING year.
division	Int32	Division in the conference for the team.
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_teams(seasons=2024)

load_ncaa_mfb_team_stats

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

Returns

col_name	type	description
contest_id	String	stats.ncaa.org contest (game) identifier.
category	String	CFBD stats category name (e.g. passing, rushing, defensive).
stat	String	Stat.
period	String	Period (quarter) number.
away_team	String	Away team name.
away_value	String	Team-stat value for the away team; each row is one stat category for one game, wide by side.
home_team	String	Home team name.
home_value	String	Team-stat value for the home team; each row is one stat category for one game, wide by side.
espn_game_id	String	ESPN game id (NA for bart-only rows).
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_team_stats(seasons=2024)

load_ncaa_mfb_player_stats

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

Returns

col_name	type	description
contest_id	String	stats.ncaa.org contest (game) identifier.
team_id	String	ESPN team id.
number	String	Week number as returned by the API.
name	String	Position name (e.g. Quarterback).
position	String	Athlete position.
rush_attempts	String	The number of rushing attempts
rush_yds_gained	String	Total positive rushing yards gained on carries, before subtracting yards lost to tackles for loss.
rush_yds_lost	String	Total rushing yards lost to tackles for loss on carries.
yds_rush	String	Net rushing yards (rush_yds_gained minus rush_yds_lost).
rush_tds	String	Rushing touchdowns for the game. Populated only on this player-game's 'rushing' category row (null on the 'passing'/'receiving' rows for the same player-game) -- the loader returns one row per player-game-category.
rush_long	String	Longest single rush of the game.
category	String	CFBD stats category name (e.g. passing, rushing, defensive).
espn_game_id	String	ESPN game id (NA for bart-only rows).
pass_attempts	String	Pass attempts for the game. Populated only on this player-game's 'passing' category row (null on the 'rushing'/'receiving' rows for the same player-game) -- the loader returns one row per player-game-category.
completions	String	The number of completed passes.
pass_yards	String	Number of yards gained on pass plays
interceptions	String	Passing interceptions.
pass_tds	String	Passing touchdowns thrown for the game. Populated only on this player-game's 'passing' category row (null on the 'rushing'/'receiving' rows for the same player-game) -- the loader returns one row per player-game-category.
pass_eff	String	Passer efficiency rating for the game, per the NCAA passer-rating formula.
yds_per_completion	String	Passing yards divided by completions.
pct	String	Win percentage.
long_pass	String	Longest completed pass of the game.
rec	String	Total receptions for the game.
receiving_yards	String	Numeric yards by the receiver_player_name, excluding yards gained in pass plays with laterals. This should equal official receiving statistics but could miss yards gained in pass plays with laterals. Please see the description of lateral_receiver_player_name for further information.
yards_per_reception	String	Receiving yards divided by receptions.
rec_td	String	Receiving touchdowns.
long_rec	String	Longest reception of the game.
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_player_stats(seasons=2024)

load_ncaa_mfb_officials

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

Returns

col_name	type	description
contest_id	String	stats.ncaa.org contest (game) identifier.
role	String	Grouped official role (Referee/Linesperson).
official	String	Flag indicating that the media item comes from the official league feed rather than an editorial source.
espn_game_id	String	ESPN game id (NA for bart-only rows).
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_officials(seasons=2024)

load_ncaa_mfb_linescore

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

Returns

col_name	type	description
contest_id	String	stats.ncaa.org contest (game) identifier.
team	String	Team name.
home_away	String	home or away.
period	String	Period (quarter) number.
points	Int64	Total points accumulated by the school in the poll's weighted voting.
final	Int64	Flag for whether the game is final.
game_date	String	Kickoff date-time (ISO 8601, UTC).
venue	String	Venue name.
attendance	Int64	Reported attendance at the game.
espn_game_id	String	ESPN game id (NA for bart-only rows).
season	Int64	Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.

load_ncaa_mfb_linescore(seasons=2024)