nflreadr is a minimal package for downloading data from nflverse repositories. It includes caching, optional progress updates, and data dictionaries.
Please note that nflverse data repositories have been reorganized and pushed towards the nflverse-data repo, and v1.2.0+ is the minimum version that supports this change. We encourage all users to upgrade to this version immediately.
For Python access to nflverse data, please check out nfl-data-py - maintained by Cooper Adams.
Install the stable version from CRAN with:
install.packages("nflreadr")Install the development version from GitHub with:
install.packages("nflreadr", repos = "https://nflverse.r-universe.dev")
# or use remotes/devtools
# install.packages("remotes")
remotes::install_github("nflverse/nflreadr")The main functions of nflreadr are prefixed with
load_.
library(nflreadr)
load_pbp(2021)
#> ── nflverse play by play ───────────────────────────────────────────────────────
#> ℹ Data updated: 2022-07-28 18:10:55 EDT
#> # A tibble: 50,712 × 372
#> play_id game_id old_game_id home_team away_team season_type week posteam
#> <dbl> <chr> <chr> <chr> <chr> <chr> <int> <chr>
#> 1 1 2021_01_AR… 2021091207 TEN ARI REG 1 <NA>
#> 2 40 2021_01_AR… 2021091207 TEN ARI REG 1 TEN
#> 3 55 2021_01_AR… 2021091207 TEN ARI REG 1 TEN
#> 4 76 2021_01_AR… 2021091207 TEN ARI REG 1 TEN
#> 5 100 2021_01_AR… 2021091207 TEN ARI REG 1 TEN
#> 6 122 2021_01_AR… 2021091207 TEN ARI REG 1 TEN
#> 7 152 2021_01_AR… 2021091207 TEN ARI REG 1 ARI
#> 8 181 2021_01_AR… 2021091207 TEN ARI REG 1 ARI
#> 9 218 2021_01_AR… 2021091207 TEN ARI REG 1 ARI
#> 10 253 2021_01_AR… 2021091207 TEN ARI REG 1 ARI
#> # … with 50,702 more rows, and 364 more variables: posteam_type <chr>,
#> # defteam <chr>, side_of_field <chr>, yardline_100 <dbl>, game_date <chr>,
#> # quarter_seconds_remaining <dbl>, half_seconds_remaining <dbl>,
#> # game_seconds_remaining <dbl>, game_half <chr>, quarter_end <dbl>, …
load_player_stats(2021)
#> ── nflverse player stats: offense ──────────────────────────────────────────────
#> ℹ Data updated: 2022-07-28 18:18:44 EDT
#> # A tibble: 5,698 × 48
#> player_id player_name recent_team season week season_type completions
#> <chr> <chr> <chr> <int> <int> <chr> <int>
#> 1 00-0019596 T.Brady TB 2021 1 REG 32
#> 2 00-0019596 T.Brady TB 2021 2 REG 24
#> 3 00-0019596 T.Brady TB 2021 3 REG 41
#> 4 00-0019596 T.Brady TB 2021 4 REG 22
#> 5 00-0019596 T.Brady TB 2021 5 REG 30
#> 6 00-0019596 T.Brady TB 2021 6 REG 34
#> 7 00-0019596 T.Brady TB 2021 7 REG 20
#> 8 00-0019596 T.Brady TB 2021 8 REG 28
#> 9 00-0019596 T.Brady TB 2021 10 REG 23
#> 10 00-0019596 T.Brady TB 2021 11 REG 30
#> # … with 5,688 more rows, and 41 more variables: attempts <int>,
#> # passing_yards <dbl>, passing_tds <int>, interceptions <dbl>, sacks <dbl>,
#> # sack_yards <dbl>, sack_fumbles <int>, sack_fumbles_lost <int>,
#> # passing_air_yards <dbl>, passing_yards_after_catch <dbl>, …Data accessed by this package is stored on GitHub and can typically be found in one of the following repositories:
For a full list of functions, please see the reference page.
This data is maintained by the nflverse project team and is primarily automated via GitHub Actions. You can check the status and schedules page here: https://github.com/nflverse/nflverse-data
The following options help configure default nflreadr
behaviours.
options(nflreadr.verbose)
# TRUE/FALSE to silence messages such as cache warnings
options(nflreadr.cache)
# one of "memory", "filesystem", or "off"
options(nflreadr.prefer)
# one of "qs", "rds", "parquet", or "csv"
options(nflreadr.download_path)
# defaults to current working directory - change to specify where `nflverse_download()` places data.You can also configure nflreadr to display progress
messages with the progressr
package, e.g.
progressr::with_progress(load_rosters(seasons = 2010:2020))
|======== | 40%The best places to get help on this package are:
Many hands make light work! Here are some ways you can contribute to this project:
You can open an issue if you’d like to request specific data or report a bug/error.
If you’d like to contribute code, please check out the contribution guidelines.
The R code for this package is released as open source under the MIT License. NFL data accessed by this package belong to their respective owners, and are governed by their terms of use.