Skip to contents

Get college football game drives

Usage

cfbd_drives(
  year,
  season_type = "regular",
  week = NULL,
  team = NULL,
  offense_team = NULL,
  defense_team = NULL,
  conference = NULL,
  offense_conference = NULL,
  defense_conference = NULL
)

Arguments

year

(Integer required): Year, 4 digit format (YYYY)

season_type

(String default regular): Select Season Type: regular, postseason, or both

week

(Integer optional): Week - values from 1-15, 1-14 for seasons pre-playoff, i.e. 2013 or earlier

team

(String optional): D-I Team

offense_team

(String optional): Offense D-I Team

defense_team

(String optional): Defense D-I Team

conference

(String optional): DI Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

offense_conference

(String optional): Offense DI Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

defense_conference

(String optional): Defense DI Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

Value

cfbd_drives() - A data frame with 23 variables as follows:

offense:character.

Drive offense.

offense_conference:character.

Drive offense's conference.

defense:character.

Drive defense.

defense_conference:character.

Drive defense's conference.

game_id:integer.

Unique game identifier - game_id.

drive_id:character.

Unique drive identifier - drive_id.

drive_number:integer.

Drive number in game.

scoring:logical.

Drive ends in a score.

start_period:integer.

Period (or Quarter) in which the drive starts.

start_yardline:integer.

Yard line at the drive start.

start_yards_to_goal:integer.

Yards-to-Goal at the drive start.

end_period:integer.

Period (or Quarter) in which the drive ends.

end_yardline:integer.

Yard line at drive end.

end_yards_to_goal:integer.

Yards-to-Goal at drive end.

plays:integer.

Number of drive plays.

yards:integer.

Total drive yards.

drive_result:character.

Result of the drive description.

is_home_offense:logical.

Flag for if the offense on the field is the home offense

start_offense_score:numeric.

Offense score at the start of the drive.

start_defense_score:numeric.

Defense score at the start of the drive.

end_offense_score:numeric.

Offense score at the end of the drive.

end_defense_score:numeric.

Defense score at the end of the drive.

time_minutes_start:integer.

Minutes at drive start.

time_seconds_start:integer.

Seconds at drive start.

time_minutes_end:integer.

Minutes at drive end.

time_seconds_end:integer.

Seconds at drive end.

time_minutes_elapsed:double.

Minutes elapsed during drive.

time_seconds_elapsed:integer.

Seconds elapsed during drive.

Examples

# \donttest{
  try(cfbd_drives(2018, week = 1, team = "TCU"))
#> ── Drives data from CollegeFootballData.com ────────────────── cfbfastR 1.9.0 ──
#>  Data updated: 2022-06-15 19:50:38 UTC
#> # A tibble: 25 × 28
#>    offense  offense_conference defense  defense_conference   game_id drive_id   
#>    <chr>    <chr>              <chr>    <chr>                  <int> <chr>      
#>  1 TCU      Big 12             Southern NA                 401013072 4010130721 
#>  2 Southern NA                 TCU      Big 12             401013072 4010130722 
#>  3 TCU      Big 12             Southern NA                 401013072 4010130723 
#>  4 Southern NA                 TCU      Big 12             401013072 4010130724 
#>  5 TCU      Big 12             Southern NA                 401013072 4010130725 
#>  6 Southern NA                 TCU      Big 12             401013072 4010130726 
#>  7 TCU      Big 12             Southern NA                 401013072 4010130727 
#>  8 Southern NA                 TCU      Big 12             401013072 4010130728 
#>  9 TCU      Big 12             Southern NA                 401013072 4010130729 
#> 10 Southern NA                 TCU      Big 12             401013072 40101307210
#> # … with 15 more rows, and 22 more variables: drive_number <int>,
#> #   scoring <lgl>, start_period <int>, start_yardline <int>,
#> #   start_yards_to_goal <int>, end_period <int>, end_yardline <int>,
#> #   end_yards_to_goal <int>, plays <int>, yards <int>, drive_result <chr>,
#> #   is_home_offense <lgl>, start_offense_score <int>,
#> #   start_defense_score <int>, end_offense_score <int>,
#> #   end_defense_score <int>, time_minutes_start <int>, …

  try(cfbd_drives(2018, team = "Texas A&M", defense_conference = "SEC"))
#> ── Drives data from CollegeFootballData.com ────────────────── cfbfastR 1.9.0 ──
#>  Data updated: 2022-06-15 19:50:38 UTC
#> # A tibble: 259 × 28
#>    offense            offense_confere… defense defense_confere… game_id drive_id
#>    <chr>              <chr>            <chr>   <chr>              <int> <chr>   
#>  1 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  2 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  3 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  4 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  5 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  6 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  7 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  8 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#>  9 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#> 10 Northwestern State NA               Texas … SEC               4.01e8 4010122…
#> # … with 249 more rows, and 22 more variables: drive_number <int>,
#> #   scoring <lgl>, start_period <int>, start_yardline <int>,
#> #   start_yards_to_goal <int>, end_period <int>, end_yardline <int>,
#> #   end_yards_to_goal <int>, plays <int>, yards <int>, drive_result <chr>,
#> #   is_home_offense <lgl>, start_offense_score <int>,
#> #   start_defense_score <int>, end_offense_score <int>,
#> #   end_defense_score <int>, time_minutes_start <int>, …
# }