Skip to contents

Loads season-level rushing EPA splits – one row per team (offense and defense views) with rush EPA, success, line yards, and stuff-rate aggregates. Published to the espn_cfb_rushing release tag on the sportsdataverse-data repo.

Usage

load_espn_cfb_rushing(
  seasons = most_recent_cfb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given college football seasons. Published coverage runs 2004 through the most recent season. Pass seasons = TRUE for every published season. (Min: 2004)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the data table within the database

Value

Returns a cfbfastR_data tibble.

col_nametypesdescription
team_idinteger
pos_teamcharacter
divisioncharacter
conferencecharacter
seasoninteger
player_idinteger
rusher_player_namecharacterDisplay name of the ball carrier on a rush – the FIRST participant in that role on the play.
playsinteger
gamesinteger
team_gamesintegerGames the team played, used as the per-game denominator.
TEPAdoubleTotal EPA summed over every play.
EPAplaydoubleEPA generated per play.
yardsinteger
successdoubleSuccess rate across the team plays.
rushing_tddouble
fumblesdoubleCount of the ball carrier's rush attempts across the season whose play text mentions a fumble by either team.
playsgamedoublePlays per game.
EPAgamedoubleEPA generated per game.
yardsplaydoubleYards per play.
yardsgamedoubleYards per game.
TEPA_rankdoubleNational rank of the team's total EPA summed over every play, where 1 is best.
EPAgame_rankdoubleNational rank of the team's EPA generated per game, where 1 is best.
EPAplay_rankdoubleNational rank of the team's EPA generated per play, where 1 is best.
success_rankdoubleNational rank of the team's success rate across the team plays, where 1 is best.
yards_rankdoubleNational rank of the team's total yards, where 1 is best.
yardsplay_rankdoubleNational rank of the team's yards per play, where 1 is best.
yardsgame_rankdoubleNational rank of the team's yards per game, where 1 is best.
fbs_classcharacterPower/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.

Author

Saiem Gilani

Examples

# \donttest{
  try(load_espn_cfb_rushing(2004))
#> ── college football rushing EPA splits from the SportsDataverse data repo ──────
#>  Data updated: 2026-09-10 05:50:10 UTC
#> # A tibble: 1,109 × 41
#>    team_id pos_team      division conference season player_id rusher_player_name
#>    <chr>   <chr>         <chr>    <chr>       <int>     <int> <chr>             
#>  1 2751    Wyoming       fbs      Mountain …   2004    116544 C.R. Davis        
#>  2 59      Georgia Tech  fbs      ACC          2004    135938 Ajenavi Eziemefe  
#>  3 2579    South Caroli… fbs      SEC          2004    134901 Troy Williamson   
#>  4 2294    Iowa          fbs      Big Ten      2004    100560 Aaron Mickens     
#>  5 158     Nebraska      fbs      Big 12       2004    107554 Willie Amos       
#>  6 265     Washington S… fbs      Pac-10       2004    164335 Jerome Harrison   
#>  7 2348    Louisiana Te… fbs      Western A…   2004    136415 Ryan Moats        
#>  8 158     Nebraska      fbs      Big 12       2004    162707 Brandon Jackson   
#>  9 9       Arizona State fbs      Pac-10       2004    127680 Chad Christensen  
#> 10 152     NC State      fbs      ACC          2004    161912 Bobby Washington  
#> # ℹ 1,099 more rows
#> # ℹ 34 more variables: plays <int>, games <int>, team_games <int>, TEPA <dbl>,
#> #   EPAplay <dbl>, yards <int>, success <dbl>, rushing_td <dbl>, fumbles <dbl>,
#> #   playsgame <dbl>, EPAgame <dbl>, yardsplay <dbl>, yardsgame <dbl>,
#> #   TEPA_rank <dbl>, EPAgame_rank <dbl>, EPAplay_rank <dbl>,
#> #   success_rank <dbl>, plays_rank <dbl>, yards_rank <dbl>,
#> #   rushing_td_rank <dbl>, fumbles_rank <dbl>, yardsplay_rank <dbl>, …
# }