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,
division = "fbs"
)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
- division
(String optional): Division abbreviation - Select a valid division: fbs/fcs/ii/iii
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.3 ──
#> ℹ Data updated: 2023-03-23 02:29:55 UTC
#> # A tibble: 25 × 28
#> offense offense_co…¹ defense defen…² game_id drive…³ drive…⁴ scoring start…⁵
#> <chr> <chr> <chr> <chr> <int> <chr> <int> <lgl> <int>
#> 1 TCU Big 12 Southe… SWAC 4.01e8 401013… 1 TRUE 1
#> 2 Southern SWAC TCU Big 12 4.01e8 401013… 2 FALSE 1
#> 3 TCU Big 12 Southe… SWAC 4.01e8 401013… 3 TRUE 1
#> 4 Southern SWAC TCU Big 12 4.01e8 401013… 4 FALSE 1
#> 5 TCU Big 12 Southe… SWAC 4.01e8 401013… 5 TRUE 1
#> 6 Southern SWAC TCU Big 12 4.01e8 401013… 6 FALSE 1
#> 7 TCU Big 12 Southe… SWAC 4.01e8 401013… 7 TRUE 1
#> 8 Southern SWAC TCU Big 12 4.01e8 401013… 8 FALSE 2
#> 9 TCU Big 12 Southe… SWAC 4.01e8 401013… 9 TRUE 2
#> 10 Southern SWAC TCU Big 12 4.01e8 401013… 10 TRUE 2
#> # … with 15 more rows, 19 more variables: 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>,
#> # time_seconds_start <int>, time_minutes_end <int>, time_seconds_end <int>, …
try(cfbd_drives(2018, team = "Texas A&M", defense_conference = "SEC"))
#> ── Drives data from CollegeFootballData.com ────────────────── cfbfastR 1.9.3 ──
#> ℹ Data updated: 2023-03-23 02:29:56 UTC
#> # A tibble: 259 × 28
#> offense offen…¹ defense defen…² game_id drive…³ drive…⁴ scoring start…⁵
#> <chr> <chr> <chr> <chr> <int> <chr> <int> <lgl> <int>
#> 1 Northwestern… Southl… Texas … SEC 4.01e8 401012… 1 FALSE 1
#> 2 Northwestern… Southl… Texas … SEC 4.01e8 401012… 3 FALSE 1
#> 3 Northwestern… Southl… Texas … SEC 4.01e8 401012… 5 FALSE 1
#> 4 Northwestern… Southl… Texas … SEC 4.01e8 401012… 7 FALSE 1
#> 5 Northwestern… Southl… Texas … SEC 4.01e8 401012… 9 FALSE 2
#> 6 Northwestern… Southl… Texas … SEC 4.01e8 401012… 11 FALSE 2
#> 7 Northwestern… Southl… Texas … SEC 4.01e8 401012… 13 FALSE 2
#> 8 Northwestern… Southl… Texas … SEC 4.01e8 401012… 15 FALSE 2
#> 9 Northwestern… Southl… Texas … SEC 4.01e8 401012… 17 FALSE 3
#> 10 Northwestern… Southl… Texas … SEC 4.01e8 401012… 19 FALSE 3
#> # … with 249 more rows, 19 more variables: 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>,
#> # time_seconds_start <int>, time_minutes_end <int>, time_seconds_end <int>, …
# }