load_teams() #> ── nflverse team graphics ────────────────────────────────────────────────────── -#> ℹ Data updated: 2024-09-17 14:27:04 UTC +#> ℹ Data updated: 2024-10-22 13:29:19 UTC #> # A tibble: 32 × 16 #> team_abbr team_name team_id team_nick team_conf team_division team_color #> <chr> <chr> <chr> <chr> <chr> <chr> <chr> @@ -918,7 +918,7 @@ Get team wins each season#> $ stadium_id : chr [1:6978] "ATL00" "CHI98" "CLE00" "GNB00" ... #> $ stadium : chr [1:6978] "Georgia Dome" "Soldier Field" "Cleveland Browns Stadium" "Lambeau Field" ... #> - attr(*, "nflverse_type")= chr "games and schedules" -#> - attr(*, "nflverse_timestamp")= chr "2024-09-17 10:27:34 EDT"
To start, we want to create a dataframe where each row is a team-season observation, listing how many games they won. There are multiple ways to do this, but I’m going to just take the home and away @@ -931,7 +931,7 @@
In most cases, however, it is not necessary to use this function for individual games, because nflfastR provides both a data repository and @@ -359,7 +359,7 @@
tictoc::tic("loading all games from 2009") games_2009 <- nflfastR::load_pbp(2009) %>% dplyr::filter(season_type == "REG") tictoc::toc() -#> loading all games from 2009: 2.671 sec elapsed +#> loading all games from 2009: 2.292 sec elapsed games_2009 %>% dplyr::filter(!is.na(cpoe)) %>% dplyr::group_by(passer_player_name) %>% @@ -864,15 +864,15 @@ Build database nflfastR::update_db() -#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9017 ── -#> ℹ 14:29:53 | Can't find the data table "nflfastR_pbp" +#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9018 ── +#> ℹ 13:32:00 | Can't find the data table "nflfastR_pbp" #> in your database. Will load the play by play data from #> scratch. -#> • 14:29:53 | Starting download of 26 seasons between 1999 and 2024... -#> • 14:31:29 | Checking for missing completed games... -#> ℹ 14:31:31 | You have 6735 games and are missing 0. -#> ✔ 14:31:32 | Database update completed -#> ℹ 14:31:32 | Path to your db: ./pbp_db +#> • 13:32:00 | Starting download of 26 seasons between 1999 and 2024... +#> • 13:33:31 | Checking for missing completed games... +#> ℹ 13:33:32 | You have 6810 games and are missing 0. +#> ✔ 13:33:33 | Database update completed +#> ℹ 13:33:33 | Path to your db: ./pbp_db #> ── DONE ──────────────────────────────────────────────────────────────────────── This created a database in the current directory called pbp_db. @@ -883,25 +883,25 @@ Build database nflfastR::update_db() -#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9017 ── -#> • 14:31:32 | Checking for missing completed games... -#> ℹ 14:31:32 | You have 6735 games and are missing 0. -#> ✔ 14:31:33 | Database update completed -#> ℹ 14:31:33 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db +#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9018 ── +#> • 13:33:33 | Checking for missing completed games... +#> ℹ 13:33:33 | You have 6810 games and are missing 0. +#> ✔ 13:33:34 | Database update completed +#> ℹ 13:33:34 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db #> ── DONE ──────────────────────────────────────────────────────────────────────── If it’s partway through a season and you want to re-build a season to allow for data corrections from the NFL to propagate into your database, you can specify one season to be rebuilt: nflfastR::update_db(force_rebuild = 2020) -#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9017 ── -#> • 14:31:33 | Purging season 2020 from the data table "nflfastR_pbp" in your +#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9018 ── +#> • 13:33:34 | Purging season 2020 from the data table "nflfastR_pbp" in your #> connected database... -#> • 14:31:34 | Starting download of the 1 season 2020 -#> • 14:31:37 | Checking for missing completed games... -#> ℹ 14:31:38 | You have 6735 games and are missing 0. -#> ✔ 14:31:39 | Database update completed -#> ℹ 14:31:39 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db +#> • 13:33:35 | Starting download of the 1 season 2020 +#> • 13:33:39 | Checking for missing completed games... +#> ℹ 13:33:40 | You have 6810 games and are missing 0. +#> ✔ 13:33:40 | Database update completed +#> ℹ 13:33:40 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db #> ── DONE ────────────────────────────────────────────────────────────────────────
nflfastR::update_db() -#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9017 ── -#> ℹ 14:29:53 | Can't find the data table "nflfastR_pbp" +#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9018 ── +#> ℹ 13:32:00 | Can't find the data table "nflfastR_pbp" #> in your database. Will load the play by play data from #> scratch. -#> • 14:29:53 | Starting download of 26 seasons between 1999 and 2024... -#> • 14:31:29 | Checking for missing completed games... -#> ℹ 14:31:31 | You have 6735 games and are missing 0. -#> ✔ 14:31:32 | Database update completed -#> ℹ 14:31:32 | Path to your db: ./pbp_db +#> • 13:32:00 | Starting download of 26 seasons between 1999 and 2024... +#> • 13:33:31 | Checking for missing completed games... +#> ℹ 13:33:32 | You have 6810 games and are missing 0. +#> ✔ 13:33:33 | Database update completed +#> ℹ 13:33:33 | Path to your db: ./pbp_db #> ── DONE ────────────────────────────────────────────────────────────────────────
This created a database in the current directory called pbp_db.
pbp_db
nflfastR::update_db() -#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9017 ── -#> • 14:31:32 | Checking for missing completed games... -#> ℹ 14:31:32 | You have 6735 games and are missing 0. -#> ✔ 14:31:33 | Database update completed -#> ℹ 14:31:33 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db +#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9018 ── +#> • 13:33:33 | Checking for missing completed games... +#> ℹ 13:33:33 | You have 6810 games and are missing 0. +#> ✔ 13:33:34 | Database update completed +#> ℹ 13:33:34 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db #> ── DONE ────────────────────────────────────────────────────────────────────────
If it’s partway through a season and you want to re-build a season to allow for data corrections from the NFL to propagate into your database, you can specify one season to be rebuilt:
nflfastR::update_db(force_rebuild = 2020) -#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9017 ── -#> • 14:31:33 | Purging season 2020 from the data table "nflfastR_pbp" in your +#> ── Update nflfastR Play-by-Play Database ──────── nflfastR version 4.6.1.9018 ── +#> • 13:33:34 | Purging season 2020 from the data table "nflfastR_pbp" in your #> connected database... -#> • 14:31:34 | Starting download of the 1 season 2020 -#> • 14:31:37 | Checking for missing completed games... -#> ℹ 14:31:38 | You have 6735 games and are missing 0. -#> ✔ 14:31:39 | Database update completed -#> ℹ 14:31:39 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db +#> • 13:33:35 | Starting download of the 1 season 2020 +#> • 13:33:39 | Checking for missing completed games... +#> ℹ 13:33:40 | You have 6810 games and are missing 0. +#> ✔ 13:33:40 | Database update completed +#> ℹ 13:33:40 | Path to your db: /home/runner/work/nflfastR/nflfastR/vignettes/pbp_db #> ── DONE ────────────────────────────────────────────────────────────────────────
So far, everything has stayed in the database. If you want to bring a query into memory, just use collect() at the end:
collect()
Carl S, Baldwin B (2024). nflfastR: Functions to Efficiently Access NFL Play by Play Data. -R package version 4.6.1.9017, +R package version 4.6.1.9018, https://github.com/nflverse/nflfastR, https://www.nflfastr.com/.
@Manual{, title = {nflfastR: Functions to Efficiently Access NFL Play by Play Data}, author = {Sebastian Carl and Ben Baldwin}, year = {2024}, - note = {R package version 4.6.1.9017, + note = {R package version 4.6.1.9018, https://github.com/nflverse/nflfastR}, url = {https://www.nflfastr.com/}, }
calculate_player_stats_def
season_type
weekly
TRUE
missing_raw_pbp()
decode_player_ids()
clean_pbp()
pass = 1
fixed_drive
Site built with pkgdown 2.1.0.9000.
Site built with pkgdown 2.1.1.9000.