Skip to contents

CFB Data Games Examples

Saiem Gilani, Akshay Easwaran, Jared Lee
@saiemgilani @saiemgilani @akeaswaran @akeaswaran

Source: vignettes/cfbd_games.Rmd
cfbd_games.Rmd

Load and Install Packages 

if (!requireNamespace('pak', quietly = TRUE)){
  install.packages('pak')
}
pak::pak(c("dplyr", "tidyr", "gt"))
## ℹ Loading metadata database
## ✔ Loading metadata database ... done
## 
## 
## → Package library at /home/runner/work/_temp/Library.
## ✔ All system requirements are already installed.
## 
## ℹ No downloads are needed
## ℹ Installing system requirements
## ℹ Executing `sudo sh -c apt-get -y update`
## Get:1 file:/etc/apt/apt-mirrors.txt Mirrorlist [144 B]
## Hit:2 http://azure.archive.ubuntu.com/ubuntu jammy InRelease
## Hit:3 http://azure.archive.ubuntu.com/ubuntu jammy-updates InRelease
## Hit:4 http://azure.archive.ubuntu.com/ubuntu jammy-backports InRelease
## Hit:5 http://azure.archive.ubuntu.com/ubuntu jammy-security InRelease
## Hit:6 https://packages.microsoft.com/ubuntu/22.04/prod jammy InRelease
## Reading package lists...
## ℹ Executing `sudo sh -c apt-get -y install libicu-dev libcurl4-openssl-dev libssl-dev cmake make libuv1-dev pandoc libnode-dev libxml2-dev`
## Reading package lists...
## Building dependency tree...
## Reading state information...
## libicu-dev is already the newest version (70.1-2).
## make is already the newest version (4.3-4.1build1).
## pandoc is already the newest version (2.9.2.1-3ubuntu2).
## cmake is already the newest version (3.22.1-1ubuntu1.22.04.2).
## libcurl4-openssl-dev is already the newest version (7.81.0-1ubuntu1.29).
## libssl-dev is already the newest version (3.0.2-0ubuntu1.30).
## libuv1-dev is already the newest version (1.43.0-1ubuntu0.1).
## libxml2-dev is already the newest version (2.9.13+dfsg-1ubuntu0.14).
## libnode-dev is already the newest version (12.22.9~dfsg-1ubuntu3.6).
## 0 upgraded, 0 newly installed, 0 to remove and 22 not upgraded.
## ✔ 3 pkgs + 56 deps: kept 59 [9.7s]
## 
## Attaching package: 'dplyr'
## The following objects are masked from 'package:stats':
## 
##     filter, lag
## The following objects are masked from 'package:base':
## 
##     intersect, setdiff, setequal, union
library(tidyr)
library(gt)
# cfbfastR is deliberately NOT in the pak() list above. pkgdown and
# R CMD check render this vignette against the package being built, and
# installing from CRAN here would overwrite that dev build with the last
# release -- so any function added since it would vanish mid-render.
library(cfbfastR)
# pak::pak("sportsdataverse/cfbfastR")

Get game information 

df_2018_wk_1 <- cfbfastR::cfbd_game_info(year=2018, week = 1)

df_2018_wk_7_ind <- cfbfastR::cfbd_game_info(year=2018, week = 7, conference = "Ind")

line_scores <- cfbfastR::cfbd_game_info(year=2018, week = 13, team = "Texas A&M", quarter_scores = TRUE)

Get calendar weeks and dates 

cfbfastR::cfbd_calendar(2019)

Find game broadcast and media information 

cfbfastR::cfbd_game_media(2019, week = 4, conference = "ACC")

Get CFBD Advanced Game Box Scores (by game_id) 

cfbfastR::cfbd_game_box_advanced(game_id = 401114233)

Get CFBD Game Team Box Scores 

