{"id":22117209,"url":"https://github.com/sportsdataverse/cfbfastr","last_synced_at":"2025-04-12T15:41:59.978Z","repository":{"id":41844236,"uuid":"354070752","full_name":"sportsdataverse/cfbfastR","owner":"sportsdataverse","description":"An R package to quickly obtain clean and tidy college football play by play data","archived":false,"fork":false,"pushed_at":"2024-10-17T02:06:52.000Z","size":101895,"stargazers_count":83,"open_issues_count":10,"forks_count":8,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-03T16:12:57.672Z","etag":null,"topics":["cfb-data","college-football","college-football-players","collegefootballdata-api","espn","football","football-api","football-data","football-scores","footballdata","ncaaf","r","rstats","sports","sports-analytics","sports-betting","sports-data","sports-stats","sportsanalytics","sportsdataverse"],"latest_commit_sha":null,"homepage":"https://cfbfastR.sportsdataverse.org","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sportsdataverse.png","metadata":{"files":{"readme":"README.Rmd","changelog":"NEWS.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-02T16:16:30.000Z","updated_at":"2025-03-18T20:35:39.000Z","dependencies_parsed_at":"2023-11-14T03:32:25.691Z","dependency_job_id":"7ceb8193-640e-4736-a7a4-c1cbe9d2e0f1","html_url":"https://github.com/sportsdataverse/cfbfastR","commit_stats":{"total_commits":289,"total_committers":30,"mean_commits":9.633333333333333,"dds":"0.16608996539792387","last_synced_commit":"e0f97cfe07e7f5e970dd482a0d68315c211dc095"},"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sportsdataverse%2FcfbfastR","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sportsdataverse%2FcfbfastR/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sportsdataverse%2FcfbfastR/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sportsdataverse%2FcfbfastR/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sportsdataverse","download_url":"https://codeload.github.com/sportsdataverse/cfbfastR/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248590892,"owners_count":21129907,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfb-data","college-football","college-football-players","collegefootballdata-api","espn","football","football-api","football-data","football-scores","footballdata","ncaaf","r","rstats","sports","sports-analytics","sports-betting","sports-data","sports-stats","sportsanalytics","sportsdataverse"],"created_at":"2024-12-01T13:30:07.181Z","updated_at":"2025-04-12T15:41:59.956Z","avatar_url":"https://github.com/sportsdataverse.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\r\noutput: github_document\r\n---\r\n\r\n#\r\n\r\n# **cfbfastR**  \u003ca href='https://cfbfastR.sportsdataverse.org/'\u003e\u003cimg src='https://raw.githubusercontent.com/sportsdataverse/cfbfastR/main/logo.png' align=\"right\" width=\"20%\" min-width=\"100px\"/\u003e\u003c/a\u003e\r\n```{r, include = FALSE}\r\nrequire(knitr)\r\nif (!requireNamespace('issue') \u0026 !requireNamespace('pacman')){\r\n  install.packages('pacman')\r\n}\r\npacman::p_load(magick, grid, dplyr, lubridate)\r\n\r\n```\r\n\r\n\r\n\r\n\u003c!-- badges: start --\u003e\r\n\r\n[![CRAN version](https://img.shields.io/badge/dynamic/json?style=for-the-badge\u0026color=success\u0026label=CRAN%20version\u0026prefix=v\u0026query=%24.Version\u0026url=https%3A%2F%2Fcrandb.r-pkg.org%2FcfbfastR)](https://CRAN.R-project.org/package=cfbfastR)\r\n[![CRAN downloads](https://img.shields.io/badge/dynamic/json?style=for-the-badge\u0026color=success\u0026label=Downloads\u0026query=%24%5B0%5D.downloads\u0026url=https%3A%2F%2Fcranlogs.r-pkg.org%2Fdownloads%2Ftotal%2F2021-10-26%3Alast-day%2FcfbfastR)](https://CRAN.R-project.org/package=cfbfastR)\r\n[![Version-Number](https://img.shields.io/github/r-package/v/sportsdataverse/cfbfastR?label=cfbfastR\u0026logo=R\u0026style=for-the-badge)](https://github.com/sportsdataverse/cfbfastR/)\r\n[![R-CMD-check](https://img.shields.io/github/actions/workflow/status/sportsdataverse/cfbfastR/R-CMD-check.yaml?branch=main\u0026label=R-CMD-Check\u0026logo=R\u0026logoColor=white\u0026style=for-the-badge)](https://github.com/sportsdataverse/cfbfastR/actions/workflows/R-CMD-check.yaml) [![Lifecycle:maturing](https://img.shields.io/badge/lifecycle-maturing-blue.svg?style=for-the-badge\u0026logo=github)](https://github.com/sportsdataverse/cfbfastR/)  [![Contributors](https://img.shields.io/github/contributors/sportsdataverse/cfbfastR?style=for-the-badge)](https://github.com/sportsdataverse/cfbfastR/graphs/contributors) [![Twitter Follow](https://img.shields.io/twitter/follow/cfbfastR?color=blue\u0026label=%40cfbfastR\u0026logo=twitter\u0026style=for-the-badge)](https://twitter.com/cfbfastR) [![Twitter Follow](https://img.shields.io/twitter/follow/SportsDataverse?color=blue\u0026label=%40SportsDataverse\u0026logo=twitter\u0026style=for-the-badge)](https://twitter.com/SportsDataverse) \r\n\u003c!-- badges: end --\u003e\r\n\r\nThe goal of [**```cfbfastR```**](https://cfbfastR.sportsdataverse.org/) is to provide the community with an R package for working with CFB data. It is an R API wrapper around [https://collegefootballdata.com/](https://collegefootballdata.com/). Beyond data aggregation and tidying ease, one of the multitude of services that [**```cfbfastR```**](https://cfbfastR.sportsdataverse.org/) provides is for benchmarking open-source expected points and win probability metrics.\r\n\r\n## **Installation**\r\n\r\nYou can install the CRAN version of [**```cfbfastR```** ](https://CRAN.R-project.org/package=cfbfastR) with:\r\n```r\r\ninstall.packages(\"cfbfastR\")\r\n```\r\n\r\nYou can install the released version of [**```cfbfastR```**](https://github.com/sportsdataverse/cfbfastR/) from [GitHub](https://github.com/sportsdataverse/cfbfastR) with:\r\n\r\n```r\r\n# You can install using the pacman package using the following code:\r\nif (!requireNamespace('pacman', quietly = TRUE)){\r\n  install.packages('pacman')\r\n}\r\npacman::p_load_current_gh(\"sportsdataverse/cfbfastR\", dependencies = TRUE, update = TRUE)\r\n```\r\n\r\n\r\n## **Breaking Changes**\r\n\r\n[**Full News on Releases**](https://cfbfastR.sportsdataverse.org/news/index.html)\r\n\r\n\r\n\r\n#### **College Football Data API Keys**\r\n\r\nThe [CollegeFootballData API](https://collegefootballdata.com/) now requires an API key, here's a quick run-down:\r\n\r\n* To get an API key, follow the directions here: [College Football Data Key Registration.](https://collegefootballdata.com/key) \r\n\r\n* Using the key: You can save the key for consistent usage by adding `CFBD_API_KEY=YOUR-API-KEY-HERE` to your .Renviron file (easily accessed via [**`usethis::edit_r_environ()`**](https://usethis.r-lib.org/reference/edit.html)). Run [**`usethis::edit_r_environ()`**](https://usethis.r-lib.org/reference/edit.html), a new script will pop open named `.Renviron`, **THEN** paste the following in the new script that pops up (with**out** quotations)\r\n```r\r\nCFBD_API_KEY = YOUR-API-KEY-HERE\r\n```\r\nSave the script and restart your RStudio session, by clicking `Session` (in between `Plots` and `Build`) and click `Restart R` (there also exists the shortcut `Ctrl + Shift + F10` to restart your session). If set correctly, from then on you should be able to use any of the `cfbd_` functions without any other changes.\r\n\r\n* For less consistent usage: At the beginning of every session or within an R environment, save your API key as the environment variable `CFBD_API_KEY` (with quotations) using a command like the following.\r\n\r\n```{r}\r\nSys.setenv(CFBD_API_KEY = \"YOUR-API-KEY-HERE\")\r\n```\r\n\r\n\r\n\r\n## Follow [cfbfastR](https://twitter.com/cfbfastR) and the [SportsDataverse](https://twitter.com/SportsDataverse) on Twitter and star this repo\r\n\r\n[![Twitter Follow](https://img.shields.io/twitter/follow/cfbfastR?color=blue\u0026label=%40cfbfastR\u0026logo=twitter\u0026style=for-the-badge)](https://twitter.com/cfbfastR) \r\n[![Twitter Follow](https://img.shields.io/twitter/follow/SportsDataverse?color=blue\u0026label=%40SportsDataverse\u0026logo=twitter\u0026style=for-the-badge)](https://twitter.com/SportsDataverse) \r\n\r\n[![GitHub stars](https://img.shields.io/github/stars/sportsdataverse/cfbfastR.svg?color=eee\u0026logo=github\u0026style=for-the-badge\u0026label=Star%20cfbfastR\u0026maxAge=2592000)](https://github.com/sportsdataverse/cfbfastR/stargazers/)\r\n\r\n## **Our Authors**\r\n\r\n-   [Saiem Gilani](https://twitter.com/saiemgilani)       \r\n\u003ca href=\"https://twitter.com/saiemgilani\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/saiemgilani?color=blue\u0026label=%40saiemgilani\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@saiemgilani\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/saiemgilani\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/saiemgilani?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@saiemgilani\" /\u003e\u003c/a\u003e\r\n\r\n-   [Akshay Easwaran](https://twitter.com/akeaswaran)       \r\n\u003ca href=\"https://twitter.com/akeaswaran\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/akeaswaran?color=blue\u0026label=%40akeaswaran\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@akeaswaran\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/akeaswaran\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/akeaswaran?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@akeaswaran\" /\u003e\u003c/a\u003e\r\n\r\n-   [Jared Lee](https://twitter.com/JaredDLee) \u003c/br\u003e\r\n\u003ca href=\"https://twitter.com/JaredDLee\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/JaredDLee?color=blue\u0026label=%40JaredDLee\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@JaredDLee\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/Kazink36\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/Kazink36?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@Kazink36\" /\u003e\u003c/a\u003e\r\n\r\n-   [Eric Hess](https://twitter.com/arbitanalytics) \u003c/br\u003e\r\n  \u003ca href=\"https://twitter.com/arbitanalytics\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/arbitanalytics?color=blue\u0026label=%40arbitanalytics\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@arbitanalytics\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/ehess\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/ehess?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@ehess\" /\u003e\u003c/a\u003e\r\n\r\n# **Our Contributors (they're awesome)**\r\n\r\n-   [Nate Manzo](https://twitter.com/cfbnate)       \r\n\u003ca href=\"https://twitter.com/cfbnate\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/cfbnate?color=blue\u0026label=%40cfbnate\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@cfbnate\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/natemanzo\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/natemanzo?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@natemanzo\" /\u003e\u003c/a\u003e\r\n\r\n-   [Michael Egle](https://twitter.com/deceptivespeed_)      \r\n\u003ca href=\"https://twitter.com/deceptivespeed_\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/deceptivespeed_?color=blue\u0026label=%40deceptivespeed_\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@deceptivespeed_\" /\u003e\u003c/a\u003e \r\n\u003ca href=\"https://github.com/michaelegle\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/michaelegle?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@michaelegle\" /\u003e\u003c/a\u003e\r\n\r\n-   [Jason DeLoach](https://twitter.com/CFBNumbers)      \r\n\u003ca href=\"https://twitter.com/CFBNumbers\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/CFBNumbers?color=blue\u0026label=%40CFBNumbers\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@CFBNumbers\" /\u003e\u003c/a\u003e \r\n\u003ca href=\"https://github.com/CFBNumbers\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/CFBNumbers?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@CFBNumbers\" /\u003e\u003c/a\u003e\r\n\r\n-   [Tej Seth](https://twitter.com/Tejseth41)      \r\n\u003ca href=\"https://twitter.com/Tejseth41\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/Tejseth41?color=blue\u0026label=%40Tejseth41\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@Tejseth41\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/tejseth\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/tejseth?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@tejseth\" /\u003e\u003c/a\u003e\r\n\r\n-   [Conor McQuiston](https://twitter.com/ConorMcQ5)      \r\n\u003ca href=\"https://twitter.com/ConorMcQ5\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/ConorMcQ5?color=blue\u0026label=%40ConorMcQ5\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@ConorMcQ5\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/mcqconor\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/mcqconor?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@mcqconor\" /\u003e\u003c/a\u003e\r\n\r\n-   [Tan Ho](https://twitter.com/_TanHo)      \r\n\u003ca href=\"https://twitter.com/_TanHo\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/_TanHo?color=blue\u0026label=%40_TanHo\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@_TanHo\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/tanho63\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/tanho63?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@tanho63\" /\u003e\u003c/a\u003e\r\n\r\n-   [Keegan Abdoo](https://twitter.com/KeeganAbdoo)      \r\n\u003ca href=\"https://twitter.com/KeeganAbdoo\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/KeeganAbdoo?color=blue\u0026label=%40KeeganAbdoo\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@KeeganAbdoo\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/keegan-abdoo\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/keegan-abdoo?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@keegan-abdoo\" /\u003e\u003c/a\u003e\r\n\r\n-   [Matt Spencer](https://twitter.com/Maatspencer)      \r\n\u003ca href=\"https://twitter.com/Maatspencer\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/Maatspencer?color=blue\u0026label=%40Maatspencer\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@Maatspencer\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/Maatspencer\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/Maatspencer?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@Maatspencer\" /\u003e\u003c/a\u003e\r\n\r\n-   [Sebastian Carl](https://twitter.com/mrcaseb)                   \r\n\u003ca href=\"https://twitter.com/mrcaseb\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/mrcaseb?color=blue\u0026label=%40mrcaseb\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@mrcaseb\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/mrcaseb\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/mrcaseb?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@mrcaseb\" /\u003e\u003c/a\u003e\r\n\r\n-   [John Edwards](https://twitter.com/John_B_Edwards) \u003c/br\u003e\r\n    \u003ca href=\"https://twitter.com/John_B_Edwards\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/John_B_Edwards?color=blue\u0026label=%40John_B_Edwards\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@John_B_Edwards\" /\u003e\u003c/a\u003e\r\n    \u003ca href=\"https://github.com/john-b-edwards\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/john-b-edwards?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@john-b-edwards\" /\u003e\u003c/a\u003e\r\n\r\n# **Authors Emeritus - `cfbscrapR`[archived]**\r\n\r\n-   [Meyappan Subbiah](https://twitter.com/msubbaiah1)      \r\n\u003ca href=\"https://twitter.com/msubbaiah1\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/msubbaiah1?color=blue\u0026label=%40msubbaiah1\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@msubbaiah1\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/meysubb\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/meysubb?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@meysubb\" /\u003e\u003c/a\u003e\r\n\r\n-   [Parker Fleming](https://twitter.com/statsowar)      \r\n\u003ca href=\"https://twitter.com/statsowar\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/statsowar?color=blue\u0026label=%40statsowar\u0026logo=twitter\u0026style=for-the-badge\" alt=\"@statsowar\" /\u003e\u003c/a\u003e\r\n\u003ca href=\"https://github.com/spfleming\" target=\"blank\"\u003e\u003cimg src=\"https://img.shields.io/github/followers/spfleming?color=eee\u0026logo=Github\u0026style=for-the-badge\" alt=\"@spfleming\" /\u003e\u003c/a\u003e\r\n\r\n# **Special Thanks**\r\n\r\n-   [Nick Tice](https://github.com/NickTice)\r\n\r\n## **Citations**\r\n\r\nTo cite the [**`cfbfastR`**](https://cfbfastR.sportsdataverse.org/) R package in publications, use:\r\n\r\nBibTex Citation\r\n```bibtex\r\n@misc{gilani_et_al_2021_cfbfastr,\r\n  author = {Saiem Gilani and Akshay Easwaran and Jared Lee and Eric Hess},\r\n  title = {cfbfastR: The SportsDataverse's R Package for College Football Data.},\r\n  url = {https://cfbfastR.sportsdataverse.org/},\r\n  year = {2021}\r\n}\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsportsdataverse%2Fcfbfastr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsportsdataverse%2Fcfbfastr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsportsdataverse%2Fcfbfastr/lists"}