cfbfastR::cfbd_game_team_stats(2019, team = "LSU")
## ── Team stats data from CollegeFootballData.com ───────── cfbfastR 3.0.0.9000 ──
## ℹ Data updated: 2026-10-09 05:42:53 UTC
## # A tibble: 13 × 78
##      game_id school conference home_away opponent     opponent_conference points
##        <int> <chr>  <chr>      <chr>     <chr>        <chr>                <int>
##  1 401110842 LSU    SEC        away      Alabama      SEC                     46
##  2 401110850 LSU    SEC        away      Ole Miss     SEC                     58
##  3 401110805 LSU    SEC        away      Vanderbilt   SEC                     66
##  4 401110813 LSU    SEC        home      Utah State   Mountain West           42
##  5 401110819 LSU    SEC        home      Florida      SEC                     42
##  6 401110778 LSU    SEC        away      Texas        Big 12                  45
##  7 401110828 LSU    SEC        away      Mississippi… SEC                     36
##  8 401110859 LSU    SEC        home      Arkansas     SEC                     56
##  9 401110869 LSU    SEC        home      Texas A&M    SEC                     50
## 10 401110790 LSU    SEC        home      Northwester… Southland               65
## 11 401110725 LSU    SEC        home      Georgia Sou… Sun Belt                55
## 12 401110833 LSU    SEC        home      Auburn       SEC                     23
## 13 401132981 LSU    SEC        home      Georgia      SEC                     37
## # ℹ 71 more variables: total_yards <chr>, net_passing_yards <chr>,
## #   completion_attempts <chr>, passing_tds <chr>, yards_per_pass <chr>,
## #   passes_intercepted <chr>, interception_yards <chr>, interception_tds <chr>,
## #   rushing_attempts <chr>, rushing_yards <chr>, rush_tds <chr>,
## #   yards_per_rush_attempt <chr>, first_downs <chr>, third_down_eff <chr>,
## #   fourth_down_eff <chr>, punt_returns <chr>, punt_return_yards <chr>,
## #   punt_return_tds <chr>, kick_return_yards <chr>, kick_return_tds <chr>, …
cfbfastR::cfbd_game_team_stats(2013, team = "Florida State")
## ── Team stats data from CollegeFootballData.com ───────── cfbfastR 3.0.0.9000 ──
## ℹ Data updated: 2026-10-09 05:42:53 UTC
## # A tibble: 13 × 78
##      game_id school     conference home_away opponent opponent_conference points
##        <int> <chr>      <chr>      <chr>     <chr>    <chr>                <int>
##  1 332640052 Florida S… ACC        home      Bethune… MEAC                    54
##  2 332450221 Florida S… ACC        away      Pittsbu… ACC                     41
##  3 332710103 Florida S… ACC        away      Boston … ACC                     48
##  4 332780052 Florida S… ACC        home      Maryland ACC                     63
##  5 332990052 Florida S… ACC        home      NC State ACC                     49
##  6 333200052 Florida S… ACC        home      Syracuse ACC                     59
##  7 333340057 Florida S… ACC        away      Florida  SEC                     37
##  8 333410052 Florida S… ACC        home      Duke     ACC                     45
##  9 332570052 Florida S… ACC        home      Nevada   Mountain West           62
## 10 333130154 Florida S… ACC        away      Wake Fo… ACC                     59
## 11 332920228 Florida S… ACC        away      Clemson  ACC                     51
## 12 333060052 Florida S… ACC        home      Miami    ACC                     41
## 13 333270052 Florida S… ACC        home      Idaho    FBS Independents        80
## # ℹ 71 more variables: total_yards <chr>, net_passing_yards <chr>,
## #   completion_attempts <chr>, passing_tds <chr>, yards_per_pass <chr>,
## #   passes_intercepted <chr>, interception_yards <chr>, interception_tds <chr>,
## #   rushing_attempts <chr>, rushing_yards <chr>, rush_tds <chr>,
## #   yards_per_rush_attempt <chr>, first_downs <chr>, third_down_eff <chr>,
## #   fourth_down_eff <chr>, punt_returns <chr>, punt_return_yards <chr>,
## #   punt_return_tds <chr>, kick_return_yards <chr>, kick_return_tds <chr>, …

Get CFBD Game Player Box Scores 

cfbfastR::cfbd_game_player_stats(2018, week = 15, conference = "Ind")

cfbfastR::cfbd_game_player_stats(2013, week = 1, team = "Florida State", category = "passing")

Get CFBD Team Game Records 

cfbfastR::cfbd_game_records(2018, team = "Notre Dame")

cfbfastR::cfbd_game_records(2013, team = "Florida State")

Our Authors

Our Contributors

Citation

To cite the cfbfastR R package in publications, use:

BibTeX Citation

@misc{cfbfastr,
  author = {Saiem Gilani and Akshay Easwaran and Jared Lee and Eric Hess},
  title = {cfbfastR: Access College Football Play by Play Data},
  url = {https://cfbfastR.sportsdataverse.org/},
  year = {2021}
}