![](\"man/figures/logo.png\"){kind=logo}
\n\n\n\n[](https://CRAN.R-project.org/package=nflfastR)\n[](https://CRAN.R-project.org/package=nflfastR)\n[](https://nflfastr.com/)\n[](https://github.com/nflverse/nflfastR/actions)\n[](https://lifecycle.r-lib.org/articles/stages.html#stable)\n[](https://discord.com/invite/5Er2FBnnQa)\n\n\n\n`nflfastR` is a set of functions to efficiently scrape NFL play-by-play data. `nflfastR` expands upon the features of nflscrapR:\n \n* The package contains NFL play-by-play data back to 1999\n* As suggested by the package name, it obtains games **much** faster\n* Includes completion probability (`cp`), completion percentage over expected (`cpoe`), and expected yards after the catch (`xyac_epa` and `xyac_mean_yardage`) in play-by-play going back to 2006\n* Includes drive information, including drive starting position and drive result\n* Includes series information, including series number and series success\n* Hosts [a release of play-by-play data going back to 1999](https://github.com/nflverse/nflverse-data/releases/tag/pbp) for very quick access\n* Features models for Expected Points, Win Probability, Completion Probability, and Yards After the Catch (see section below)\n* Includes a function `update_db()` that creates and updates a database\n\nWe owe a debt of gratitude to the original [`nflscrapR`](https://github.com/maksimhorowitz/nflscrapR) team, Maksim Horowitz, Ronald Yurko, and Samuel Ventura, without whose contributions and inspiration this package would not exist.\n\n\n## Installation\n\nThe easiest way to get nflfastR is to install it from [CRAN](https://cran.r-project.org/package=nflfastR) with:\n\n```{r, eval=FALSE}\ninstall.packages(\"nflfastR\")\n```\n\nTo get a bug fix or to use a feature from the development version, you can install the development version of nflfastR either from [GitHub](https://github.com/nflverse/nflfastR/) with:\n\n``` {r eval = FALSE}\nif (!require(\"pak\")) install.packages(\"pak\")\npak::pak(\"nflverse/nflfastR\")\n```\n\nor prebuilt from the [development repo](https://nflverse.r-universe.dev) with:\n\n```{r eval = FALSE}\ninstall.packages(\"nflfastR\", repos = c(\"https://nflverse.r-universe.dev\", getOption(\"repos\")))\n```\n\n## Usage\n\nWe have provided some application examples in the **[Getting Started](https://nflfastr.com/articles/nflfastR.html)** article. However, these require a basic knowledge of R. For this reason we have the **[nflfastR beginner's guide](https://nflfastr.com/articles/beginners_guide.html)**, which we recommend to all those who are looking for an introduction to nflfastR with R.\n\nYou can find column names and descriptions in the **[Field Descriptions](https://nflfastr.com/articles/field_descriptions.html)** article, or by accessing the `field_descriptions` dataframe from the package.\n\n## Data access\n\nEven though `nflfastR` is very fast, **we recommend downloading the data from [here](https://github.com/nflverse/nflverse-data/releases/tag/pbp) or using the `nflreadr` package**. These data sets include play-by-play data of complete seasons going back to 1999 and are updated nightly during the season. The files contain both regular season and postseason data, and one can use game_type or week to figure out which games occurred in the postseason.\n\n## nflfastR models\n\n`nflfastR` uses its own models for Expected Points, Win Probability, Completion Probability, and Expected Yards After the Catch. To read about the models, please see [this post on Open Source Football](https://opensourcefootball.com/posts/2020-09-28-nflfastr-ep-wp-and-cp-models/). For a more detailed description of the motivation for Expected Points models, we highly recommend this paper [from the nflscrapR team located here](https://arxiv.org/pdf/1802.00998). \n\nHere is a visualization of the Expected Points model by down and yardline.\n\n``` {r epa-model, warning = FALSE, message = FALSE, results = 'hide', fig.keep = 'all', dpi = 600, echo=FALSE, eval = FALSE}\n\n# This code was used to create the ep model image. Since we don't want to include \n# the resulting png file in the package for file size reasons it was uploaded to\n# the nflfastR repo and embedded remotely with the next chunk\n\nlibrary(tidyverse)\n\ndf <- nflreadr::load_pbp(2014:2019) |>\n filter(!is.na(posteam) & !is.na(ep), !is.na(down)) |>\n select(ep, down, yardline_100, air_yards, pass_location, cp)\n\ndf |>\n ggplot(aes(x = yardline_100, y = ep, color = as.factor(down))) + \n geom_smooth(size = 2) + \n labs(x = \"Yards from opponent's end zone\",\n y = \"Expected points value\",\n color = \"Down\",\n title = \"Expected Points by Yardline and Down\") +\n theme_bw() + \n scale_y_continuous(expand=c(0,0), breaks = scales::pretty_breaks(10)) + \n scale_x_continuous(expand=c(0,0), breaks = seq(from = 5, to = 95, by = 10)) +\n theme(\n plot.title = element_text(size = 18, hjust = 0.5),\n plot.subtitle = element_text(size = 16, hjust = 0.5),\n axis.title = element_text(size = 18),\n axis.text = element_text(size = 16),\n legend.text = element_text(size = 16),\n legend.title = element_text(size = 16),\n legend.position = c(.90, .80)) +\n annotate(\"text\", x = 14, y = -2.2, size = 3, label = \"2014-2019 | Model: @nflfastR\")\n```\n\n```{r echo=FALSE, fig.align='center', fig.cap='', out.width='100%'}\nknitr::include_graphics('man/figures/readme-epa-model-1.png')\n```\n\nHere is a visualization of the Completion Probability model by air yards and pass direction.\n\n``` {r cp-model, warning = FALSE, message = FALSE, results = 'hide', fig.keep = 'all', dpi = 600, echo=FALSE, eval = FALSE}\n\n# This code was used to create the cp model image. Since we don't want to include \n# the resulting png file in the package for file size reasons it was uploaded to\n# the nflfastR repo and embedded remotely with the next chunk\n\ndf |>\n filter(!is.na(cp), between(air_yards, -5, 45)) |>\n mutate(pass_middle = if_else(pass_location == \"middle\", \"Yes\", \"No\")) |>\n ggplot(aes(x = air_yards, y = cp, color = as.factor(pass_middle))) + \n geom_smooth(size = 2) + \n labs(x = \"Air yards\",\n y = \"Expected completion %\",\n color = \"Pass middle\",\n title = \"Expected Completion % by Air Yards and Pass Direction\") +\n theme_bw() + \n scale_y_continuous(expand=c(0,0), breaks = scales::pretty_breaks(5)) + \n scale_x_continuous(expand=c(0,0)) +\n theme(\n plot.title = element_text(size = 18, hjust = 0.5),\n plot.subtitle = element_text(size = 16, hjust = 0.5),\n axis.title = element_text(size = 18),\n axis.text = element_text(size = 16),\n legend.text = element_text(size = 16),\n legend.title = element_text(size = 16),\n legend.position = c(.80, .80)) +\n annotate(\"text\", x = 2, y = .32, size = 3, label = \"2014-2019 | Model: @nflfastR\")\n```\n\n```{r echo=FALSE, fig.align='center', fig.cap='', out.width='100%'}\nknitr::include_graphics('man/figures/readme-cp-model-1.png')\n```\n\n`nflfastR` includes two win probability models: one with and one without incorporating the pre-game spread.\n\n## Special thanks\n\n* To Nick Shoemaker for [finding and making available JSON-formatted NFL play-by-play back to 1999](https://github.com/CroppedClamp/nfl_pbps) (`nflfastR` uses this source for 1999 and 2000 and previously also used it for 2001-2010)\n* To Lau Sze Yui for developing a scraping function to access JSON-formatted NFL play-by-play beginning in 2001\n* To Aaron Schatz and FTN Fantasy for providing charting data to correctly mark scrambles in the 1999-2005 seasons\n* To Lee Sharpe for curating a resource for game information\n* To Timo Riske, Lau Sze Yui, Sean Clement, and Daniel Houston for many helpful discussions regarding the development of the new `nflfastR` models\n* To Zach Feldman and Josh Hermsmeyer for many helpful discussions about CPOE models as well as Peter Owen for many helpful suggestions for the CP model\n* To Florian Schmitt for the logo design\n* The many users who found and reported bugs in `nflfastR` 1.0\n* And of course, the original [`nflscrapR`](https://github.com/maksimhorowitz/nflscrapR) team, Maksim Horowitz, Ronald Yurko, and Samuel Ventura, whose work represented a dramatic step forward for the state of public NFL research\n"
},
{
"path": "README.md",
"content": "\n\n\n# **nflfastR** \n\n\n\n[](https://CRAN.R-project.org/package=nflfastR)\n[](https://CRAN.R-project.org/package=nflfastR)\n[](https://nflfastr.com/)\n[](https://github.com/nflverse/nflfastR/actions)\n[](https://lifecycle.r-lib.org/articles/stages.html#stable)\n[](https://discord.com/invite/5Er2FBnnQa)\n\n\n\n`nflfastR` is a set of functions to efficiently scrape NFL play-by-play\ndata. `nflfastR` expands upon the features of nflscrapR:\n\n- The package contains NFL play-by-play data back to 1999\n- As suggested by the package name, it obtains games **much** faster\n- Includes completion probability (`cp`), completion percentage over\n expected (`cpoe`), and expected yards after the catch (`xyac_epa` and\n `xyac_mean_yardage`) in play-by-play going back to 2006\n- Includes drive information, including drive starting position and\n drive result\n- Includes series information, including series number and series\n success\n- Hosts [a release of play-by-play data going back to\n 1999](https://github.com/nflverse/nflverse-data/releases/tag/pbp) for\n very quick access\n- Features models for Expected Points, Win Probability, Completion\n Probability, and Yards After the Catch (see section below)\n- Includes a function `update_db()` that creates and updates a database\n\nWe owe a debt of gratitude to the original\n[`nflscrapR`](https://github.com/maksimhorowitz/nflscrapR) team, Maksim\nHorowitz, Ronald Yurko, and Samuel Ventura, without whose contributions\nand inspiration this package would not exist.\n\n## Installation\n\nThe easiest way to get nflfastR is to install it from\n[CRAN](https://cran.r-project.org/package=nflfastR) with:\n\n``` r\ninstall.packages(\"nflfastR\")\n```\n\nTo get a bug fix or to use a feature from the development version, you\ncan install the development version of nflfastR either from\n[GitHub](https://github.com/nflverse/nflfastR/) with:\n\n``` r\nif (!require(\"pak\")) install.packages(\"pak\")\npak::pak(\"nflverse/nflfastR\")\n```\n\nor prebuilt from the [development repo](https://nflverse.r-universe.dev)\nwith:\n\n``` r\ninstall.packages(\"nflfastR\", repos = c(\"https://nflverse.r-universe.dev\", getOption(\"repos\")))\n```\n\n## Usage\n\nWe have provided some application examples in the **[Getting\nStarted](https://nflfastr.com/articles/nflfastR.html)** article.\nHowever, these require a basic knowledge of R. For this reason we have\nthe **[nflfastR beginner’s\nguide](https://nflfastr.com/articles/beginners_guide.html)**, which we\nrecommend to all those who are looking for an introduction to nflfastR\nwith R.\n\nYou can find column names and descriptions in the **[Field\nDescriptions](https://nflfastr.com/articles/field_descriptions.html)**\narticle, or by accessing the `field_descriptions` dataframe from the\npackage.\n\n## Data access\n\nEven though `nflfastR` is very fast, **we recommend downloading the data\nfrom [here](https://github.com/nflverse/nflverse-data/releases/tag/pbp)\nor using the `nflreadr` package**. These data sets include play-by-play\ndata of complete seasons going back to 1999 and are updated nightly\nduring the season. The files contain both regular season and postseason\ndata, and one can use game_type or week to figure out which games\noccurred in the postseason.\n\n## nflfastR models\n\n`nflfastR` uses its own models for Expected Points, Win Probability,\nCompletion Probability, and Expected Yards After the Catch. To read\nabout the models, please see [this post on Open Source\nFootball](https://opensourcefootball.com/posts/2020-09-28-nflfastr-ep-wp-and-cp-models/).\nFor a more detailed description of the motivation for Expected Points\nmodels, we highly recommend this paper [from the nflscrapR team located\nhere](https://arxiv.org/pdf/1802.00998).\n\nHere is a visualization of the Expected Points model by down and\nyardline.\n\n![\"\"](\"man/figures/readme-epa-model-1.png\")
\n\nHere is a visualization of the Completion Probability model by air yards\nand pass direction.\n\n![\"\"](\"man/figures/readme-cp-model-1.png\")
\n\n`nflfastR` includes two win probability models: one with and one without\nincorporating the pre-game spread.\n\n## Special thanks\n\n- To Nick Shoemaker for [finding and making available JSON-formatted NFL\n play-by-play back to 1999](https://github.com/CroppedClamp/nfl_pbps)\n (`nflfastR` uses this source for 1999 and 2000 and previously also\n used it for 2001-2010)\n- To Lau Sze Yui for developing a scraping function to access\n JSON-formatted NFL play-by-play beginning in 2001\n- To Aaron Schatz and FTN Fantasy for providing charting data to\n correctly mark scrambles in the 1999-2005 seasons\n- To Lee Sharpe for curating a resource for game information\n- To Timo Riske, Lau Sze Yui, Sean Clement, and Daniel Houston for many\n helpful discussions regarding the development of the new `nflfastR`\n models\n- To Zach Feldman and Josh Hermsmeyer for many helpful discussions about\n CPOE models as well as Peter Owen for many helpful suggestions for the\n CP model\n- To Florian Schmitt for the logo design\n- The many users who found and reported bugs in `nflfastR` 1.0\n- And of course, the original\n [`nflscrapR`](https://github.com/maksimhorowitz/nflscrapR) team,\n Maksim Horowitz, Ronald Yurko, and Samuel Ventura, whose work\n represented a dramatic step forward for the state of public NFL\n research\n"
},
{
"path": "air.toml",
"content": ""
},
{
"path": "cran-comments.md",
"content": "## Release summary\n\nThis is a minor release that \n* deprecates old functions, and\n* fixes bugs.\n\n## R CMD check results\n\n0 errors | 0 warnings | 0 notes\n\n## revdepcheck results\n\nWe checked 3 reverse dependencies, comparing R CMD check results across CRAN and dev versions of this package.\n\n * We saw 0 new problems\n * We failed to check 0 packages\n"
},
{
"path": "data-raw/MODELS.R",
"content": "################################################################################\n# Author: Ben Baldwin\n# Purpose: Estimate nflfastR models for EP, CP, Field Goals, and WP\n################################################################################\n\nlibrary(tidyverse)\nlibrary(xgboost)\nsource('R/helper_add_ep_wp.R')\nsource('R/helper_add_cp_cpoe.R')\nsource('R/helper_add_nflscrapr_mutations.R')\n\n\n################################################################################\n# Estimate EP model\n################################################################################\n\n# from remote\n# pbp_data <- readRDS(url('https://github.com/nflverse/nflfastR-data/blob/master/models/cal_data.rds?raw=true'))\n\n# from local\npbp_data <- readRDS('../nflfastR-data/models/cal_data.rds')\n\n#function in helper_add_ep_wp.R\nmodel_data <- pbp_data |>\n make_model_mutations() |>\n mutate(\n label = case_when(\n Next_Score_Half == \"Touchdown\" ~ 0,\n Next_Score_Half == \"Opp_Touchdown\" ~ 1,\n Next_Score_Half == \"Field_Goal\" ~ 2,\n Next_Score_Half == \"Opp_Field_Goal\" ~ 3,\n Next_Score_Half == \"Safety\" ~ 4,\n Next_Score_Half == \"Opp_Safety\" ~ 5,\n Next_Score_Half == \"No_Score\" ~ 6\n ),\n label = as.factor(label),\n # Calculate the drive difference between the next score drive and the\n # current play drive:\n Drive_Score_Dist = Drive_Score_Half - drive,\n # Create a weight column based on difference in drives between play and next score:\n Drive_Score_Dist_W = (max(Drive_Score_Dist) - Drive_Score_Dist) /\n (max(Drive_Score_Dist) - min(Drive_Score_Dist)),\n # Create a weight column based on score differential:\n ScoreDiff_W = (max(abs(score_differential), na.rm = T) -\n abs(score_differential)) /\n (max(abs(score_differential), na.rm = T) -\n min(abs(score_differential), na.rm = T)),\n # Add these weights together and scale again:\n Total_W = Drive_Score_Dist_W + ScoreDiff_W,\n Total_W_Scaled = (Total_W - min(Total_W, na.rm = T)) /\n (max(Total_W, na.rm = T) - min(Total_W, na.rm = T))\n ) |>\n filter(\n !is.na(defteam_timeouts_remaining),\n !is.na(posteam_timeouts_remaining),\n !is.na(yardline_100)\n ) |>\n select(\n label,\n half_seconds_remaining,\n yardline_100,\n home,\n retractable,\n dome,\n outdoors,\n ydstogo,\n era0,\n era1,\n era2,\n era3,\n era4,\n down1,\n down2,\n down3,\n down4,\n posteam_timeouts_remaining,\n defteam_timeouts_remaining,\n Total_W_Scaled\n )\n\nnrounds = 525\nparams <-\n list(\n booster = \"gbtree\",\n objective = \"multi:softprob\",\n eval_metric = c(\"mlogloss\"),\n num_class = 7,\n eta = 0.025,\n gamma = 1,\n subsample = 0.8,\n colsample_bytree = 0.8,\n max_depth = 5,\n min_child_weight = 1\n )\n\nmodel_data <- model_data |>\n mutate(label = as.numeric(label), label = label - 1)\n\nfull_train = xgboost::xgb.DMatrix(\n model.matrix(~ . + 0, data = model_data |> select(-label, -Total_W_Scaled)),\n label = model_data$label,\n weight = model_data$Total_W_Scaled\n)\n\nset.seed(2013) #GoHawks\nep_model <- xgboost::xgboost(\n params = params,\n data = full_train,\n nrounds = nrounds,\n verbose = 2\n)\n\n################################################################################\n# Estimate FG model\n################################################################################\n\nfg_model_data <- pbp_data |>\n filter(\n play_type %in%\n c(\"field_goal\", \"extra_point\", \"run\") &\n (!is.na(extra_point_result) | !is.na(field_goal_result))\n ) |>\n make_model_mutations()\n\n#estimate model\nfg_model <- mgcv::bam(\n sp ~ s(yardline_100, by = interaction(era, model_roof)) + model_roof + era,\n data = fg_model_data,\n family = \"binomial\"\n)\n\n################################################################################\n# Estimate CP model\n################################################################################\n\nmodel_vars <- pbp_data |>\n filter(season >= 2006) |>\n make_model_mutations() |>\n prepare_cp_data() |>\n filter(valid_pass == 1) |>\n select(-valid_pass)\n\nnrounds = 560\nparams <-\n list(\n booster = \"gbtree\",\n objective = \"binary:logistic\",\n eval_metric = c(\"logloss\"),\n eta = 0.025,\n gamma = 5,\n subsample = 0.8,\n colsample_bytree = 0.8,\n max_depth = 4,\n min_child_weight = 6,\n base_score = mean(model_vars$complete_pass)\n )\n\nfull_train = xgboost::xgb.DMatrix(\n model.matrix(~ . + 0, data = model_vars |> dplyr::select(-complete_pass)),\n label = model_vars$complete_pass\n)\nset.seed(2013) #GoHawks\ncp_model <- xgboost::xgboost(\n params = params,\n data = full_train,\n nrounds = nrounds,\n verbose = 2\n)\n\n\n################################################################################\n# Estimate WP model: spread\n################################################################################\n\nmodel_data <-\n readRDS(url(\n 'https://github.com/guga31bb/metrics/blob/master/wp_tuning/cal_data.rds?raw=true'\n )) |>\n filter(Winner != \"TIE\") |>\n make_model_mutations() |>\n prepare_wp_data() |>\n mutate(label = ifelse(posteam == Winner, 1, 0)) |>\n filter(\n qtr <= 4 &\n !is.na(ep) &\n !is.na(score_differential) &\n !is.na(play_type) &\n !is.na(label),\n !is.na(yardline_100)\n ) |>\n select(\n label,\n receive_2h_ko,\n spread_time,\n home,\n half_seconds_remaining,\n game_seconds_remaining,\n Diff_Time_Ratio,\n score_differential,\n down,\n ydstogo,\n yardline_100,\n posteam_timeouts_remaining,\n defteam_timeouts_remaining\n )\n\n\nnrounds = 534\nparams <-\n list(\n booster = \"gbtree\",\n objective = \"binary:logistic\",\n eval_metric = c(\"logloss\"),\n eta = 0.05,\n gamma = .79012017,\n subsample = 0.9224245,\n colsample_bytree = 5 / 12,\n max_depth = 5,\n min_child_weight = 7,\n monotone_constraints = \"(0, 0, 0, 0, 0, 1, 1, -1, -1, -1, 1, -1)\"\n )\n\n\nfull_train = xgboost::xgb.DMatrix(\n model.matrix(~ . + 0, data = model_data |> select(-label)),\n label = model_data$label\n)\nset.seed(2013) #GoHawks\nwp_model_spread <- xgboost::xgboost(\n params = params,\n data = full_train,\n nrounds = nrounds,\n verbose = 2\n)\n\nimportance <- xgboost::xgb.importance(\n feature_names = colnames(wp_model_spread),\n model = wp_model_spread\n)\nxgboost::xgb.ggplot.importance(importance_matrix = importance)\n\n#xgboost::xgb.plot.tree(model = wp_model_spread, trees = 1, show_node_id = TRUE)\n\n################################################################################\n# Estimate WP model: no spread\n################################################################################\n\nmodel_data <- model_data |>\n select(\n -spread_time\n )\n\nnrounds = 65\nparams <-\n list(\n booster = \"gbtree\",\n objective = \"binary:logistic\",\n eval_metric = c(\"logloss\"),\n eta = 0.2,\n gamma = 0,\n subsample = 0.8,\n colsample_bytree = 0.8,\n max_depth = 4,\n min_child_weight = 1\n )\n\n\nfull_train = xgboost::xgb.DMatrix(\n model.matrix(~ . + 0, data = model_data |> select(-label)),\n label = model_data$label\n)\nset.seed(2013) #GoHawks\nwp_model <- xgboost::xgboost(\n params = params,\n data = full_train,\n nrounds = nrounds,\n verbose = 2\n)\n\n\n################################################################################\n# save models to use in package\n################################################################################\n\nusethis::use_data(\n ep_model,\n wp_model,\n wp_model_spread,\n fg_model,\n cp_model,\n internal = TRUE,\n overwrite = TRUE\n)\n"
},
{
"path": "data-raw/_tune_spread_wp.R",
"content": "library(tidyverse)\nlibrary(tidymodels)\nsource('R/helper_add_ep_wp.R')\nsource('R/helper_add_nflscrapr_mutations.R')\n\nset.seed(2013)\n\nmodel_data <-\n # readRDS('data-raw/cal_data.rds') |>\n readRDS(url(\n 'https://github.com/nflverse/nflfastR-data/blob/master/models/cal_data.rds?raw=true'\n )) |>\n filter(Winner != \"TIE\") |>\n make_model_mutations() |>\n prepare_wp_data() |>\n mutate(label = ifelse(posteam == Winner, 1, 0)) |>\n filter(\n !is.na(ep) &\n !is.na(score_differential) &\n !is.na(play_type) &\n !is.na(label) &\n !is.na(yardline_100),\n qtr <= 4\n ) |>\n select(\n label,\n receive_2h_ko,\n spread_time,\n home,\n half_seconds_remaining,\n game_seconds_remaining,\n ExpScoreDiff_Time_Ratio,\n score_differential,\n # ep,\n down,\n ydstogo,\n yardline_100,\n posteam_timeouts_remaining,\n defteam_timeouts_remaining,\n season\n )\n\n\nfolds <- map(0:9, function(x) {\n f <- which(model_data$season %in% c(2000 + x, 2010 + x))\n return(f)\n})\n\n\nfull_train = xgboost::xgb.DMatrix(\n model.matrix(~ . + 0, data = model_data |> select(-label, -season)),\n label = model_data$label\n)\n\n#params\nnrounds = 5000\n\n\n# #################################################################################\n# try tidymodels\n\ngrid <- grid_latin_hypercube(\n finalize(mtry(), model_data),\n min_n(),\n tree_depth(),\n learn_rate(),\n loss_reduction(),\n sample_size = sample_prop(),\n size = 20\n)\n\ngrid <- grid |>\n mutate(\n # it was making dumb learn rates\n learn_rate = .1 * ((1:nrow(grid)) / nrow(grid)),\n # has to be between 0 and 1\n mtry = mtry / length(model_data)\n )\n\n# bonus round at the end: do more searching after finding good ones\ngrid <- grid |>\n head(6) |>\n mutate(\n learn_rate = c(0.01, 0.02, .03, .04, .05, .06),\n min_n = 14,\n tree_depth = 5,\n mtry = 0.5714286,\n loss_reduction = 3.445502e-01,\n sample_size = 0.7204741\n )\n\ngrid\n\n# function to search over hyperparameter grid\nget_metrics <- function(df, row = 1) {\n # testing only\n # df <- grid |> dplyr::slice(1)\n\n params <-\n list(\n booster = \"gbtree\",\n objective = \"binary:logistic\",\n eval_metric = c(\"logloss\"),\n eta = df$learn_rate,\n gamma = df$loss_reduction,\n subsample = df$sample_size,\n colsample_bytree = df$mtry,\n max_depth = df$tree_depth,\n min_child_weight = df$min_n\n )\n\n #train\n wp_cv_model <- xgboost::xgb.cv(\n data = full_train,\n params = params,\n nrounds = nrounds,\n folds = folds,\n metrics = list(\"logloss\"),\n early_stopping_rounds = 10,\n print_every_n = 10\n )\n\n output <- params\n output$iter = wp_cv_model$best_iteration\n output$logloss = wp_cv_model$evaluation_log[output$iter]$test_logloss_mean\n output$error = wp_cv_model$evaluation_log[output$iter]$test_error_mean\n\n this_param <- bind_rows(output)\n\n if (row == 1) {\n saveRDS(this_param, \"data-raw/modeling.rds\")\n } else {\n prev <- readRDS(\"data-raw/modeling.rds\")\n for_save <- bind_rows(prev, this_param)\n saveRDS(for_save, \"data-raw/modeling.rds\")\n }\n\n return(this_param)\n}\n\n# get results\nresults <- map_df(1:nrow(grid), function(x) {\n message(glue::glue(\"Row {x}\"))\n get_metrics(grid |> dplyr::slice(x), row = x)\n})\n\n# plot\nresults |>\n select(\n logloss,\n eta,\n gamma,\n subsample,\n colsample_bytree,\n max_depth,\n min_child_weight\n ) |>\n pivot_longer(\n eta:min_child_weight,\n values_to = \"value\",\n names_to = \"parameter\"\n ) |>\n ggplot(aes(value, logloss, color = parameter)) +\n geom_point(alpha = 0.8, show.legend = FALSE, size = 3) +\n facet_wrap(~parameter, scales = \"free_x\") +\n labs(x = NULL, y = \"logloss\") +\n theme_minimal()\n\n# final best model\n#\n# eta 0.02\n# gamma 0.3445502\n# subsample 0.7204741\n# colsample_bytree 0.5714286\n# max_depth 5\n# min_child_weight 14\n# iter 760\n# logloss 0.4485878\n\n# https://parsnip.tidymodels.org/reference/boost_tree.html\n# https://xgboost.readthedocs.io/en/latest/parameter.html\n"
},
{
"path": "data-raw/build_scramble_fix.R",
"content": "library(tidyverse)\n\npbp <- nflfastR::load_pbp(1999:2005) |>\n # plays that could plausibly be scramble\n filter(\n !is.na(rusher_player_id) | penalty == 1,\n is.na(passer_player_id),\n is.na(receiver_player_id)\n ) |>\n select(\n season,\n game_id,\n play_id,\n week,\n away_team,\n home_team,\n posteam,\n qtr,\n down,\n ydstogo,\n time,\n desc\n ) |>\n # not in scramble data this year\n mutate(\n time = case_when(\n nchar(time) == 3 ~ paste0(\"00\", time),\n nchar(time) == 4 ~ paste0(\"0\", time),\n TRUE ~ time\n )\n )\n\n# Thank you to Aaron Schatz and Football Outsiders\n# For the charting data to fix scrambles in 2005\ns <- readxl::read_xlsx(\"data-raw/scrambles_2005.xlsx\") |>\n as_tibble() |>\n janitor::clean_names() |>\n select(\n season = year,\n week,\n qtr,\n away_team = away,\n home_team = home,\n posteam = offense,\n down,\n ydstogo = togo,\n date_time = time\n )\n\n# Thank you to Aaron Schatz\n# For the charting data to fix scrambles in 1999 - 2004\ns2 <- readxl::read_xlsx(\n \"data-raw/Scrambles 1999-2004 UPDATE for NFLfastR.xlsx\",\n sheet = 1\n) |>\n as_tibble() |>\n janitor::clean_names() |>\n filter(type %in% c(\"scramble\", \"assume scramble\")) |>\n select(\n season = year,\n week,\n qtr,\n away_team = away,\n home_team = home,\n posteam = offense,\n down,\n ydstogo = togo,\n date_time = time,\n yards_gained = yards\n )\n# s3 is a correction. the plays are in s3 should be rushes and therefore excluded from scramble_fix\n# see #475\ns3 <- readxl::read_xlsx(\n \"data-raw/Scrambles.1999-2003.FURTHER.UPDATE.for.NFLfastR.xlsx\",\n sheet = 1\n) |>\n as_tibble() |>\n janitor::clean_names() |>\n select(\n season = year,\n week,\n qtr,\n away_team = away,\n home_team = home,\n posteam = offense,\n down,\n ydstogo = togo,\n date_time = time,\n yards_gained = yards\n ) |>\n mutate(\n time = paste0(\n formatC(lubridate::hour(date_time), width = 2, flag = \"0\"),\n \":\",\n formatC(lubridate::minute(date_time), width = 2, flag = \"0\")\n )\n ) |>\n select(-date_time) |>\n mutate_at(vars(home_team, away_team, posteam), nflfastR:::team_name_fn) |>\n dplyr::left_join(\n pbp,\n by = c(\n \"week\",\n \"away_team\",\n \"home_team\",\n \"posteam\",\n \"qtr\",\n \"down\",\n \"ydstogo\",\n \"time\",\n \"season\"\n )\n ) |>\n mutate(no_scramble_id = paste0(game_id, \"_\", play_id))\n\ndat <- bind_rows(\n s2,\n s\n) |>\n mutate(\n time = paste0(\n formatC(lubridate::hour(date_time), width = 2, flag = \"0\"),\n \":\",\n formatC(lubridate::minute(date_time), width = 2, flag = \"0\")\n )\n ) |>\n select(-date_time) |>\n mutate_at(vars(home_team, away_team, posteam), nflfastR:::team_name_fn)\n\nd <- dat |>\n dplyr::left_join(\n pbp,\n by = c(\n \"week\",\n \"away_team\",\n \"home_team\",\n \"posteam\",\n \"qtr\",\n \"down\",\n \"ydstogo\",\n \"time\",\n \"season\"\n )\n ) |>\n mutate(scramble_id = paste0(game_id, \"_\", play_id)) |>\n filter(scramble_id != \"2005_09_CIN_BAL_1725\") |>\n filter(!scramble_id %in% s3$no_scramble_id)\n\n# number non-matched by season\nnrow(d)\nd |> filter(is.na(desc)) |> group_by(season) |> summarise(n = n())\n\n# get rid of non-match\nd <- d |>\n filter(!is.na(desc))\nd |> group_by(season) |> summarise(n = n())\n\nscramble_fix <- d$scramble_id\nscramble_fix <- scramble_fix |>\n unique()\nlength(scramble_fix)\nsaveRDS(scramble_fix, file = \"data-raw/scramble_fix.rds\")\n"
},
{
"path": "data-raw/build_stat_id_df.R",
"content": "stat_ids <- \"https://www.nflgsis.com/gsis/Documentation/Partners/StatIDs_files/sheet001.html\" |>\n xml2::read_html() |>\n rvest::html_table(fill = TRUE) |>\n as.data.frame() |>\n dplyr::rename(\"stat_id\" = X1, \"name\" = X2, \"comment\" = X3) |>\n dplyr::select(1:3) |>\n dplyr::slice(-1) |>\n dplyr::mutate(stat_id = as.integer(stat_id)) |>\n dplyr::filter(!is.na(stat_id)) |>\n dplyr::group_by(stat_id, name) |>\n dplyr::summarise(comment = paste0(comment, collapse = \" \")) |>\n dplyr::ungroup() |>\n dplyr::mutate(comment = stringr::str_squish(comment))\n\nusethis::use_data(stat_ids, overwrite = TRUE)\n"
},
{
"path": "data-raw/compare_dfs.R",
"content": "library(tidyverse)\nfuture::plan(\"multisession\")\n\n# function for comparing revisions against data in repo\n# make sure to build package first\ncompare_pbp <- function(id, cols) {\n s <- substr(id[1], 1, 4) |> as.integer()\n # no idea why this is necessary\n games <- id\n\n new_pbp <- build_nflfastR_pbp(\n id\n # comment this out to use the \"normal\" way\n # , dir = \"../nflfastR-raw/raw\"\n ) |>\n filter(!stringr::str_detect(desc, \"GAME\")) |>\n select(all_of(cols)) |>\n # necessary to pass the equality checks\n mutate(\n ep = round(ep, 2),\n epa = round(epa, 2),\n vegas_home_wp = round(vegas_home_wp, 2),\n vegas_home_wpa = round(vegas_home_wpa, 2),\n home_wp = round(home_wp, 2)\n )\n\n repo_pbp <- readRDS(url(glue::glue(\n \"https://raw.githubusercontent.com/guga31bb/nflfastR-data/master/data/play_by_play_{s}.rds\"\n ))) |>\n filter(game_id %in% games) |>\n filter(!stringr::str_detect(desc, \"GAME\")) |>\n select(all_of(cols)) |>\n mutate(\n ep = round(ep, 2),\n epa = round(epa, 2),\n vegas_home_wp = round(vegas_home_wp, 2),\n vegas_home_wpa = round(vegas_home_wpa, 2),\n home_wp = round(home_wp, 2)\n )\n\n sum <- arsenal::diffs(arsenal::comparedf(\n new_pbp |> select(-desc, -game_id, -play_id),\n repo_pbp |> select(-desc, -game_id, -play_id)\n ))\n dfs <- bind_cols(\n new_pbp |> select(-desc, -game_id, -play_id),\n repo_pbp |> select(-desc, -game_id, -play_id)\n )\n\n dfs$desc <- new_pbp$desc\n dfs$play_id <- new_pbp$play_id\n dfs$game_id <- new_pbp$game_id\n\n return(\n list(sum, dfs)\n )\n}\n\ncols <- c(\n # DO NOT REMOVE THESE ONES OR THE COMPARISON WILL BREAK\n \"game_id\",\n \"play_id\",\n \"desc\",\n \"ep\",\n \"epa\",\n \"vegas_home_wp\",\n \"vegas_home_wpa\",\n \"home_wp\"\n\n # here is stuff you can choose whether to include\n # , \"posteam_timeouts_remaining\", \"defteam_timeouts_remaining\"\n)\n\nid <- \"2002_05_PHI_JAX\"\nid <- \"2006_01_MIA_PIT\"\nid <- \"2006_02_PIT_JAX\"\nid <- \"2017_08_LAC_NE\"\nid <- \"2006_04_JAX_WAS\"\nid <- \"2019_01_SF_TB\"\nid <- \"2017_12_JAX_ARI\"\n\nids <- nflfastR::fast_scraper_schedules(2020) |>\n dplyr::slice(1:20) |>\n pull(game_id)\n\ncompared <- compare_pbp(\n id = ids,\n cols = cols\n)\n\n# summary table\ncompared[[1]]\n\n# get row numbers of things with differences\nobs <- compared[[1]]$..row.names.. |> unique()\n\n# dfs\ncompared[[2]] |> arrange(play_id)\n\n# dfs with differences\ncompared[[2]][obs, ] |> arrange(play_id)\n\n# play description of plays with differences\ncompared[[2]][obs, ] |> arrange(play_id) |> select(desc)\n"
},
{
"path": "data-raw/create_field_descriptions.R",
"content": "library(dplyr)\nlibrary(tidyr)\nlibrary(stringr)\nlibrary(usethis)\n\nx <- readLines(\"data-raw/variable_list.txt\")\n\nfield_descriptions <- tibble(x = x) |>\n separate(x, \"{\", into = c(NA, \"Field\", \"Description\")) |>\n mutate_all(str_remove_all, \"\\\\}\")\n\nusethis::use_data(field_descriptions, overwrite = TRUE)\n# save(field_descriptions, file = \"vignettes/field_descriptions.rda\")\n"
},
{
"path": "data-raw/default_play.R",
"content": "### Create datatype dataframe\n### This is a db that is stored on Seb's local machine\nconnection <- DBI::dbConnect(duckdb::duckdb(), \"../_data_cache/pbp_db\")\npbp_db <- dplyr::tbl(connection, \"nflfastR_pbp\")\n\n### This is heavy, only run if necessary\nsk <- pbp_db |>\n dplyr::collect() |>\n skimr::skim()\n\nreadr::write_csv(sk, \"data-raw/pbp_datatypes.csv\")\n\nsk <- readr::read_csv(\"data-raw/pbp_datatypes.csv\")\n\nrandom_play <- pbp_db |>\n dplyr::filter(season == 1999) |>\n dplyr::collect() |>\n dplyr::slice_sample(n = 1) |>\n as.list()\n\ndefault_play <-\n purrr::map(\n seq_along(random_play),\n function(i, play, sk) {\n val <- play[[i]]\n var <- names(play[i])\n if (is.character(val)) {\n max_char <- sk$character.max[sk$skim_variable == var]\n rnd_char <- ifelse(is.na(val), 0L, nchar(val))\n if (is.na(max_char)) {\n max_char <- switch(\n var,\n \"lateral_sack_player_id\" = 10L,\n \"lateral_sack_player_name\" = 20L,\n \"tackle_with_assist_2_player_id\" = 10L,\n \"tackle_with_assist_2_player_name\" = 20L,\n \"tackle_with_assist_2_team\" = 3L,\n \"drive_real_start_time\" = 20L\n )\n }\n if (max_char > rnd_char) {\n val <- strsplit(val, character(0L))[[1]] |>\n sample(size = max_char, replace = TRUE) |>\n paste0(collapse = \"\")\n }\n }\n val\n },\n play = random_play,\n sk = sk\n ) |>\n purrr::set_names(names(random_play)) |>\n tibble::as_tibble_row() |>\n dplyr::mutate(game_id = \"9999_99_DEF_TYP\")\n\nreadr::write_csv(default_play, \"data-raw/pbp_defaultplay.csv\")\nsaveRDS(default_play, \"data-raw/pbp_defaultplay.rds\")\n"
},
{
"path": "data-raw/nfl_stats_variables.R",
"content": "s1 <- calculate_stats(2023, \"season\", \"player\")\ns2 <- calculate_stats(2023, \"week\", \"player\")\ns3 <- calculate_stats(2023, \"season\", \"team\")\ns4 <- calculate_stats(2023, \"week\", \"team\")\n\nn1 <- names(s1)\nn2 <- names(s2)\nn3 <- names(s3)\nn4 <- names(s4)\n\nsetdiff(n1, n2)\nsetdiff(n2, n1)\n\nsetdiff(n1, n3)\nsetdiff(n3, n1)\n\n# tibble::tibble(\n# variable = c(n1, n2, n3, n4) |> unique(),\n# description = \"\"\n# ) |>\n# jsonlite::write_json(\"data-raw/nfl_stats_variables.json\", pretty = TRUE)\n\nnfl_stats_variables <- jsonlite::fromJSON(\"data-raw/nfl_stats_variables.json\")\n\nusethis::use_data(nfl_stats_variables, overwrite = TRUE)\n\ns_old_1 <- nflreadr::load_player_stats(2023, \"offense\")\ns_old_2 <- nflreadr::load_player_stats(2023, \"defense\")\ns_old_3 <- nflreadr::load_player_stats(2023, \"kicking\")\nn_old_1 <- names(s_old_1)\nn_old_2 <- names(s_old_2)\nn_old_3 <- names(s_old_3)\n\n\n# Differences to old offense stats ----------------------------------------\n\n# recent_team -> team (recent team in weekly data never made sense)\n# interceptions -> passing_interceptions (all passing stats have the passing prefix)\n# sacks -> sacks_suffered (to make clear it's not on defensive side)\n# sack_yards -> sack_yards_lost (to make clear it's not on defensive side)\n# dakota -> not implemented at the moment\nsetdiff(n_old_1, n2)\nsetdiff(n2, n_old_1)\n\n# Differences to old defense stats ----------------------------------------\n\n# def_tackles -> there is def_tackles_solo and def_tackles_with_assist\n# def_fumble_recovery_own -> fumble_recovery_own (it is not exclusive to defense)\n# def_fumble_recovery_yards_own -> fumble_recovery_yards_own (it is not exclusive to defense)\n# def_fumble_recovery_opp -> fumble_recovery_opp (it is not exclusive to defense)\n# def_fumble_recovery_yards_opp -> fumble_recovery_yards_opp (it is not exclusive to defense)\n# def_safety -> def_safeties (we use plural everywhere)\n# def_penalty -> penalties (it is not exclusive to defense)\n# def_penalty_yards -> penalty_yards (it is not exclusive to defense)\nsetdiff(n_old_2, n2)\nsetdiff(n2, n_old_2)\n\n\n# Differences to old kicking stats ----------------------------------------\n\n# No differences\nsetdiff(n_old_3, n2)\nsetdiff(n2, n_old_3)\n"
},
{
"path": "data-raw/nfl_stats_variables.json",
"content": "[\n {\n \"variable\": \"player_id\",\n \"description\": \"GSIS player ID. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"player_name\",\n \"description\": \"Short player name as listed in play-by-play data. Please keep in mind that this name is not always unique for one player and can change from season to season and sometimes even within a season. Do not group by this variable. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"player_display_name\",\n \"description\": \"Full name of player. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"position\",\n \"description\": \"Position of player. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"position_group\",\n \"description\": \"Position group of player. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"headshot_url\",\n \"description\": \"URL to a player headshot image. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"season\",\n \"description\": \"The NFL season\"\n },\n {\n \"variable\": \"week\",\n \"description\": \"The NFL week. Available if summary_level = 'week'\"\n },\n {\n \"variable\": \"season_type\",\n \"description\": \"One of 'REG', 'POST', or 'REG+POST'\"\n },\n {\n \"variable\": \"game_id\",\n \"description\": \"The nflverse game id of the form '{season}_{week}_{away abbreviation}_{home abbreviation}'. Available if summary_level = 'week'\"\n },\n {\n \"variable\": \"recent_team\",\n \"description\": \"Most recent team player appears in data with. Available if stat_type = 'player' & summary_level = 'season'.\"\n },\n {\n \"variable\": \"team\",\n \"description\": \"Team stats are counted for.\"\n },\n {\n \"variable\": \"opponent_team\",\n \"description\": \"The opponent team in that week. Available if summary_level = 'week'.\"\n },\n {\n \"variable\": \"games\",\n \"description\": \"The number of games where stats were counted. Available if summary_level = 'season'.\"\n },\n {\n \"variable\": \"completions\",\n \"description\": \"The number of completed passes.\"\n },\n {\n \"variable\": \"attempts\",\n \"description\": \"The number of pass attempts as defined by the NFL.\"\n },\n {\n \"variable\": \"passing_yards\",\n \"description\": \"Yards gained on pass plays.\"\n },\n {\n \"variable\": \"passing_tds\",\n \"description\": \"The number of passing touchdowns.\"\n },\n {\n \"variable\": \"passing_interceptions\",\n \"description\": \"The number of interceptions thrown.\"\n },\n {\n \"variable\": \"sacks_suffered\",\n \"description\": \"The Number of times sacked.\"\n },\n {\n \"variable\": \"sack_yards_lost\",\n \"description\": \"Yards lost on sack plays.\"\n },\n {\n \"variable\": \"sack_fumbles\",\n \"description\": \"The number of sacks with a fumble.\"\n },\n {\n \"variable\": \"sack_fumbles_lost\",\n \"description\": \"The number of sacks with a lost fumble.\"\n },\n {\n \"variable\": \"passing_air_yards\",\n \"description\": \"Passing air yards (includes incomplete passes).\"\n },\n {\n \"variable\": \"passing_yards_after_catch\",\n \"description\": \"Yards after the catch gained on plays in which player was the passer (this is an unofficial stat and may differ slightly between different sources).\"\n },\n {\n \"variable\": \"passing_first_downs\",\n \"description\": \"First downs on pass attempts.\"\n },\n {\n \"variable\": \"passing_epa\",\n \"description\": \"Total expected points added on pass attempts and sacks. NOTE: this uses the variable `qb_epa`, which gives QB credit for EPA for up to the point where a receiver lost a fumble after a completed catch and makes EPA work more like passing yards on plays with fumbles.\"\n },\n {\n \"variable\": \"passing_cpoe\",\n \"description\": \"Completion percentage over expectation\"\n },\n {\n \"variable\": \"passing_2pt_conversions\",\n \"description\": \"Two-point conversion passes.\"\n },\n {\n \"variable\": \"pacr\",\n \"description\": \"Passing Air Conversion Ratio. PACR = `passing_yards` / `passing_air_yards`. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"passing_10\",\n \"description\": \"The number of passes that gained 10 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"passing_16\",\n \"description\": \"The number of passes that gained 16 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"passing_20\",\n \"description\": \"The number of passes that gained 20 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"passing_40\",\n \"description\": \"The number of passes that gained 40 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"carries\",\n \"description\": \"The number of official rush attempts (incl. scrambles and kneel downs). Rushes after a lateral reception don't count as carry.\"\n },\n {\n \"variable\": \"rushing_yards\",\n \"description\": \"Yards gained when rushing with the ball (incl. scrambles and kneel downs). Also includes yards gained after obtaining a lateral on a play that started with a rushing attempt.\"\n },\n {\n \"variable\": \"rushing_tds\",\n \"description\": \"The number of rushing touchdowns (incl. scrambles). Also includes touchdowns after obtaining a lateral on a play that started with a rushing attempt.\"\n },\n {\n \"variable\": \"rushing_fumbles\",\n \"description\": \"The number of rushes with a fumble.\"\n },\n {\n \"variable\": \"rushing_fumbles_lost\",\n \"description\": \"The number of rushes with a lost fumble.\"\n },\n {\n \"variable\": \"rushing_first_downs\",\n \"description\": \"First downs on rush attempts (incl. scrambles).\"\n },\n {\n \"variable\": \"rushing_epa\",\n \"description\": \"Expected points added on rush attempts (incl. scrambles and kneel downs).\"\n },\n {\n \"variable\": \"rushing_2pt_conversions\",\n \"description\": \"Two-point conversion rushes.\"\n },\n {\n \"variable\": \"rushing_10\",\n \"description\": \"The number of runs that gained 10 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"rushing_12\",\n \"description\": \"The number of runs that gained 12 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"rushing_20\",\n \"description\": \"The number of runs that gained 20 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"rushing_40\",\n \"description\": \"The number of runs that gained 40 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"receptions\",\n \"description\": \"The number of pass receptions. Lateral receptions officially don't count as reception.\"\n },\n {\n \"variable\": \"targets\",\n \"description\": \"The number of pass plays where the player was the targeted receiver.\"\n },\n {\n \"variable\": \"receiving_yards\",\n \"description\": \"Yards gained after a pass reception. Includes yards gained after receiving a lateral on a play that started as a pass play.\"\n },\n {\n \"variable\": \"receiving_tds\",\n \"description\": \"The number of touchdowns following a pass reception. Also includes touchdowns after receiving a lateral on a play that started as a pass play.\"\n },\n {\n \"variable\": \"receiving_fumbles\",\n \"description\": \"The number of fumbles after a pass reception.\"\n },\n {\n \"variable\": \"receiving_fumbles_lost\",\n \"description\": \"The number of fumbles lost after a pass reception.\"\n },\n {\n \"variable\": \"receiving_air_yards\",\n \"description\": \"Receiving air yards (incl. incomplete passes).\"\n },\n {\n \"variable\": \"receiving_yards_after_catch\",\n \"description\": \"Yards after the catch gained on plays in which player was receiver (this is an unofficial stat and may differ slightly between different sources).\"\n },\n {\n \"variable\": \"receiving_first_downs\",\n \"description\": \"First downs on receptions.\"\n },\n {\n \"variable\": \"receiving_epa\",\n \"description\": \"Expected points added on receptions.\"\n },\n {\n \"variable\": \"receiving_2pt_conversions\",\n \"description\": \"Two-point conversion receptions.\"\n },\n {\n \"variable\": \"receiving_10\",\n \"description\": \"The number of receptions that gained 10 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"receiving_16\",\n \"description\": \"The number of receptions that gained 16 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"receiving_20\",\n \"description\": \"The number of receptions that gained 20 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"receiving_40\",\n \"description\": \"The number of receptions that gained 40 or more yards. Some define this as an 'explosive' play.\"\n },\n {\n \"variable\": \"racr\",\n \"description\": \"Receiver Air Conversion Ratio. RACR = `receiving_yards` / `receiving_air_yards`. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"target_share\",\n \"description\": \"The share of targets of the player in all targets of his team. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"air_yards_share\",\n \"description\": \"The share of receiving_air_yards of the player in all air_yards of his team. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"wopr\",\n \"description\": \"Weighted Opportunity Rating. WOPR = 1.5 × `target_share` + 0.7 × `air_yards_share`. Available if stat_type = 'player'.\"\n },\n {\n \"variable\": \"special_teams_tds\",\n \"description\": \"The number of touchdowns scored in special teams plays.\"\n },\n {\n \"variable\": \"def_tackles_solo\",\n \"description\": \"Solo tackles.\"\n },\n {\n \"variable\": \"def_tackles_with_assist\",\n \"description\": \"Tackles where another player assisted.\"\n },\n {\n \"variable\": \"def_tackle_assists\",\n \"description\": \"Assist to another player's tackle.\"\n },\n {\n \"variable\": \"def_tackles_for_loss\",\n \"description\": \"Tackles for loss.\"\n },\n {\n \"variable\": \"def_tackles_for_loss_yards\",\n \"description\": \"Yards lost by the opposing team through a tackle.\"\n },\n {\n \"variable\": \"def_fumbles_forced\",\n \"description\": \"Forced fumbles.\"\n },\n {\n \"variable\": \"def_sacks\",\n \"description\": \"Number of Sacks.\"\n },\n {\n \"variable\": \"def_sack_yards\",\n \"description\": \"Yards lost by the opposing team through a sack.\"\n },\n {\n \"variable\": \"def_qb_hits\",\n \"description\": \"Number of QB hits\"\n },\n {\n \"variable\": \"def_interceptions\",\n \"description\": \"Interceptions caught.\"\n },\n {\n \"variable\": \"def_interception_yards\",\n \"description\": \"Yards gained after interceptions.\"\n },\n {\n \"variable\": \"def_pass_defended\",\n \"description\": \"Number of defended passes.\"\n },\n {\n \"variable\": \"def_tds\",\n \"description\": \"Defensive touchdowns.\"\n },\n {\n \"variable\": \"def_fumbles\",\n \"description\": \"Number of fumbles while playing on defense.\"\n },\n {\n \"variable\": \"def_safeties\",\n \"description\": \"Tackles that resulted in a safety.\"\n },\n {\n \"variable\": \"misc_yards\",\n \"description\": \"Yardage gained/lost that doesn't fall into any other category. Examples are blocked field goals or blocked punts.\"\n },\n {\n \"variable\": \"fumble_recovery_own\",\n \"description\": \"Recovered fumbles where the ball was fumbled by own team.\"\n },\n {\n \"variable\": \"fumble_recovery_yards_own\",\n \"description\": \"Yardage gained/lost by a player after he recovered a fumble by his own team. Includes yardage gained/lost where a team mate recovered a fumble and lateraled the ball to the player.\"\n },\n {\n \"variable\": \"fumble_recovery_opp\",\n \"description\": \"Recovered fumbles where the ball was fumbled by opposing team.\"\n },\n {\n \"variable\": \"fumble_recovery_yards_opp\",\n \"description\": \"Yardage gained/lost by a player after he recovered a fumble by the opposing team. Includes yardage gained/lost where a team mate recovered a fumble and lateraled the ball to the player.\"\n },\n {\n \"variable\": \"fumble_recovery_tds\",\n \"description\": \"Touchdowns scored after a fumble recovery. This can be in any unit. And both the own team and the opposing team can have fumbled the ball initially. Includes touchdowns where a team mate recovered a fumble and lateraled the ball to the player.\"\n },\n {\n \"variable\": \"penalties\",\n \"description\": \"Penalties caused.\"\n },\n {\n \"variable\": \"penalty_yards\",\n \"description\": \"Yardage lost through penalties.\"\n },\n {\n \"variable\": \"timeouts\",\n \"description\": \"Number of timeouts taken by team. Available if stat_type = 'team'.\"\n },\n {\n \"variable\": \"fumbles_forced_by_opp\",\n \"description\": \"The number of fumbles by the player. The fumble was forced by the opponent.\"\n },\n {\n \"variable\": \"fumbles_not_forced\",\n \"description\": \"The number of fumbles by the player. The fumble was NOT forced by the opponent.\"\n },\n {\n \"variable\": \"fumbles_out_of_bounds\",\n \"description\": \"The number of fumbles by the player, and the ball went out of bounds. The fumble may or may not have been forced.\"\n },\n {\n \"variable\": \"fumbles_total\",\n \"description\": \"The total number of fumbles by the player. Equals `fumbles_forced_by_opp` + `fumbles_not_forced`.\"\n },\n {\n \"variable\": \"fumbles_lost_total\",\n \"description\": \"The total number of fumbles lost by the player.\"\n },\n {\n \"variable\": \"punt_returns\",\n \"description\": \"Number of punts returned.\"\n },\n {\n \"variable\": \"punt_return_yards\",\n \"description\": \"Yardage gained/lost by a player during a punt return.\"\n },\n {\n \"variable\": \"kickoff_returns\",\n \"description\": \"Number of kickoffs returned.\"\n },\n {\n \"variable\": \"kickoff_return_yards\",\n \"description\": \"Yardage gained/lost by a player during a kickoff return.\"\n },\n {\n \"variable\": \"fg_made\",\n \"description\": \"Successful field goal attempts.\"\n },\n {\n \"variable\": \"fg_att\",\n \"description\": \"Attempted field goals.\"\n },\n {\n \"variable\": \"fg_missed\",\n \"description\": \"Missed field goals.\"\n },\n {\n \"variable\": \"fg_blocked\",\n \"description\": \"Attempted field goals that were blocked.\"\n },\n {\n \"variable\": \"fg_long\",\n \"description\": \"Distance of longest made field goal.\"\n },\n {\n \"variable\": \"fg_pct\",\n \"description\": \"Percentage of successful field goal attempts.\"\n },\n {\n \"variable\": \"fg_made_0_19\",\n \"description\": \"Successful field goal attempts where distance was between 0 and 19 yards.\"\n },\n {\n \"variable\": \"fg_made_20_29\",\n \"description\": \"Successful field goal attempts where distance was between 20 and 29 yards.\"\n },\n {\n \"variable\": \"fg_made_30_39\",\n \"description\": \"Successful field goal attempts where distance was between 30 and 39 yards.\"\n },\n {\n \"variable\": \"fg_made_40_49\",\n \"description\": \"Successful field goal attempts where distance was between 40 and 49 yards.\"\n },\n {\n \"variable\": \"fg_made_50_59\",\n \"description\": \"Successful field goal attempts where distance was between 50 and 59 yards.\"\n },\n {\n \"variable\": \"fg_made_60_\",\n \"description\": \"Successful field goal attempts where distance was 60+ yards.\"\n },\n {\n \"variable\": \"fg_missed_0_19\",\n \"description\": \"Missed field goal attempts where distance was between 0 and 19 yards.\"\n },\n {\n \"variable\": \"fg_missed_20_29\",\n \"description\": \"Missed field goal attempts where distance was between 20 and 29 yards.\"\n },\n {\n \"variable\": \"fg_missed_30_39\",\n \"description\": \"Missed field goal attempts where distance was between 30 and 39 yards.\"\n },\n {\n \"variable\": \"fg_missed_40_49\",\n \"description\": \"Missed field goal attempts where distance was between 40 and 49 yards.\"\n },\n {\n \"variable\": \"fg_missed_50_59\",\n \"description\": \"Missed field goal attempts where distance was between 50 and 59 yards.\"\n },\n {\n \"variable\": \"fg_missed_60_\",\n \"description\": \"Missed field goal attempts where distance was 60+ yards.\"\n },\n {\n \"variable\": \"fg_made_list\",\n \"description\": \"Distances of all successful field goal attempts.\"\n },\n {\n \"variable\": \"fg_missed_list\",\n \"description\": \"Distances of all missed field goal attempts.\"\n },\n {\n \"variable\": \"fg_blocked_list\",\n \"description\": \"Distances of all blocked field goal attempts.\"\n },\n {\n \"variable\": \"fg_made_distance\",\n \"description\": \"Sum of distances of all made field goals.\"\n },\n {\n \"variable\": \"fg_missed_distance\",\n \"description\": \"Sum of distances of all missed field goals.\"\n },\n {\n \"variable\": \"fg_blocked_distance\",\n \"description\": \"Sum of distances of all blocked field goals.\"\n },\n {\n \"variable\": \"pat_made\",\n \"description\": \"Successful extra point attempts.\"\n },\n {\n \"variable\": \"pat_att\",\n \"description\": \"Attempted extra points.\"\n },\n {\n \"variable\": \"pat_missed\",\n \"description\": \"Missed extra points.\"\n },\n {\n \"variable\": \"pat_blocked\",\n \"description\": \"Extra points blocked by opponent.\"\n },\n {\n \"variable\": \"pat_pct\",\n \"description\": \"Percentage of successful extra point attempts.\"\n },\n {\n \"variable\": \"gwfg_made\",\n \"description\": \"Successful game winning field goal attempts.\"\n },\n {\n \"variable\": \"gwfg_att\",\n \"description\": \"Attempted game winning field goals.\"\n },\n {\n \"variable\": \"gwfg_missed\",\n \"description\": \"Missed game winning field goals.\"\n },\n {\n \"variable\": \"gwfg_blocked\",\n \"description\": \"Game winning field goal attempts blocked by opponent.\"\n },\n {\n \"variable\": \"gwfg_distance\",\n \"description\": \"Distance of game winning field goal attempt. Available if summary_level = 'week'.\"\n },\n {\n \"variable\": \"gwfg_distance_list\",\n \"description\": \"Distances of game winning field goal attempts. Available if summary_level = 'season'.\"\n },\n {\n \"variable\": \"pt_att\",\n \"description\": \"Kicked punts.\"\n },\n {\n \"variable\": \"pt_blocked\",\n \"description\": \"Kicked punts that were blocked.\"\n },\n {\n \"variable\": \"pt_long\",\n \"description\": \"Longest punt kicked.\"\n },\n {\n \"variable\": \"pt_yards\",\n \"description\": \"Length of punts kicked.\"\n },\n {\n \"variable\": \"pt_inside_20\",\n \"description\": \"The number of punts where the RETURN ended inside the opponent's 20 yard line.\"\n },\n {\n \"variable\": \"pt_out_of_bounds\",\n \"description\": \"The number of punts that went out of bounds without return.\"\n },\n {\n \"variable\": \"pt_downed\",\n \"description\": \"The number of punts downed without return.\"\n },\n {\n \"variable\": \"pt_touchback\",\n \"description\": \"The number of punts that resulted in a touchback.\"\n },\n {\n \"variable\": \"pt_fair_caught\",\n \"description\": \"The number of punts that resulted in a fair catch.\"\n },\n {\n \"variable\": \"pt_returned\",\n \"description\": \"The number of punts that were returned by the opponent team.\"\n },\n {\n \"variable\": \"pt_return_yards\",\n \"description\": \"The punt return yardage of the opponent team.\"\n },\n {\n \"variable\": \"pt_return_tds\",\n \"description\": \"The number of punts that were returned for a touchdown by the opponent team.\"\n },\n {\n \"variable\": \"pt_net_yards\",\n \"description\": \"Net punt yardage. Equals `pt_yards` - `pt_return_yards` - `pt_touchback` * `20`.\"\n },\n {\n \"variable\": \"fantasy_points\",\n \"description\": \"Standard fantasy points.\"\n },\n {\n \"variable\": \"fantasy_points_ppr\",\n \"description\": \"PPR fantasy points.\"\n }\n]\n"
},
{
"path": "data-raw/pbp_datatypes.csv",
"content": "skim_type,skim_variable,n_missing,complete_rate,character.min,character.max,character.empty,character.n_unique,character.whitespace,numeric.mean,numeric.sd,numeric.p0,numeric.p25,numeric.p50,numeric.p75,numeric.p100,numeric.hist\ncharacter,game_id,0,1,13,15,0,6134,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,old_game_id,0,1,10,10,0,6134,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,home_team,0,1,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,away_team,0,1,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,season_type,0,1,3,4,0,2,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,posteam,74782,0.931927869867191,0,3,104,33,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,posteam_type,74782,0.931927869867191,4,4,0,2,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,defteam,74782,0.931927869867191,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,side_of_field,85173,0.9224692099729649,0,5,79,38,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,game_date,0,1,10,10,0,1169,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,game_half,0,1,5,8,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,time,1137,0.9989650181599716,0,5,62,1502,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,yrdln,7356,0.9933040225019798,0,6,2,1659,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,desc,0,1,4,1079,0,990769,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,play_type,50328,0.9541877167590596,3,11,0,9,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,pass_length,806758,0.26562895400384134,4,5,0,2,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,pass_location,806698,0.26568357045977953,4,6,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,run_location,778466,0.2913824335272217,4,6,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,run_gap,870143,0.20793121967648853,3,6,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,field_goal_result,1075311,0.02117206914443326,4,7,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,extra_point_result,1070162,0.025859071338194206,4,7,0,4,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,two_point_conv_result,1096605,0.0017886889319752575,7,7,0,2,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,timeout_team,1053072,0.04141565853791751,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,td_team,1068075,0.02775881373057698,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,td_player_name,1068075,0.02775881373057698,5,19,0,2989,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,td_player_id,1068076,0.02775790345631135,10,10,0,3264,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,passer_player_id,653500,0.40513576740671964,10,10,0,767,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,passer_player_name,653500,0.40513576740671964,5,17,0,802,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,receiver_player_id,715364,0.34882256023739955,10,10,0,3088,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,receiver_player_name,715364,0.34882256023739955,5,18,0,2971,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,rusher_player_id,764576,0.3040261430769091,10,10,0,2262,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,rusher_player_name,764576,0.3040261430769091,5,18,0,2206,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_receiver_player_id,1098347,2.0299116123689842e-4,10,10,0,181,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_receiver_player_name,1098347,2.0299116123689842e-4,6,16,0,181,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_rusher_player_id,1098531,3.550069635982478e-5,10,10,0,37,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_rusher_player_name,1098531,3.550069635982478e-5,6,13,0,37,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_sack_player_id,1098570,0,NA,NA,0,0,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_sack_player_name,1098570,0,NA,NA,0,0,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,interception_player_id,1086906,0.01061743903438106,10,10,0,1982,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,interception_player_name,1086906,0.01061743903438106,5,19,0,1904,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_interception_player_id,1098491,7.19116669852804e-5,10,10,0,70,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_interception_player_name,1098491,7.19116669852804e-5,5,14,0,70,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,punt_returner_player_id,1059306,0.03574100876594122,10,10,0,930,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,punt_returner_player_name,1059305,0.03574191904020685,5,19,0,910,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_punt_returner_player_id,1098509,5.552673020381427e-5,10,10,0,56,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_punt_returner_player_name,1098509,5.552673020381427e-5,5,19,0,56,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,kickoff_returner_player_name,1059285,0.03576012452551958,5,19,0,2072,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,kickoff_returner_player_id,1059286,0.035759214251253946,10,10,0,2222,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_kickoff_returner_player_id,1098419,1.374514141110339e-4,10,10,0,132,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,lateral_kickoff_returner_player_name,1098419,1.374514141110339e-4,6,16,0,132,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,punter_player_id,1041530,0.05192204411189094,10,10,0,222,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,punter_player_name,1041530,0.05192204411189094,5,16,0,243,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,kicker_player_name,985912,0.10254967821804706,3,14,0,334,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,kicker_player_id,985912,0.10254967821804706,10,10,0,310,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,own_kickoff_recovery_player_id,1098310,2.3667130906546152e-4,10,10,0,238,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,own_kickoff_recovery_player_name,1098310,2.3667130906546152e-4,5,19,0,236,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,blocked_player_id,1097590,8.920687803235516e-4,10,10,0,622,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,blocked_player_name,1097589,8.929790545891825e-4,4,19,0,603,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_for_loss_1_player_id,1048762,0.04533894062280963,10,10,0,3367,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_for_loss_1_player_name,1048699,0.04539628790154471,4,19,0,3226,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_for_loss_2_player_id,1098559,1.0013016922050255e-5,10,10,0,11,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_for_loss_2_player_name,1098559,1.0013016922050255e-5,6,12,0,11,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,qb_hit_1_player_id,1050497,0.0437596147719308,10,10,0,2982,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,qb_hit_1_player_name,1050490,0.043765986691790215,4,19,0,2829,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,qb_hit_2_player_id,1096391,0.0019834876248213673,10,10,0,1015,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,qb_hit_2_player_name,1096391,0.0019834876248213673,5,19,0,995,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,forced_fumble_player_1_team,1087072,0.010466333506285452,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,forced_fumble_player_1_player_id,1087105,0.010436294455519413,10,10,0,2977,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,forced_fumble_player_1_player_name,1087079,0.010459961586426036,4,19,0,2720,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,forced_fumble_player_2_team,1098504,6.0078101531968464e-5,2,3,0,26,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,forced_fumble_player_2_player_id,1098504,6.0078101531968464e-5,10,10,0,65,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,forced_fumble_player_2_player_name,1098504,6.0078101531968464e-5,6,14,0,65,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,solo_tackle_1_team,599256,0.45451268467189165,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,solo_tackle_2_team,1092308,0.005700137451414067,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,solo_tackle_1_player_id,599641,0.45416222907962167,10,10,0,8252,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,solo_tackle_2_player_id,1092376,0.005638238801350837,10,10,0,3134,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,solo_tackle_1_player_name,599306,0.4544671709586098,4,19,0,7320,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,solo_tackle_2_player_name,1092313,0.005695586080085913,4,18,0,2863,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_1_player_id,956715,0.12912695595182833,10,10,0,5669,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_1_player_name,956715,0.12912695595182833,5,19,0,5142,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_1_team,956715,0.12912695595182833,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_2_player_id,1039980,0.05333296922362707,10,10,0,4638,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_2_player_name,1039980,0.05333296922362707,5,19,0,4165,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_2_team,1039980,0.05333296922362707,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_3_player_id,1098567,2.730822796892518e-6,10,10,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_3_player_name,1098567,2.730822796892518e-6,8,9,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_3_team,1098567,2.730822796892518e-6,3,3,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_4_player_id,1098567,2.730822796892518e-6,10,10,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_4_player_name,1098567,2.730822796892518e-6,7,8,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,assist_tackle_4_team,1098567,2.730822796892518e-6,3,3,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_with_assist_1_player_id,1015313,0.0757867045340761,10,10,0,4738,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_with_assist_1_player_name,1015313,0.0757867045340761,5,19,0,4380,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_with_assist_1_team,1015313,0.0757867045340761,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_with_assist_2_player_id,1098570,0,NA,NA,0,0,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_with_assist_2_player_name,1098570,0,NA,NA,0,0,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,tackle_with_assist_2_team,1098570,0,NA,NA,0,0,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,pass_defense_1_player_id,1042237,0.05127848020608605,10,10,0,3379,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,pass_defense_1_player_name,1042236,0.05127939048035168,4,19,0,3197,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,pass_defense_2_player_id,1096864,0.0015529278971754268,10,10,0,996,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,pass_defense_2_player_name,1096864,0.0015529278971754268,5,19,0,963,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumbled_1_team,1081551,0.01549195772686307,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumbled_1_player_id,1081555,0.015488316629800547,10,10,0,2696,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumbled_1_player_name,1081555,0.015488316629800547,5,19,0,2517,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumbled_2_player_id,1098456,1.0377126628258182e-4,10,10,0,111,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumbled_2_player_name,1098456,1.0377126628258182e-4,5,12,0,110,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumbled_2_team,1098456,1.0377126628258182e-4,2,3,0,30,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumble_recovery_1_team,1082877,0.014284934050629472,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumble_recovery_1_player_id,1082887,0.014275831307973053,10,10,0,5004,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumble_recovery_1_player_name,1082887,0.014275831307973053,5,19,0,4398,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumble_recovery_2_team,1098447,1.1196373467325937e-4,2,3,0,31,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumble_recovery_2_player_id,1098447,1.1196373467325937e-4,10,10,0,120,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fumble_recovery_2_player_name,1098447,1.1196373467325937e-4,5,13,0,118,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,sack_player_id,1073024,0.023253866389943312,10,10,0,2582,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,sack_player_name,1072977,0.023296649280428183,4,19,0,2488,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,half_sack_1_player_id,1096089,0.002258390453043546,10,10,0,1118,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,half_sack_1_player_name,1096089,0.002258390453043546,5,18,0,1084,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,half_sack_2_player_id,1096089,0.002258390453043546,10,10,0,1094,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,half_sack_2_player_name,1096089,0.002258390453043546,5,19,0,1063,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,return_team,971115,0.11601900652666652,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,penalty_team,1021292,0.07034417469983711,2,3,0,32,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,penalty_player_id,1024660,0.06727837097317424,10,47,0,7741,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,penalty_player_name,1024735,0.06721010040325148,5,19,0,6791,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,replay_or_challenge_result,1090418,0.007420555813466567,6,8,0,3,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,penalty_type,1021527,0.07013026024741253,7,38,0,69,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,safety_player_name,1098320,2.275685664090421e-4,4,15,0,217,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,safety_player_id,1098325,2.230171950808879e-4,10,47,0,224,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,series_result,248,0.9997742519821222,4,17,0,11,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,start_time,91628,0.916593389588283,7,8,0,48,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,time_of_day,157093,0.8570022847884068,7,8,0,62195,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,stadium,569653,0.48145953375752115,3,35,0,149,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,weather,563302,0.4872406856185769,22,123,0,2682,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,nfl_api_id,91628,0.916593389588283,36,36,0,5619,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,play_clock,409460,0.6272790991925867,1,2,0,47,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,play_type_nfl,91848,0.916393129249843,4,11,0,15,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,st_play_type,1097598,8.847865861983939e-4,7,7,0,1,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,end_clock_time,893921,0.1862867181881901,4,5,0,902,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,end_yard_line,249182,0.7731760379402314,2,7,0,2240,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fixed_drive_result,556,0.9994938875083063,4,17,0,9,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_real_start_time,1098570,0,NA,NA,0,0,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_time_of_possession,14081,0.9871824280655762,4,5,0,675,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_start_transition,18201,0.9834320980911548,4,19,0,29,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_end_transition,50801,0.9537571570314136,4,19,0,31,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_game_clock_start,14081,0.9871824280655762,4,5,0,1500,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_game_clock_end,14081,0.9871824280655762,4,5,0,1500,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_start_yard_line,16021,0.9854164959902418,0,6,241,1614,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,drive_end_yard_line,16021,0.9854164959902418,0,6,241,1634,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,location,0,1,4,7,0,2,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,roof,4387,0.9960066267966539,4,8,0,4,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,surface,0,1,5,10,0,9,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,home_coach,0,1,7,20,0,151,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,away_coach,0,1,7,20,0,151,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,stadium_id,0,1,5,5,0,59,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,game_stadium,0,1,8,35,0,94,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,passer,616172,0.4391144851943891,5,16,0,737,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,rusher,771805,0.2974457704106247,5,18,0,2248,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,receiver,669086,0.3909482327025132,4,18,0,2722,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,passer_id,616172,0.4391144851943891,10,10,0,765,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,rusher_id,771806,0.29744486013635907,10,10,0,2456,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,receiver_id,669086,0.3909482327025132,10,10,0,3088,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,name,289407,0.7365602556050138,5,18,0,2325,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,id,289408,0.7365593453307482,10,10,0,2538,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fantasy_player_name,381375,0.6528441519429804,5,18,0,3442,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fantasy_player_id,381375,0.6528441519429804,10,10,0,3587,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fantasy,326758,0.7025606015092347,4,18,0,3342,0,NA,NA,NA,NA,NA,NA,NA,NA\ncharacter,fantasy_id,326759,0.7025596912349691,10,10,0,3764,0,NA,NA,NA,NA,NA,NA,NA,NA\nnumeric,play_id,0,1,NA,NA,NA,NA,NA,2084.4356254039344,1219.3576690394557,1,1036,2066,3102,5921,▇▇▇▃▁\nnumeric,week,0,1,NA,NA,NA,NA,NA,9.522483774361215,5.284186738284365,1,5,10,14,22,▇▆▆▆▁\nnumeric,yardline_100,85487,0.922183383853555,NA,NA,NA,NA,NA,49.03448977033471,24.905220727748304,1,30,51,70,99,▅▆▆▇▃\nnumeric,quarter_seconds_remaining,1199,0.9989085811555022,NA,NA,NA,NA,NA,416.734325036838,282.64536464321304,0,150,400,663,900,▇▅▅▅▆\nnumeric,half_seconds_remaining,1199,0.9989085811555022,NA,NA,NA,NA,NA,815.5808409371124,558.844159835077,0,287,806,1296,1800,▇▅▅▅▅\nnumeric,game_seconds_remaining,1199,0.9989085811555022,NA,NA,NA,NA,NA,1714.1759377639833,1058.2081334837549,0,801,1800,2607,3600,▇▆▇▆▆\nnumeric,quarter_end,0,1,NA,NA,NA,NA,NA,0.01757557552090445,0.13140277920743262,0,0,0,0,1,▇▁▁▁▁\nnumeric,drive,14081,0.9871824280655762,NA,NA,NA,NA,NA,12.280475873890838,7.123816430268896,1,6,12,18,38,▇▇▇▂▁\nnumeric,sp,0,1,NA,NA,NA,NA,NA,0.07154209563341436,0.2577283155762031,0,0,0,0,1,▇▁▁▁▁\nnumeric,qtr,0,1,NA,NA,NA,NA,NA,2.5646176392947195,1.1313198255404997,1,2,3,4,6,▇▃▅▁▁\nnumeric,down,184365,0.8321772850159753,NA,NA,NA,NA,NA,2.0047494817901894,1.0067423782563265,1,1,2,3,4,▇▆▁▃▂\nnumeric,goal_to_go,13,0.9999881664345467,NA,NA,NA,NA,NA,0.04769165368751918,0.21311311831669968,0,0,0,0,1,▇▁▁▁▁\nnumeric,ydstogo,0,1,NA,NA,NA,NA,NA,7.136612141238155,4.9257457058179615,0,3,9,10,50,▇▁▁▁▁\nnumeric,ydsnet,14081,0.9871824280655762,NA,NA,NA,NA,NA,38.70946777698989,28.730318595751015,-39,12,37,65,99,▁▇▇▇▅\nnumeric,yards_gained,50525,0.9540083927287292,NA,NA,NA,NA,NA,3.9359645816734976,7.807584532205186,-38,0,0,6,99,▁▇▁▁▁\nnumeric,shotgun,0,1,NA,NA,NA,NA,NA,0.2984989577359661,0.45759973839118473,0,0,0,1,1,▇▁▁▁▃\nnumeric,no_huddle,0,1,NA,NA,NA,NA,NA,0.043568457176147136,0.20413300724484748,0,0,0,0,1,▇▁▁▁▁\nnumeric,qb_dropback,50328,0.9541877167590596,NA,NA,NA,NA,NA,0.4362780731930223,0.4959231297944922,0,0,0,1,1,▇▁▁▁▆\nnumeric,qb_kneel,0,1,NA,NA,NA,NA,NA,0.00735046469501261,0.08541921332781825,0,0,0,0,1,▇▁▁▁▁\nnumeric,qb_spike,0,1,NA,NA,NA,NA,NA,0.0015210682978781499,0.03897122055563391,0,0,0,0,1,▇▁▁▁▁\nnumeric,qb_scramble,0,1,NA,NA,NA,NA,NA,0.014260356645457247,0.1185622691649317,0,0,0,0,1,▇▁▁▁▁\nnumeric,air_yards,804184,0.267971999963589,NA,NA,NA,NA,NA,8.308679760586442,10.100947914566389,-93,2,6,13,78,▁▁▇▃▁\nnumeric,yards_after_catch,915119,0.1669907243052332,NA,NA,NA,NA,NA,5.121536541092717,7.023980347723798,-72,1,3,7,91,▁▁▇▁▁\nnumeric,kick_distance,964499,0.1220413810681158,NA,NA,NA,NA,NA,41.25097895890983,15.058408894839559,-2,31,41,53,88,▁▇▇▆▁\nnumeric,home_timeouts_remaining,0,1,NA,NA,NA,NA,NA,2.5088369425707966,0.7915343388518676,-1,2,3,3,3,▁▁▁▃▇\nnumeric,away_timeouts_remaining,0,1,NA,NA,NA,NA,NA,2.4807158396824964,0.813320107324933,0,2,3,3,3,▁▁▁▃▇\nnumeric,timeout,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.04347332414161605,0.20392016552278353,0,0,0,0,1,▇▁▁▁▁\nnumeric,posteam_timeouts_remaining,74782,0.931927869867191,NA,NA,NA,NA,NA,2.5355298167198677,0.7704586202045379,-1,2,3,3,3,▁▁▁▂▇\nnumeric,defteam_timeouts_remaining,74782,0.931927869867191,NA,NA,NA,NA,NA,2.5542592802416126,0.7423333886351559,-1,2,3,3,3,▁▁▁▂▇\nnumeric,total_home_score,0,1,NA,NA,NA,NA,NA,11.808507423286635,10.161861231134086,0,3,10,17,62,▇▅▁▁▁\nnumeric,total_away_score,0,1,NA,NA,NA,NA,NA,10.394369043392777,9.571924926888174,0,3,7,17,59,▇▃▁▁▁\nnumeric,posteam_score,75540,0.9312378819738387,NA,NA,NA,NA,NA,10.229523083389541,9.55150831293642,0,0,7,17,62,▇▃▁▁▁\nnumeric,defteam_score,75540,0.9312378819738387,NA,NA,NA,NA,NA,11.41926434219915,10.011129519281944,0,3,10,17,62,▇▅▁▁▁\nnumeric,score_differential,75540,0.9312378819738387,NA,NA,NA,NA,NA,-1.1897412588096141,10.834589890553639,-59,-7,0,4,59,▁▂▇▁▁\nnumeric,posteam_score_post,74782,0.931927869867191,NA,NA,NA,NA,NA,10.472527515462184,9.629131505015522,0,3,7,17,62,▇▃▁▁▁\nnumeric,defteam_score_post,74782,0.931927869867191,NA,NA,NA,NA,NA,11.424630880612003,10.018617374348864,0,3,10,17,62,▇▅▁▁▁\nnumeric,score_differential_post,74782,0.931927869867191,NA,NA,NA,NA,NA,-0.9521033651498161,10.915129362273541,-59,-7,0,6,59,▁▂▇▁▁\nnumeric,no_score_prob,0,1,NA,NA,NA,NA,NA,0.1318170844272374,0.2041972997826963,0,0.006777436123229563,0.03241235762834549,0.17009594291448593,1,▇▁▁▁▁\nnumeric,opp_fg_prob,0,1,NA,NA,NA,NA,NA,0.0900442372636615,0.07039615565190616,0,0.02218738803640008,0.08674044534564018,0.14487330988049507,0.42820701003074646,▇▆▂▁▁\nnumeric,opp_safety_prob,0,1,NA,NA,NA,NA,NA,0.0024300688393332974,0.005656309098386118,0,4.499515416682698e-4,0.0013044169172644615,0.002646706940140575,0.3727701008319855,▇▁▁▁▁\nnumeric,opp_td_prob,0,1,NA,NA,NA,NA,NA,0.13686450993658264,0.11023031029440622,0,0.030053429771214724,0.12771396338939667,0.22834347561001778,0.5410013794898987,▇▅▅▁▁\nnumeric,fg_prob,0,1,NA,NA,NA,NA,NA,0.2320199917491022,0.16120988501708008,0,0.14781925082206726,0.21269237995147705,0.2992970049381256,0.9976794235436337,▇▇▂▁▁\nnumeric,safety_prob,0,1,NA,NA,NA,NA,NA,0.0026556686697281505,0.002310675572790794,0,0.001050723367370665,0.0024312720634043217,0.003875198948662728,0.3445877730846405,▇▁▁▁▁\nnumeric,td_prob,0,1,NA,NA,NA,NA,NA,0.2910022321016449,0.174859975956561,0,0.1884789690375328,0.3141609728336334,0.39814645051956177,0.9335877299308777,▅▇▅▁▁\nnumeric,extra_point_prob,0,1,NA,NA,NA,NA,NA,0.02504230941374404,0.1535238490465528,0,0,0,0,0.9963630685616458,▇▁▁▁▁\nnumeric,two_point_conversion_prob,0,1,NA,NA,NA,NA,NA,8.469442092902586e-4,0.02000777681298465,0,0,0,0,0.4735,▇▁▁▁▁\nnumeric,ep,17843,0.9837579762782527,NA,NA,NA,NA,NA,1.687473113671753,1.7057576445967129,-3.8036762471310794,0.4870520166296046,1.4019992728717625,2.8423898457549512,6.593665642023552,▁▃▇▅▁\nnumeric,epa,18018,0.9835986782817663,NA,NA,NA,NA,NA,-0.007954446230637966,1.2560468088794987,-13.58485902735265,-0.5379002675181255,-0,0.5221822524326853,9.579868719680235,▁▁▇▃▁\nnumeric,total_home_epa,0,1,NA,NA,NA,NA,NA,0.24846134966507072,12.107505734241665,-63.419816149475174,-6.520948685618038,0.1629172118846327,7.009262653625,65.34455354430793,▁▂▇▁▁\nnumeric,total_away_epa,0,1,NA,NA,NA,NA,NA,-0.22035254191216969,12.12565119448133,-65.34455354430793,-6.986512561861116,-0.1464349998728821,6.554438007757298,73.00163108506858,▁▂▇▁▁\nnumeric,total_home_rush_epa,0,1,NA,NA,NA,NA,NA,-0.06469372946176401,5.308144641341979,-32.110373332952676,-2.927859448711388,0,2.827283695190957,33.16040635136608,▁▁▇▁▁\nnumeric,total_away_rush_epa,0,1,NA,NA,NA,NA,NA,0.06469372946176401,5.308144641341979,-33.16040635136608,-2.827283695190957,0,2.927859448711388,32.110373332952676,▁▁▇▁▁\nnumeric,total_home_pass_epa,0,1,NA,NA,NA,NA,NA,-0.1637843757034343,10.596039297207732,-60.38258939230582,-6.080178061468196,0,5.74475710087931,53.981246434958145,▁▁▇▂▁\nnumeric,total_away_pass_epa,0,1,NA,NA,NA,NA,NA,0.16382928846033679,10.595990115688988,-53.981246434958145,-5.74475710087931,0,6.080178061468196,60.38258939230582,▁▂▇▁▁\nnumeric,air_epa,805471,0.26680047698371523,NA,NA,NA,NA,NA,0.5055065487066353,1.354761434024009,-11.79624876496382,-0.4898784961551428,0.2779173366725445,1.3612197960610501,7.454971208120696,▁▁▅▇▁\nnumeric,yac_epa,805500,0.2667740790300117,NA,NA,NA,NA,NA,-0.36660423146545995,1.924923089183378,-14,-0.8769923797808588,0,0.5234156415099278,9.848225327499676,▁▁▇▅▁\nnumeric,comp_air_epa,364010,0.6686510645657537,NA,NA,NA,NA,NA,0.05577522160824954,0.6080947516859125,-11.79624876496382,0,0,0,7.423614024184644,▁▁▁▇▁\nnumeric,comp_yac_epa,364019,0.668642872097363,NA,NA,NA,NA,NA,0.1588122908959473,0.5770241464224364,-10.914922855328768,0,0,0,9.848225327499676,▁▁▇▁▁\nnumeric,total_home_comp_air_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.1715972755615049,6.026821816064234,-34.2570441190619,-3.49196311540436,0,3.224452398380345,30.63045173761202,▁▁▇▂▁\nnumeric,total_away_comp_air_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.1715972755615049,6.026821816064234,-30.63045173761202,-3.224452398380345,0,3.49196311540436,34.2570441190619,▁▂▇▁▁\nnumeric,total_home_comp_yac_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.06711449665539697,6.386129449480004,-32.63186197145842,-3.6308591519482434,0,3.5630386369884945,35.91268990805838,▁▂▇▁▁\nnumeric,total_away_comp_yac_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.06711449665539697,6.386129449480004,-35.91268990805838,-3.5630386369884945,0,3.6308591519482434,32.63186197145842,▁▁▇▂▁\nnumeric,total_home_raw_air_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.5431016530492653,9.369514500698392,-67.52350558768376,-5.610673192248214,-0.13607840356417,4.56955827208003,62.42438889516052,▁▁▇▁▁\nnumeric,total_away_raw_air_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.5431016530492653,9.369514500698392,-62.42438889516052,-4.56955827208003,0.13607840356417,5.610673192248214,67.52350558768376,▁▁▇▁▁\nnumeric,total_home_raw_yac_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.28727892012474604,12.25002005575581,-66.52721119566374,-6.30992435511531,0,6.773971046050304,83.97783668081532,▁▃▇▁▁\nnumeric,total_away_raw_yac_epa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.28727892012474604,12.25002005575581,-83.97783668081532,-6.773971046050304,0,6.30992435511531,66.52721119566374,▁▁▇▃▁\nnumeric,wp,6298,0.994267092675023,NA,NA,NA,NA,NA,0.5092682336602672,0.3000892471142395,0,0.2650805339217186,0.5197814106941223,0.7546021823708784,0.999977398025294,▇▆▇▇▇\nnumeric,def_wp,6298,0.994267092675023,NA,NA,NA,NA,NA,0.49073176633973276,0.3000892471142395,2.2601974706049077e-5,0.24539781762912163,0.4802185893058777,0.7349194660782814,1,▇▇▇▆▇\nnumeric,home_wp,0,1,NA,NA,NA,NA,NA,0.5651212434687914,0.29463946094535143,0,0.34911757707595825,0.58470419049263,0.8092272281646729,1,▅▅▇▇▇\nnumeric,away_wp,0,1,NA,NA,NA,NA,NA,0.43487875653120855,0.29463946094535143,0,0.19077277183532715,0.41529580950737,0.6508824229240417,1,▇▇▇▅▅\nnumeric,wpa,14462,0.9868356135703688,NA,NA,NA,NA,NA,2.3231512244109806e-4,0.041179407416532865,-0.999494194984436,-0.01393437385559082,-0,0.01011665165424347,0.9997061546600889,▁▁▇▁▁\nnumeric,vegas_wpa,14462,0.9868356135703688,NA,NA,NA,NA,NA,5.26771687176859e-4,0.0399261106770947,-0.9998733997344971,-0.011666126549243927,0,0.008488729596138,0.9998747144678148,▁▁▇▁▁\nnumeric,vegas_home_wpa,6134,0.9944163776545873,NA,NA,NA,NA,NA,4.930193089403416e-6,0.039854870927841776,-0.9998747144678148,-0.010171317495405674,0,0.010242700576782227,0.9998733997344971,▁▁▇▁▁\nnumeric,home_wp_post,84757,0.9228478840674695,NA,NA,NA,NA,NA,0.5654515316738287,0.2932497903348318,0,0.3504820764064789,0.588352620601654,0.8072708249092102,1,▅▅▇▇▇\nnumeric,away_wp_post,84757,0.9228478840674695,NA,NA,NA,NA,NA,0.4345613652772663,0.293342597120003,-0.9994123093201779,0.19272546470165253,0.41165006160736084,0.6495179235935211,1.9977154731750488,▁▃▇▂▁\nnumeric,vegas_wp,6298,0.994267092675023,NA,NA,NA,NA,NA,0.5093007509900243,0.3234289117543515,0,0.22046128660440445,0.5167959928512573,0.799371525645256,0.9999985694885254,▇▆▆▆▇\nnumeric,vegas_home_wp,0,1,NA,NA,NA,NA,NA,0.5658029819469882,0.3181085215410204,0,0.2971372455358505,0.60519078373909,0.8528302535414696,1,▅▃▅▅▇\nnumeric,total_home_rush_wpa,0,1,NA,NA,NA,NA,NA,-0.005736035352490824,0.15295769414640503,-1.0790940578000532,-0.08720871806144714,0,0.08142374248139406,1.0827744475655492,▁▁▇▁▁\nnumeric,total_away_rush_wpa,0,1,NA,NA,NA,NA,NA,0.005736035352490824,0.15295769414640503,-1.0827744475655492,-0.08142374248139406,0,0.08720871806144714,1.0790940578000532,▁▁▇▁▁\nnumeric,total_home_pass_wpa,0,1,NA,NA,NA,NA,NA,-0.011704553292779056,0.2612775797505144,-1.8669247376815488,-0.1780981719493866,0.0036022216081619263,0.1692317584797332,1.7035376865755814,▁▁▇▁▁\nnumeric,total_away_pass_wpa,0,1,NA,NA,NA,NA,NA,0.011704553292779056,0.2612775797505144,-1.7035376865755814,-0.1692317584797332,-0.0036022216081619263,0.1780981719493866,1.8669247376815488,▁▁▇▁▁\nnumeric,air_wpa,805469,0.2668022975322465,NA,NA,NA,NA,NA,0.0031944892416476147,0.04235070909282636,-0.9980781078338623,0,0,0,0.9912653528153896,▁▁▇▁▁\nnumeric,yac_wpa,805469,0.2668022975322465,NA,NA,NA,NA,NA,3.550292191821682e-4,0.05655707094397412,-0.99085608497262,-0.015901625156402588,0,0.011798828840255737,1,▁▁▇▁▁\nnumeric,comp_air_wpa,364008,0.668652885114285,NA,NA,NA,NA,NA,0.001331281430309251,0.021105782500084776,-0.99611663818359375,0,0,0,0.9882552844937891,▁▁▇▁▁\nnumeric,comp_yac_wpa,364008,0.668652885114285,NA,NA,NA,NA,NA,0.004087812878937085,0.026691557398439505,-0.9883022714639083,0,0,0,1,▁▁▇▁▁\nnumeric,total_home_comp_air_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.006595088517105849,0.1518415145504115,-1.9444250103439105,-0.04968388275176994,0,0.04606897134688148,3.0175069247978037,▁▇▃▁▁\nnumeric,total_away_comp_air_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.006595088517105849,0.1518415145504115,-3.0175069247978037,-0.04606897134688148,0,0.04968388275176994,1.9444250103439105,▁▁▃▇▁\nnumeric,total_home_comp_yac_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-1.2000175624890671e-4,0.23046011134609773,-2.555464788224241,-0.11639988422393799,0,0.11682116985321045,2.106908860423353,▁▁▇▁▁\nnumeric,total_away_comp_yac_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,1.2000175624890671e-4,0.23046011134609773,-2.106908860423353,-0.11682116985321045,0,0.11639988422393799,2.555464788224241,▁▁▇▁▁\nnumeric,total_home_raw_air_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.011168386565439632,0.1927320921131443,-2.9340697821495256,-0.05357837677001953,0,0.04698159838693505,3.905425994589482,▁▁▇▁▁\nnumeric,total_away_raw_air_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.011168386565439632,0.1927320921131443,-3.905425994589482,-0.04698159838693505,0,0.05357837677001953,2.9340697821495256,▁▁▇▁▁\nnumeric,total_home_raw_yac_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,-0.0026903383881771385,0.30053654108944405,-3.7097175012884205,-0.1533583104610443,0,0.14303510306494469,3.265507598971233,▁▁▇▁▁\nnumeric,total_away_raw_yac_wpa,328090,0.7013481161874073,NA,NA,NA,NA,NA,0.0026903383881771385,0.30053654108944405,-3.265507598971233,-0.14303510306494469,0,0.1533583104610443,3.7097175012884205,▁▁▇▁▁\nnumeric,punt_blocked,50525,0.9540083927287292,NA,NA,NA,NA,NA,3.024679283809378e-4,0.017388983007877862,0,0,0,0,1,▇▁▁▁▁\nnumeric,first_down_rush,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.07168966981379617,0.25797349583877194,0,0,0,0,1,▇▁▁▁▁\nnumeric,first_down_pass,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.13458868655448952,0.3412838747160773,0,0,0,0,1,▇▁▁▁▁\nnumeric,first_down_penalty,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.019788272450133332,0.13927209063948912,0,0,0,0,1,▇▁▁▁▁\nnumeric,third_down_converted,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.06017108044024827,0.23780364899861764,0,0,0,0,1,▇▁▁▁▁\nnumeric,third_down_failed,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.09510087830198129,0.2933543648216251,0,0,0,0,1,▇▁▁▁▁\nnumeric,fourth_down_converted,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.005742119851723924,0.07555893963498897,0,0,0,0,1,▇▁▁▁▁\nnumeric,fourth_down_failed,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.00593295135227972,0.07679685584657968,0,0,0,0,1,▇▁▁▁▁\nnumeric,incomplete_pass,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.14255017675767742,0.34961370180594376,0,0,0,0,1,▇▁▁▁▁\nnumeric,touchback,0,1,NA,NA,NA,NA,NA,0.023482345230618002,0.15142967201489163,0,0,0,0,1,▇▁▁▁▁\nnumeric,interception,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.01112929311241407,0.10490682746207507,0,0,0,0,1,▇▁▁▁▁\nnumeric,punt_inside_twenty,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.017976327352356058,0.132865329756134,0,0,0,0,1,▇▁▁▁▁\nnumeric,punt_in_endzone,50525,0.9540083927287292,NA,NA,NA,NA,NA,3.339551259726445e-5,0.005778791326959958,0,0,0,0,1,▇▁▁▁▁\nnumeric,punt_out_of_bounds,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.0051133300573925735,0.07132453131353966,0,0,0,0,1,▇▁▁▁▁\nnumeric,punt_downed,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.007430978631642728,0.08588228121016313,0,0,0,0,1,▇▁▁▁▁\nnumeric,punt_fair_catch,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.012493738341388016,0.11107500445965617,0,0,0,0,1,▇▁▁▁▁\nnumeric,kickoff_inside_twenty,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.0064730044988526225,0.08019420707197665,0,0,0,0,1,▇▁▁▁▁\nnumeric,kickoff_in_endzone,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.011002390164544478,0.10431369976053685,0,0,0,0,1,▇▁▁▁▁\nnumeric,kickoff_out_of_bounds,50525,0.9540083927287292,NA,NA,NA,NA,NA,7.356554346425972e-4,0.0271130032851308,0,0,0,0,1,▇▁▁▁▁\nnumeric,kickoff_downed,50525,0.9540083927287292,NA,NA,NA,NA,NA,3.8166300111159326e-5,0.006177773050218164,0,0,0,0,1,▇▁▁▁▁\nnumeric,kickoff_fair_catch,50525,0.9540083927287292,NA,NA,NA,NA,NA,9.636990778067718e-5,0.009816349248312638,0,0,0,0,1,▇▁▁▁▁\nnumeric,fumble_forced,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.01097281128195831,0.10417494444176967,0,0,0,0,1,▇▁▁▁▁\nnumeric,fumble_not_forced,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.005325153023009507,0.072779123533286,0,0,0,0,1,▇▁▁▁▁\nnumeric,fumble_out_of_bounds,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.001254717116154364,0.03539977396551467,0,0,0,0,1,▇▁▁▁▁\nnumeric,solo_tackle,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.4764241993425855,0.49944411061962346,0,0,0,1,1,▇▁▁▁▇\nnumeric,safety,50525,0.9540083927287292,NA,NA,NA,NA,NA,3.730755835865827e-4,0.019311570470469743,0,0,0,0,1,▇▁▁▁▁\nnumeric,penalty,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.07373538349975431,0.2613398972362713,0,0,0,0,1,▇▁▁▁▁\nnumeric,tackled_for_loss,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.029865129836982186,0.17021525049721078,0,0,0,0,1,▇▁▁▁▁\nnumeric,fumble_lost,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.007655205644795784,0.08715853784738917,0,0,0,0,1,▇▁▁▁▁\nnumeric,own_kickoff_recovery,50525,0.9540083927287292,NA,NA,NA,NA,NA,2.4712679321975634e-4,0.015718331886929632,0,0,0,0,1,▇▁▁▁▁\nnumeric,own_kickoff_recovery_td,50525,0.9540083927287292,NA,NA,NA,NA,NA,9.54157502778982e-7,9.768098600950877e-4,0,0,0,0,1,▇▁▁▁▁\nnumeric,qb_hit,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.04588161767863027,0.20922843164238794,0,0,0,0,1,▇▁▁▁▁\nnumeric,rush_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.3186847892981695,0.4659667386623199,0,0,0,1,1,▇▁▁▁▃\nnumeric,pass_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.4246687880768479,0.49429287030579566,0,0,0,1,1,▇▁▁▁▆\nnumeric,sack,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.026963536871031302,0.16197694152013542,0,0,0,0,1,▇▁▁▁▁\nnumeric,touchdown,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.0290970330472451,0.16807862050375538,0,0,0,0,1,▇▁▁▁▁\nnumeric,pass_touchdown,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.016936295674326952,0.1290328386472942,0,0,0,0,1,▇▁▁▁▁\nnumeric,rush_touchdown,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.00968946944072058,0.09795709662084069,0,0,0,0,1,▇▁▁▁▁\nnumeric,return_touchdown,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.0022794822741389917,0.04768949994212801,0,0,0,0,1,▇▁▁▁▁\nnumeric,extra_point_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.027105706338945365,0.16239153975780735,0,0,0,0,1,▇▁▁▁▁\nnumeric,two_point_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.0018749194929607034,0.04325974983135766,0,0,0,0,1,▇▁▁▁▁\nnumeric,field_goal_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.022192749357136384,0.14731005375929296,0,0,0,0,1,▇▁▁▁▁\nnumeric,kickoff_attempt,50498,0.9540329701339013,NA,NA,NA,NA,NA,0.05856372462960561,0.2348064466583969,0,0,0,0,1,▇▁▁▁▁\nnumeric,punt_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.0547314285169053,0.22745537719220404,0,0,0,0,1,▇▁▁▁▁\nnumeric,fumble,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.016238806539795515,0.12639273295859219,0,0,0,0,1,▇▁▁▁▁\nnumeric,complete_pass,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.24267374015428733,0.4286996283554495,0,0,0,0,1,▇▁▁▁▂\nnumeric,assist_tackle,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.13535201255671275,0.3420993377960261,0,0,0,0,1,▇▁▁▁▁\nnumeric,lateral_reception,50525,0.9540083927287292,NA,NA,NA,NA,NA,2.1277712311971333e-4,0.014585336883167023,0,0,0,0,1,▇▁▁▁▁\nnumeric,lateral_rush,50525,0.9540083927287292,NA,NA,NA,NA,NA,3.721214260838033e-5,0.00610006502996325,0,0,0,0,1,▇▁▁▁▁\nnumeric,lateral_return,50525,0.9540083927287292,NA,NA,NA,NA,NA,2.776598333086835e-4,0.016660822404177992,0,0,0,0,1,▇▁▁▁▁\nnumeric,lateral_recovery,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.001992280865802518,0.044590509975986924,0,0,0,0,1,▇▁▁▁▁\nnumeric,passing_yards,844237,0.23151278480206083,NA,NA,NA,NA,NA,11.454679494992785,10.155601152890332,-22,5,9,15,99,▁▇▁▁▁\nnumeric,receiving_yards,844237,0.23151278480206083,NA,NA,NA,NA,NA,11.449501244431513,10.148341932961369,-22,5,9,15,99,▁▇▁▁▁\nnumeric,rushing_yards,765120,0.30353095387640294,NA,NA,NA,NA,NA,4.177474883790673,6.277634572361271,-34,1,3,6,99,▁▇▁▁▁\nnumeric,lateral_receiving_yards,1098347,2.0299116123689842e-4,NA,NA,NA,NA,NA,5.941704035874439,10.321900567115344,-21,0,4,10,62,▁▇▂▁▁\nnumeric,lateral_rushing_yards,1098531,3.550069635982478e-5,NA,NA,NA,NA,NA,9.692307692307692,9.878615517086033,0,4,6,12,44,▇▃▁▁▁\nnumeric,tackle_with_assist,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.07944029120886999,0.2704248529974212,0,0,0,0,1,▇▁▁▁▁\nnumeric,fumble_recovery_1_yards,1082877,0.014284934050629472,NA,NA,NA,NA,NA,2.3068246989103423,9.281173192373814,-100,0,0,0,104,▁▁▇▁▁\nnumeric,fumble_recovery_2_yards,1098447,1.1196373467325937e-4,NA,NA,NA,NA,NA,3.926829268292683,12.171702422588814,-16,0,0,1.5,77,▇▂▁▁▁\nnumeric,return_yards,50525,0.9540083927287292,NA,NA,NA,NA,NA,1.215521280097707,5.810803247891786,-100,0,0,0,109,▁▁▇▁▁\nnumeric,penalty_yards,1021292,0.07034417469983711,NA,NA,NA,NA,NA,8.364502186909599,5.267519745457818,0,5,5,10,66,▇▂▁▁▁\nnumeric,replay_or_challenge,0,1,NA,NA,NA,NA,NA,0.0074205558134665915,0.08582247881242441,0,0,0,0,1,▇▁▁▁▁\nnumeric,defensive_two_point_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,4.7707875138949524e-5,0.006906927291951021,0,0,0,0,1,▇▁▁▁▁\nnumeric,defensive_two_point_conv,50525,0.9540083927287292,NA,NA,NA,NA,NA,1.0495732530568788e-5,0.0032396963414267495,0,0,0,0,1,▇▁▁▁▁\nnumeric,defensive_extra_point_attempt,50525,0.9540083927287292,NA,NA,NA,NA,NA,0,0,0,0,0,0,0,▁▁▇▁▁\nnumeric,defensive_extra_point_conv,50525,0.9540083927287292,NA,NA,NA,NA,NA,0,0,0,0,0,0,0,▁▁▇▁▁\nnumeric,season,0,1,NA,NA,NA,NA,NA,2010.1182082161356,6.627584365671061,1999,2004,2010,2016,2021,▇▆▇▆▇\nnumeric,cp,811614,0.2612086621699118,NA,NA,NA,NA,NA,0.6348154096544791,0.17004701657348936,0.09544014185667038,0.5279483497142792,0.6781390309333801,0.7639535367488861,0.926070511341095,▁▃▃▇▆\nnumeric,cpoe,811614,0.2612086621699118,NA,NA,NA,NA,NA,0.06548366550596109,44.90345874861157,-92.05909371376038,-44.26913559436798,20.371761918067932,32.09476172924042,85.26444137096405,▃▃▁▇▁\nnumeric,series,0,1,NA,NA,NA,NA,NA,29.29300545254285,17.06057955007624,1,15,29,44,82,▇▇▇▃▁\nnumeric,series_success,0,1,NA,NA,NA,NA,NA,0.550455592269951,0.49744794547782784,0,0,1,1,1,▆▁▁▁▇\nnumeric,order_sequence,91628,0.916593389588283,NA,NA,NA,NA,NA,2089.286688328847,1223.2124087724426,1,1038,2071,3110,5921,▇▇▇▃▁\nnumeric,play_deleted,91628,0.916593389588283,NA,NA,NA,NA,NA,0,0,0,0,0,0,0,▁▁▇▁▁\nnumeric,special_teams_play,91628,0.916593389588283,NA,NA,NA,NA,NA,0.15910747590228633,0.36577646163240873,0,0,0,0,1,▇▁▁▁▂\nnumeric,fixed_drive,0,1,NA,NA,NA,NA,NA,12.20017932403033,7.136661236285931,1,6,12,18,38,▇▆▆▁▁\nnumeric,drive_play_count,14081,0.9871824280655762,NA,NA,NA,NA,NA,7.189677350346567,3.602393232327467,0,4,7,10,24,▅▇▅▁▁\nnumeric,drive_first_downs,14081,0.9871824280655762,NA,NA,NA,NA,NA,2.3803994323593884,1.8755856899745,0,1,2,4,9,▇▇▅▁▁\nnumeric,drive_inside20,14081,0.9871824280655762,NA,NA,NA,NA,NA,0.37966636821581407,0.4853040636890067,0,0,0,1,1,▇▁▁▁▅\nnumeric,drive_ended_with_score,14081,0.9871824280655762,NA,NA,NA,NA,NA,0.4375959553301142,0.4960906793535729,0,0,0,1,1,▇▁▁▁▆\nnumeric,drive_quarter_start,14081,0.9871824280655762,NA,NA,NA,NA,NA,2.5190509078469216,1.130511492046773,1,2,3,4,5,▇▇▇▇▁\nnumeric,drive_quarter_end,14081,0.9871824280655762,NA,NA,NA,NA,NA,2.6349700181375746,1.1228361579111892,1,2,3,4,6,▇▃▅▁▁\nnumeric,drive_yards_penalized,105709,0.9037758176538591,NA,NA,NA,NA,NA,0.0910671282284217,7.611621086271443,-40,0,0,0,77,▁▇▁▁▁\nnumeric,drive_play_id_started,14081,0.9871824280655762,NA,NA,NA,NA,NA,1994.7812905432884,1209.712470152506,10,953,1986,3005,5764,▇▇▇▃▁\nnumeric,drive_play_id_ended,14081,0.9871824280655762,NA,NA,NA,NA,NA,2192.7340221984737,1213.3905594679325,34,1149,2164,3206,5921,▇▇▇▅▁\nnumeric,away_score,0,1,NA,NA,NA,NA,NA,21.140365202035373,10.101971087488094,0,14,21,28,59,▃▇▆▂▁\nnumeric,home_score,0,1,NA,NA,NA,NA,NA,23.40198530817335,10.330063582737433,0,16,23,30,62,▂▇▆▂▁\nnumeric,result,0,1,NA,NA,NA,NA,NA,2.2616201061379795,14.548871420505362,-49,-7,3,11,59,▁▃▇▂▁\nnumeric,total,0,1,NA,NA,NA,NA,NA,44.54235051020873,14.34748784077857,3,34,44,54,106,▁▇▆▂▁\nnumeric,spread_line,0,1,NA,NA,NA,NA,NA,2.339101286217539,5.952923025351251,-19,-3,3,6.5,27,▁▅▇▂▁\nnumeric,total_line,0,1,NA,NA,NA,NA,NA,43.481633851279376,5.017518021658727,30,40,43.5,47,63.5,▂▇▇▂▁\nnumeric,div_game,0,1,NA,NA,NA,NA,NA,0.380814149303185,0.4855872193867445,0,0,0,1,1,▇▁▁▁▅\nnumeric,temp,317103,0.7113492995439525,NA,NA,NA,NA,NA,58.22617333809361,16.860510369502123,-6,46,59,71,109,▁▃▇▇▁\nnumeric,wind,317103,0.7113492995439525,NA,NA,NA,NA,NA,8.494006784675488,5.383877047778842,0,5,8,12,71,▇▁▁▁▁\nnumeric,aborted_play,0,1,NA,NA,NA,NA,NA,0.002607935771047818,0.051001341255008464,0,0,0,0,1,▇▁▁▁▁\nnumeric,success,18018,0.9835986782817663,NA,NA,NA,NA,NA,0.41713494584249533,0.49308580166962673,0,0,0,1,1,▇▁▁▁▆\nnumeric,passer_jersey_number,656502,0.40240312406127965,NA,NA,NA,NA,NA,9.03425717310459,4.860778988279489,1,5,9,12,92,▇▁▁▁▁\nnumeric,rusher_jersey_number,794957,0.2763711006126146,NA,NA,NA,NA,NA,27.7503301900775,10.75144904832512,1,22,28,33,99,▂▇▁▁▁\nnumeric,receiver_jersey_number,702732,0.3603211447609165,NA,NA,NA,NA,NA,53.07991400522436,32.341174900030225,1,18,80,84,99,▅▃▁▁▇\nnumeric,pass,0,1,NA,NA,NA,NA,NA,0.43929380922471944,0.49630130225070546,0,0,0,1,1,▇▁▁▁▆\nnumeric,rush,0,1,NA,NA,NA,NA,NA,0.2900707283104399,0.4537949849222303,0,0,0,1,1,▇▁▁▁▃\nnumeric,first_down,50525,0.9540083927287292,NA,NA,NA,NA,NA,0.223826267001894,0.41680719159581336,0,0,0,0,1,▇▁▁▁▂\nnumeric,special,0,1,NA,NA,NA,NA,NA,0.15393466051321264,0.360886269285787,0,0,0,0,1,▇▁▁▁▂\nnumeric,play,0,1,NA,NA,NA,NA,NA,0.752477311413929,0.43157314184813556,0,1,1,1,1,▂▁▁▁▇\nnumeric,jersey_number,367370,0.6655925430332159,NA,NA,NA,NA,NA,16.811021608315098,12.101034042875968,1,8,12,26,99,▇▅▁▁▁\nnumeric,out_of_bounds,0,1,NA,NA,NA,NA,NA,0.06955041554020228,0.25438792059600834,0,0,0,0,1,▇▁▁▁▁\nnumeric,home_opening_kickoff,0,1,NA,NA,NA,NA,NA,0.48775408030439565,0.4998502424557511,0,0,0,1,1,▇▁▁▁▇\nnumeric,qb_epa,18018,0.9835986782817663,NA,NA,NA,NA,NA,-7.359714411560366e-4,1.2454625465492268,-13.58485902735265,-0.5353464668150991,0,0.5254294750135534,9.579868719680235,▁▁▇▃▁\nnumeric,xyac_epa,831471,0.24313334607717307,NA,NA,NA,NA,NA,0.6872020672438497,0.5040984516422667,-1.2820399739124755,0.30739913538713626,0.5661891744628638,0.920687893258089,13.028142577118448,▇▁▁▁▁\nnumeric,xyac_mean_yardage,831419,0.2431806803389861,NA,NA,NA,NA,NA,5.217610647958738,2.983742858931366,-77.34254090196919,3.6430345882508846,4.496286971581867,6.384836019860813,78.85111491640419,▁▁▇▁▁\nnumeric,xyac_median_yardage,831419,0.2431806803389861,NA,NA,NA,NA,NA,3.4332418744455384,2.3961516593295906,0,2,3,5,48,▇▁▁▁▁\nnumeric,xyac_success,831419,0.2431806803389861,NA,NA,NA,NA,NA,0.7963682448146061,0.24753272979377464,0.010269990365486592,0.5846049897518242,0.9878865564242005,1,1,▁▁▃▂▇\nnumeric,xyac_fd,831419,0.2431806803389861,NA,NA,NA,NA,NA,0.598139960266696,0.35654205947727374,0,0.24512977158883587,0.5134540184517391,0.9991877254215069,1,▂▆▂▁▇\nnumeric,xpass,522120,0.5247276004260084,NA,NA,NA,NA,NA,0.6137813038965859,0.2410066250760552,0.01067630760371685,0.44443003088235855,0.5740557610988617,0.8400976061820984,0.998187243938446,▁▃▇▅▆\nnumeric,pass_oe,538745,0.5095942907598059,NA,NA,NA,NA,NA,-0.26308551422534004,41.94502679344846,-99.23535585403442,-41.299596428871155,4.3928563594818115,34.751224517822266,97.72196300327778,▂▇▇▇▂\n"
},
{
"path": "data-raw/replace_models.R",
"content": "# Helper function to replace the internal calls to the models\n# with a call to the fastrmodels package\nmodels <- c(\n \"ep_model,\",\n \"wp_model,\",\n \"wp_model_spread,\",\n \"fg_model,\",\n \"cp_model,\",\n \"xyac_model,\",\n \"xpass_model,\"\n)\n\npurrr::walk(models, function(model) {\n xfun::gsub_dir(\n # paste0(model,\"(?![:alpha:]+)\"),\n model,\n paste0(\"fastrmodels::\", model),\n dir = usethis::proj_path(\"R\"),\n ext = \"R\"\n )\n})\n"
},
{
"path": "data-raw/teams_colors_logos.R",
"content": "teams_colors_logos <- nflreadr::load_teams()\n\nuse_data(teams_colors_logos, overwrite = TRUE)\n"
},
{
"path": "data-raw/tidy_play_stats_row.R",
"content": "# Script to create the tidy_play_stats_row tibble that is used in\n# the internal function `sum_play_stats`\n\nlibrary(tidyverse)\n\ntidy_play_stats_row <-\n as_tibble_row(\n matrix(NA, ncol = length(pbp_stat_columns)),\n .name_repair = \"minimal\"\n ) |>\n set_names(pbp_stat_columns) |>\n modify_at(indicator_stats, function(x) {\n x <- 0\n }) |>\n modify_if(is.na, function(x) {\n x <- NA_character_\n }) |>\n modify_at(\n c(\n \"air_yards\",\n \"yards_after_catch\",\n \"penalty_yards\",\n \"kick_distance\",\n \"fumble_recovery_1_yards\",\n \"fumble_recovery_2_yards\",\n \"rushing_yards\",\n \"lateral_rushing_yards\",\n \"passing_yards\",\n \"receiving_yards\",\n \"lateral_receiving_yards\"\n ),\n as.integer\n )\n\ntidy_play_stats_row <- nflfastR:::tidy_play_stats_row\nscramble_fix <- readRDS(\"data-raw/scramble_fix.rds\")\ndefault_play <- readRDS(\"data-raw/pbp_defaultplay.rds\")\nusethis::use_data(\n tidy_play_stats_row,\n scramble_fix,\n default_play,\n internal = TRUE,\n overwrite = TRUE\n)\n\n# stats character vectors -------------------------------------------------\n\npbp_stat_columns <-\n c(\n # \"play_id\",\n \"punt_blocked\",\n \"first_down_rush\",\n \"first_down_pass\",\n \"first_down_penalty\",\n \"third_down_converted\",\n \"third_down_failed\",\n \"fourth_down_converted\",\n \"fourth_down_failed\",\n \"incomplete_pass\",\n \"interception\",\n \"punt_inside_twenty\",\n \"punt_in_endzone\",\n \"punt_out_of_bounds\",\n \"punt_downed\",\n \"punt_fair_catch\",\n \"kickoff_inside_twenty\",\n \"kickoff_in_endzone\",\n \"kickoff_out_of_bounds\",\n \"kickoff_fair_catch\",\n \"fumble_forced\",\n \"fumble_not_forced\",\n \"fumble_out_of_bounds\",\n \"timeout\",\n \"field_goal_missed\",\n \"field_goal_made\",\n \"field_goal_blocked\",\n \"extra_point_good\",\n \"extra_point_failed\",\n \"extra_point_blocked\",\n \"two_point_rush_good\",\n \"two_point_rush_failed\",\n \"two_point_pass_good\",\n \"two_point_pass_failed\",\n \"solo_tackle\",\n \"safety\",\n \"penalty\",\n \"tackled_for_loss\",\n \"extra_point_safety\",\n \"two_point_rush_safety\",\n \"two_point_pass_safety\",\n \"kickoff_downed\",\n \"two_point_pass_reception_good\",\n \"two_point_pass_reception_failed\",\n \"fumble_lost\",\n \"own_kickoff_recovery\",\n \"own_kickoff_recovery_td\",\n \"qb_hit\",\n \"extra_point_aborted\",\n \"two_point_return\",\n \"rush_attempt\",\n \"pass_attempt\",\n \"sack\",\n \"touchdown\",\n \"pass_touchdown\",\n \"rush_touchdown\",\n \"return_touchdown\",\n \"extra_point_attempt\",\n \"two_point_attempt\",\n \"field_goal_attempt\",\n \"kickoff_attempt\",\n \"punt_attempt\",\n \"fumble\",\n \"complete_pass\",\n \"assist_tackle\",\n \"lateral_reception\",\n \"lateral_rush\",\n \"lateral_return\",\n \"lateral_recovery\",\n \"passer_player_id\",\n \"passer_player_name\",\n \"receiver_player_id\",\n \"receiver_player_name\",\n \"rusher_player_id\",\n \"rusher_player_name\",\n \"lateral_receiver_player_id\",\n \"lateral_receiver_player_name\",\n \"lateral_rusher_player_id\",\n \"lateral_rusher_player_name\",\n \"lateral_sack_player_id\",\n \"lateral_sack_player_name\",\n \"interception_player_id\",\n \"interception_player_name\",\n \"lateral_interception_player_id\",\n \"lateral_interception_player_name\",\n \"punt_returner_player_id\",\n \"punt_returner_player_name\",\n \"lateral_punt_returner_player_id\",\n \"lateral_punt_returner_player_name\",\n \"kickoff_returner_player_name\",\n \"kickoff_returner_player_id\",\n \"lateral_kickoff_returner_player_id\",\n \"lateral_kickoff_returner_player_name\",\n \"punter_player_id\",\n \"punter_player_name\",\n \"kicker_player_name\",\n \"kicker_player_id\",\n \"own_kickoff_recovery_player_id\",\n \"own_kickoff_recovery_player_name\",\n \"blocked_player_id\",\n \"blocked_player_name\",\n \"tackle_for_loss_1_player_id\",\n \"tackle_for_loss_1_player_name\",\n \"tackle_for_loss_2_player_id\",\n \"tackle_for_loss_2_player_name\",\n \"qb_hit_1_player_id\",\n \"qb_hit_1_player_name\",\n \"qb_hit_2_player_id\",\n \"qb_hit_2_player_name\",\n \"forced_fumble_player_1_team\",\n \"forced_fumble_player_1_player_id\",\n \"forced_fumble_player_1_player_name\",\n \"forced_fumble_player_2_team\",\n \"forced_fumble_player_2_player_id\",\n \"forced_fumble_player_2_player_name\",\n \"solo_tackle_1_team\",\n \"solo_tackle_2_team\",\n \"solo_tackle_1_player_id\",\n \"solo_tackle_2_player_id\",\n \"solo_tackle_1_player_name\",\n \"solo_tackle_2_player_name\",\n \"assist_tackle_1_player_id\",\n \"assist_tackle_1_player_name\",\n \"assist_tackle_1_team\",\n \"assist_tackle_2_player_id\",\n \"assist_tackle_2_player_name\",\n \"assist_tackle_2_team\",\n \"assist_tackle_3_player_id\",\n \"assist_tackle_3_player_name\",\n \"assist_tackle_3_team\",\n \"assist_tackle_4_player_id\",\n \"assist_tackle_4_player_name\",\n \"assist_tackle_4_team\",\n # new for stat ID 80 -> tackle_with_assist\n \"tackle_with_assist\",\n \"tackle_with_assist_1_player_id\",\n \"tackle_with_assist_1_player_name\",\n \"tackle_with_assist_1_team\",\n \"tackle_with_assist_2_player_id\",\n \"tackle_with_assist_2_player_name\",\n \"tackle_with_assist_2_team\",\n\n \"pass_defense_1_player_id\",\n \"pass_defense_1_player_name\",\n \"pass_defense_2_player_id\",\n \"pass_defense_2_player_name\",\n \"fumbled_1_team\",\n \"fumbled_1_player_id\",\n \"fumbled_1_player_name\",\n \"fumbled_2_player_id\",\n \"fumbled_2_player_name\",\n \"fumbled_2_team\",\n \"fumble_recovery_1_team\",\n \"fumble_recovery_1_yards\",\n \"fumble_recovery_1_player_id\",\n \"fumble_recovery_1_player_name\",\n \"fumble_recovery_2_team\",\n \"fumble_recovery_2_yards\",\n \"fumble_recovery_2_player_id\",\n \"fumble_recovery_2_player_name\",\n \"td_team\",\n \"return_team\",\n \"timeout_team\",\n \"yards_gained\",\n \"return_yards\",\n \"air_yards\",\n \"yards_after_catch\",\n \"penalty_team\",\n \"penalty_player_id\",\n \"penalty_player_name\",\n \"penalty_yards\",\n \"kick_distance\",\n \"defensive_two_point_attempt\",\n \"defensive_two_point_conv\",\n \"defensive_extra_point_attempt\",\n \"defensive_extra_point_conv\",\n \"penalty_fix\",\n \"return_penalty_fix\",\n #new in nflfastR v4.0\n \"rushing_yards\",\n \"lateral_rushing_yards\",\n \"passing_yards\",\n \"receiving_yards\",\n \"lateral_receiving_yards\",\n # new in nflfastR v4.1\n \"td_player_id\",\n \"td_player_name\",\n \"sack_player_id\",\n \"sack_player_name\",\n \"half_sack_1_player_id\",\n \"half_sack_1_player_name\",\n \"half_sack_2_player_id\",\n \"half_sack_2_player_name\",\n # new in nflfastR > v4.1\n \"safety_player_name\",\n \"safety_player_id\"\n )\n\nindicator_stats <- c(\n \"punt_blocked\",\n \"first_down_rush\",\n \"first_down_pass\",\n \"first_down_penalty\",\n \"third_down_converted\",\n \"third_down_failed\",\n \"fourth_down_converted\",\n \"fourth_down_failed\",\n \"incomplete_pass\",\n \"interception\",\n \"punt_inside_twenty\",\n \"punt_in_endzone\",\n \"punt_out_of_bounds\",\n \"punt_downed\",\n \"punt_fair_catch\",\n \"kickoff_inside_twenty\",\n \"kickoff_in_endzone\",\n \"kickoff_out_of_bounds\",\n \"kickoff_fair_catch\",\n \"fumble_forced\",\n \"fumble_not_forced\",\n \"fumble_out_of_bounds\",\n \"timeout\",\n \"field_goal_missed\",\n \"field_goal_made\",\n \"field_goal_blocked\",\n \"extra_point_good\",\n \"extra_point_failed\",\n \"extra_point_blocked\",\n \"two_point_rush_good\",\n \"two_point_rush_failed\",\n \"two_point_pass_good\",\n \"two_point_pass_failed\",\n \"solo_tackle\",\n \"safety\",\n \"penalty\",\n \"tackled_for_loss\",\n \"extra_point_safety\",\n \"two_point_rush_safety\",\n \"two_point_pass_safety\",\n \"kickoff_downed\",\n \"two_point_pass_reception_good\",\n \"two_point_pass_reception_failed\",\n \"fumble_lost\",\n \"own_kickoff_recovery\",\n \"own_kickoff_recovery_td\",\n \"qb_hit\",\n \"extra_point_aborted\",\n \"two_point_return\",\n \"defensive_two_point_attempt\",\n \"defensive_two_point_conv\",\n \"defensive_extra_point_attempt\",\n \"defensive_extra_point_conv\",\n \"rush_attempt\",\n \"pass_attempt\",\n \"sack\",\n \"touchdown\",\n \"pass_touchdown\",\n \"rush_touchdown\",\n \"return_touchdown\",\n \"extra_point_attempt\",\n \"two_point_attempt\",\n \"field_goal_attempt\",\n \"kickoff_attempt\",\n \"punt_attempt\",\n \"fumble\",\n \"complete_pass\",\n \"assist_tackle\",\n # new for stat ID 80 -> tackle_with_assist\n \"tackle_with_assist\",\n\n \"lateral_reception\",\n \"lateral_rush\",\n \"lateral_return\",\n \"lateral_recovery\",\n \"penalty_fix\",\n \"yards_gained\",\n \"return_yards\",\n \"return_penalty_fix\"\n)\n"
},
{
"path": "data-raw/variable_list.txt",
"content": "#' \\item{play_id}{Numeric play id that when used with game_id and drive provides the unique identifier for a single play.}\n#' \\item{game_id}{Ten digit identifier for NFL game.}\n#' \\item{old_game_id}{Legacy NFL game ID.}\n#' \\item{home_team}{String abbreviation for the home team.}\n#' \\item{away_team}{String abbreviation for the away team.}\n#' \\item{season_type}{'REG' or 'POST' indicating if the game belongs to regular or post season.}\n#' \\item{week}{Season week.}\n#' \\item{posteam}{String abbreviation for the team with possession.}\n#' \\item{posteam_type}{String indicating whether the posteam team is home or away.}\n#' \\item{defteam}{String abbreviation for the team on defense.}\n#' \\item{side_of_field}{String abbreviation for which team's side of the field the team with possession is currently on.}\n#' \\item{yardline_100}{Numeric distance in the number of yards from the opponent's endzone for the posteam.}\n#' \\item{game_date}{Date of the game.}\n#' \\item{quarter_seconds_remaining}{Numeric seconds remaining in the quarter.}\n#' \\item{half_seconds_remaining}{Numeric seconds remaining in the half.}\n#' \\item{game_seconds_remaining}{Numeric seconds remaining in the game.}\n#' \\item{game_half}{String indicating which half the play is in, either Half1, Half2, or Overtime.}\n#' \\item{quarter_end}{Binary indicator for whether or not the row of the data is marking the end of a quarter.}\n#' \\item{drive}{Numeric drive number in the game.}\n#' \\item{sp}{Binary indicator for whether or not a score occurred on the play.}\n#' \\item{qtr}{Quarter of the game (5 is overtime).}\n#' \\item{down}{The down for the given play.}\n#' \\item{goal_to_go}{Binary indicator for whether or not the posteam is in a goal down situation.}\n#' \\item{time}{Time at start of play provided in string format as minutes:seconds remaining in the quarter.}\n#' \\item{yrdln}{String indicating the current field position for a given play.}\n#' \\item{ydstogo}{Numeric yards in distance from either the first down marker or the endzone in goal down situations.}\n#' \\item{ydsnet}{Numeric value for total yards gained on the given drive.}\n#' \\item{desc}{Detailed string description for the given play.}\n#' \\item{play_type}{String indicating the type of play: pass (includes sacks), run (includes scrambles), punt, field_goal, kickoff, extra_point, qb_kneel, qb_spike, no_play (timeouts and penalties), and missing for rows indicating end of play.}\n#' \\item{yards_gained}{Numeric yards gained (or lost) by the possessing team, excluding yards gained via fumble recoveries and laterals.}\n#' \\item{shotgun}{Binary indicator for whether or not the play was in shotgun formation.}\n#' \\item{no_huddle}{Binary indicator for whether or not the play was in no_huddle formation.}\n#' \\item{qb_dropback}{Binary indicator for whether or not the QB dropped back on the play (pass attempt, sack, or scrambled).}\n#' \\item{qb_kneel}{Binary indicator for whether or not the QB took a knee.}\n#' \\item{qb_spike}{Binary indicator for whether or not the QB spiked the ball.}\n#' \\item{qb_scramble}{Binary indicator for whether or not the QB scrambled.}\n#' \\item{pass_length}{String indicator for pass length: short or deep.}\n#' \\item{pass_location}{String indicator for pass location: left, middle, or right.}\n#' \\item{air_yards}{Numeric value for distance in yards perpendicular to the line of scrimmage at where the targeted receiver either caught or didn't catch the ball.}\n#' \\item{yards_after_catch}{Numeric value for distance in yards perpendicular to the yard line where the receiver made the reception to where the play ended.}\n#' \\item{run_location}{String indicator for location of run: left, middle, or right.}\n#' \\item{run_gap}{String indicator for line gap of run: end, guard, or tackle}\n#' \\item{field_goal_result}{String indicator for result of field goal attempt: made, missed, or blocked.}\n#' \\item{kick_distance}{Numeric distance in yards for kickoffs, field goals, and punts.}\n#' \\item{extra_point_result}{String indicator for the result of the extra point attempt: good, failed, blocked, safety (touchback in defensive endzone is 1 point apparently), or aborted.}\n#' \\item{two_point_conv_result}{String indicator for result of two point conversion attempt: success, failure, safety (touchback in defensive endzone is 1 point apparently), or return.}\n#' \\item{home_timeouts_remaining}{Numeric timeouts remaining in the half for the home team.}\n#' \\item{away_timeouts_remaining}{Numeric timeouts remaining in the half for the away team.}\n#' \\item{timeout}{Binary indicator for whether or not a timeout was called by either team.}\n#' \\item{timeout_team}{String abbreviation for which team called the timeout.}\n#' \\item{td_team}{String abbreviation for which team scored the touchdown.}\n#' \\item{td_player_name}{String name of the player who scored a touchdown.}\n#' \\item{td_player_id}{Unique identifier of the player who scored a touchdown.}\n#' \\item{posteam_timeouts_remaining}{Number of timeouts remaining for the possession team.}\n#' \\item{defteam_timeouts_remaining}{Number of timeouts remaining for the team on defense.}\n#' \\item{total_home_score}{Score for the home team at the end of the play.}\n#' \\item{total_away_score}{Score for the away team at the end of the play.}\n#' \\item{posteam_score}{Score the posteam at the start of the play.}\n#' \\item{defteam_score}{Score the defteam at the start of the play.}\n#' \\item{score_differential}{Score differential between the posteam and defteam at the start of the play.}\n#' \\item{posteam_score_post}{Score for the posteam at the end of the play.}\n#' \\item{defteam_score_post}{Score for the defteam at the end of the play.}\n#' \\item{score_differential_post}{Score differential between the posteam and defteam at the end of the play.}\n#' \\item{no_score_prob}{Predicted probability of no score occurring for the rest of the half based on the expected points model.}\n#' \\item{opp_fg_prob}{Predicted probability of the defteam scoring a FG next.}\n#' \\item{opp_safety_prob}{Predicted probability of the defteam scoring a safety next.}\n#' \\item{opp_td_prob}{Predicted probability of the defteam scoring a TD next.}\n#' \\item{fg_prob}{Predicted probability of the posteam scoring a FG next.}\n#' \\item{safety_prob}{Predicted probability of the posteam scoring a safety next.}\n#' \\item{td_prob}{Predicted probability of the posteam scoring a TD next.}\n#' \\item{extra_point_prob}{Predicted probability of the posteam scoring an extra point.}\n#' \\item{two_point_conversion_prob}{Predicted probability of the posteam scoring the two point conversion.}\n#' \\item{ep}{Using the scoring event probabilities, the estimated expected points with respect to the possession team for the given play.}\n#' \\item{epa}{Expected points added (EPA) by the posteam for the given play.}\n#' \\item{total_home_epa}{Cumulative total EPA for the home team in the game so far.}\n#' \\item{total_away_epa}{Cumulative total EPA for the away team in the game so far.}\n#' \\item{total_home_rush_epa}{Cumulative total rushing EPA for the home team in the game so far.}\n#' \\item{total_away_rush_epa}{Cumulative total rushing EPA for the away team in the game so far.}\n#' \\item{total_home_pass_epa}{Cumulative total passing EPA for the home team in the game so far.}\n#' \\item{total_away_pass_epa}{Cumulative total passing EPA for the away team in the game so far.}\n#' \\item{air_epa}{EPA from the air yards alone. For completions this represents the actual value provided through the air. For incompletions this represents the hypothetical value that could've been added through the air if the pass was completed.}\n#' \\item{yac_epa}{EPA from the yards after catch alone. For completions this represents the actual value provided after the catch. For incompletions this represents the difference between the hypothetical air_epa and the play's raw observed EPA (how much the incomplete pass cost the posteam).}\n#' \\item{comp_air_epa}{EPA from the air yards alone only for completions.}\n#' \\item{comp_yac_epa}{EPA from the yards after catch alone only for completions.}\n#' \\item{total_home_comp_air_epa}{Cumulative total completions air EPA for the home team in the game so far.}\n#' \\item{total_away_comp_air_epa}{Cumulative total completions air EPA for the away team in the game so far.}\n#' \\item{total_home_comp_yac_epa}{Cumulative total completions yac EPA for the home team in the game so far.}\n#' \\item{total_away_comp_yac_epa}{Cumulative total completions yac EPA for the away team in the game so far.}\n#' \\item{total_home_raw_air_epa}{Cumulative total raw air EPA for the home team in the game so far.}\n#' \\item{total_away_raw_air_epa}{Cumulative total raw air EPA for the away team in the game so far.}\n#' \\item{total_home_raw_yac_epa}{Cumulative total raw yac EPA for the home team in the game so far.}\n#' \\item{total_away_raw_yac_epa}{Cumulative total raw yac EPA for the away team in the game so far.}\n#' \\item{wp}{Estimated win probabiity for the posteam given the current situation at the start of the given play.}\n#' \\item{def_wp}{Estimated win probability for the defteam.}\n#' \\item{home_wp}{Estimated win probability for the home team.}\n#' \\item{away_wp}{Estimated win probability for the away team.}\n#' \\item{wpa}{Win probability added (WPA) for the posteam.}\n#' \\item{vegas_wpa}{Win probability added (WPA) for the posteam: spread_adjusted model.}\n#' \\item{vegas_home_wpa}{Win probability added (WPA) for the home team: spread_adjusted model.}\n#' \\item{home_wp_post}{Estimated win probability for the home team at the end of the play.}\n#' \\item{away_wp_post}{Estimated win probability for the away team at the end of the play.}\n#' \\item{vegas_wp}{Estimated win probabiity for the posteam given the current situation at the start of the given play, incorporating pre-game Vegas line.}\n#' \\item{vegas_home_wp}{Estimated win probability for the home team incorporating pre-game Vegas line.}\n#' \\item{total_home_rush_wpa}{Cumulative total rushing WPA for the home team in the game so far.}\n#' \\item{total_away_rush_wpa}{Cumulative total rushing WPA for the away team in the game so far.}\n#' \\item{total_home_pass_wpa}{Cumulative total passing WPA for the home team in the game so far.}\n#' \\item{total_away_pass_wpa}{Cumulative total passing WPA for the away team in the game so far.}\n#' \\item{air_wpa}{WPA through the air (same logic as air_epa).}\n#' \\item{yac_wpa}{WPA from yards after the catch (same logic as yac_epa).}\n#' \\item{comp_air_wpa}{The air_wpa for completions only.}\n#' \\item{comp_yac_wpa}{The yac_wpa for completions only.}\n#' \\item{total_home_comp_air_wpa}{Cumulative total completions air WPA for the home team in the game so far.}\n#' \\item{total_away_comp_air_wpa}{Cumulative total completions air WPA for the away team in the game so far.}\n#' \\item{total_home_comp_yac_wpa}{Cumulative total completions yac WPA for the home team in the game so far.}\n#' \\item{total_away_comp_yac_wpa}{Cumulative total completions yac WPA for the away team in the game so far.}\n#' \\item{total_home_raw_air_wpa}{Cumulative total raw air WPA for the home team in the game so far.}\n#' \\item{total_away_raw_air_wpa}{Cumulative total raw air WPA for the away team in the game so far.}\n#' \\item{total_home_raw_yac_wpa}{Cumulative total raw yac WPA for the home team in the game so far.}\n#' \\item{total_away_raw_yac_wpa}{Cumulative total raw yac WPA for the away team in the game so far.}\n#' \\item{punt_blocked}{Binary indicator for if the punt was blocked.}\n#' \\item{first_down_rush}{Binary indicator for if a running play converted the first down.}\n#' \\item{first_down_pass}{Binary indicator for if a passing play converted the first down.}\n#' \\item{first_down_penalty}{Binary indicator for if a penalty converted the first down.}\n#' \\item{third_down_converted}{Binary indicator for if the first down was converted on third down.}\n#' \\item{third_down_failed}{Binary indicator for if the posteam failed to convert first down on third down.}\n#' \\item{fourth_down_converted}{Binary indicator for if the first down was converted on fourth down.}\n#' \\item{fourth_down_failed}{Binary indicator for if the posteam failed to convert first down on fourth down.}\n#' \\item{incomplete_pass}{Binary indicator for if the pass was incomplete.}\n#' \\item{touchback}{Binary indicator for if a touchback occurred on the play.}\n#' \\item{interception}{Binary indicator for if the pass was intercepted.}\n#' \\item{punt_inside_twenty}{Binary indicator for if the punt ended inside the twenty yard line.}\n#' \\item{punt_in_endzone}{Binary indicator for if the punt was in the endzone.}\n#' \\item{punt_out_of_bounds}{Binary indicator for if the punt went out of bounds.}\n#' \\item{punt_downed}{Binary indicator for if the punt was downed.}\n#' \\item{punt_fair_catch}{Binary indicator for if the punt was caught with a fair catch.}\n#' \\item{kickoff_inside_twenty}{Binary indicator for if the kickoff ended inside the twenty yard line.}\n#' \\item{kickoff_in_endzone}{Binary indicator for if the kickoff was in the endzone.}\n#' \\item{kickoff_out_of_bounds}{Binary indicator for if the kickoff went out of bounds.}\n#' \\item{kickoff_downed}{Binary indicator for if the kickoff was downed.}\n#' \\item{kickoff_fair_catch}{Binary indicator for if the kickoff was caught with a fair catch.}\n#' \\item{fumble_forced}{Binary indicator for if the fumble was forced.}\n#' \\item{fumble_not_forced}{Binary indicator for if the fumble was not forced.}\n#' \\item{fumble_out_of_bounds}{Binary indicator for if the fumble went out of bounds.}\n#' \\item{solo_tackle}{Binary indicator if the play had a solo tackle (could be multiple due to fumbles).}\n#' \\item{safety}{Binary indicator for whether or not a safety occurred.}\n#' \\item{penalty}{Binary indicator for whether or not a penalty occurred.}\n#' \\item{tackled_for_loss}{Binary indicator for whether or not a tackle for loss on a run play occurred.}\n#' \\item{fumble_lost}{Binary indicator for if the fumble was lost.}\n#' \\item{own_kickoff_recovery}{Binary indicator for if the kicking team recovered the kickoff.}\n#' \\item{own_kickoff_recovery_td}{Binary indicator for if the kicking team recovered the kickoff and scored a TD.}\n#' \\item{qb_hit}{Binary indicator if the QB was hit on the play.}\n#' \\item{rush_attempt}{Binary indicator for if the play was a run.}\n#' \\item{pass_attempt}{Binary indicator for if the play was a pass attempt (includes sacks).}\n#' \\item{sack}{Binary indicator for if the play ended in a sack.}\n#' \\item{touchdown}{Binary indicator for if the play resulted in a TD.}\n#' \\item{pass_touchdown}{Binary indicator for if the play resulted in a passing TD.}\n#' \\item{rush_touchdown}{Binary indicator for if the play resulted in a rushing TD.}\n#' \\item{return_touchdown}{Binary indicator for if the play resulted in a return TD.}\n#' \\item{extra_point_attempt}{Binary indicator for extra point attempt.}\n#' \\item{two_point_attempt}{Binary indicator for two point conversion attempt.}\n#' \\item{field_goal_attempt}{Binary indicator for field goal attempt.}\n#' \\item{kickoff_attempt}{Binary indicator for kickoff.}\n#' \\item{punt_attempt}{Binary indicator for punts.}\n#' \\item{fumble}{Binary indicator for if a fumble occurred.}\n#' \\item{complete_pass}{Binary indicator for if the pass was completed.}\n#' \\item{assist_tackle}{Binary indicator for if an assist tackle occurred.}\n#' \\item{lateral_reception}{Binary indicator for if a lateral occurred on the reception.}\n#' \\item{lateral_rush}{Binary indicator for if a lateral occurred on a run.}\n#' \\item{lateral_return}{Binary indicator for if a lateral occurred on a return.}\n#' \\item{lateral_recovery}{Binary indicator for if a lateral occurred on a fumble recovery.}\n#' \\item{passer_player_id}{Unique identifier for the player that attempted the pass.}\n#' \\item{passer_player_name}{String name for the player that attempted the pass.}\n#' \\item{passing_yards}{Numeric yards by the passer_player_name, including yards gained in pass plays with laterals. This should equal official passing statistics.}\n#' \\item{receiver_player_id}{Unique identifier for the receiver that was targeted on the pass.}\n#' \\item{receiver_player_name}{String name for the targeted receiver.}\n#' \\item{receiving_yards}{Numeric yards by the receiver_player_name, excluding yards gained in pass plays with laterals. This should equal official receiving statistics but could miss yards gained in pass plays with laterals. Please see the description of `lateral_receiver_player_name` for further information.}\n#' \\item{rusher_player_id}{Unique identifier for the player that attempted the run.}\n#' \\item{rusher_player_name}{String name for the player that attempted the run.}\n#' \\item{rushing_yards}{Numeric yards by the rusher_player_name, excluding yards gained in rush plays with laterals. This should equal official rushing statistics but could miss yards gained in rush plays with laterals. Please see the description of `lateral_rusher_player_name` for further information.}\n#' \\item{lateral_receiver_player_id}{Unique identifier for the player that received the last(!) lateral on a pass play.}\n#' \\item{lateral_receiver_player_name}{String name for the player that received the last(!) lateral on a pass play. If there were multiple laterals in the same play, this will only be the last player who received a lateral. Please see }}\\preformatted{future::plan(\"multisession\")\nload_pbp(2018:2020)\nbuild_nflfastR_pbp(c(\"2018_21_NE_LA\", \"2019_21_SF_KC\"))\n}\\if{html}{\\out{
}}\n\nWe recommend choosing a default parallel processing method and saving it\nas an environment variable in the R user profile to make sure all futures\nwill be resolved with the chosen method by default.\nThis can be done by following the below given steps.\n\nFirst, run the following line and the file \\code{.Renviron} should be opened automatically.\nIf you haven't saved any environment variables yet, this will be an empty file.\n\n\\if{html}{\\out{}}\\preformatted{usethis::edit_r_environ()\n}\\if{html}{\\out{
}}\n\nIn the opened file \\code{.Renviron} add the next line, then save the file and restart your R session.\nPlease note that this example sets \"multisession\" as default. For most users\nthis should be the appropriate plan but please make sure it truly is.\n\n\\if{html}{\\out{}}\\preformatted{R_FUTURE_PLAN=\"multisession\"\n}\\if{html}{\\out{
}}\n\nAfter the session is freshly restarted please check if the above method worked\nby running the next line. If the output is \\code{FALSE} you successfully set up a\ndefault non-sequential \\code{\\link[future:plan]{future::plan()}}. If the output is \\code{TRUE} all functions\nwill behave like they were called with \\code{\\link[purrr:map]{purrr::map()}} and NOT in multisession.\n\n\\if{html}{\\out{}}\\preformatted{inherits(future::plan(), \"sequential\")\n}\\if{html}{\\out{
}}\n\nFor more information on possible plans please see\n\\href{https://github.com/futureverse/future/blob/develop/README.md}{the future package Readme}.\n\nFor more information on \\code{.Renviron} please see\n\\href{https://rstats.wtf/r-startup.html}{this book chapter}.\n}\n\n\\subsection{Get Progress Updates while Functions are Running}{\n\nMost nflfastR functions are able to show progress updates\nusing \\code{\\link[progressr:progressor]{progressr::progressor()}} if they are turned on before the function is\ncalled. There are at least two basic ways to do this by either activating\nprogress updates globally (for the current session) with\n\n\\if{html}{\\out{}}\\preformatted{progressr::handlers(global = TRUE)\n}\\if{html}{\\out{
}}\n\nor by piping the function call into \\code{\\link[progressr:with_progress]{progressr::with_progress()}}:\n\n\\if{html}{\\out{}}\\preformatted{load_pbp(2018:2020) |>\n progressr::with_progress()\n}\\if{html}{\\out{
}}\n\nJust like in the previous section, it is possible to activate global\nprogression handlers by default. This can be done by following the below given steps.\n\nFirst, run the following line and the file \\code{.Rprofile} should be opened automatically.\nIf you haven't saved any code yet, this will be an empty file.\n\n\\if{html}{\\out{}}\\preformatted{usethis::edit_r_profile()\n}\\if{html}{\\out{
}}\n\nIn the opened file \\code{.Rprofile} add the next line, then save the file and restart your R\nsession. All code in this file will be executed when a new R session starts.\nThe part \\verb{if (require(\"progressr\"))} makes sure this will only run if the\npackage progressr is installed to avoid crashing R sessions.\n\n\\if{html}{\\out{}}\\preformatted{if (requireNamespace(\"progressr\", quietly = TRUE)) progressr::handlers(global = TRUE)\n}\\if{html}{\\out{
}}\n\nAfter the session is freshly restarted please check if the above method worked\nby running the next line. If the output is \\code{TRUE} you successfully activated\nglobal progression handlers for all sessions.\n\n\\if{html}{\\out{}}\\preformatted{progressr::handlers(global = NA)\n}\\if{html}{\\out{
}}\n\nFor more information how to work with progress handlers please see \\link[progressr:progressr]{progressr::progressr}.\n\nFor more information on \\code{.Rprofile} please see\n\\href{https://rstats.wtf/r-startup.html}{this book chapter}.\n}\n}\n\n\\seealso{\nUseful links:\n\\itemize{\n \\item \\url{https://nflfastr.com/}\n \\item \\url{https://github.com/nflverse/nflfastR}\n \\item Report bugs at \\url{https://github.com/nflverse/nflfastR/issues}\n}\n\n}\n\\author{\n\\strong{Maintainer}: Ben Baldwin \\email{bbaldwin206@gmail.com}\n\nAuthors:\n\\itemize{\n \\item Sebastian Carl \\email{mrcaseb@gmail.com}\n}\n\nOther contributors:\n\\itemize{\n \\item Lee Sharpe [contributor]\n \\item Maksim Horowitz \\email{maksim.horowitz@gmail.com} [contributor]\n \\item Ron Yurko \\email{ryurko@stat.cmu.edu} [contributor]\n \\item Samuel Ventura \\email{samventura22@gmail.com} [contributor]\n \\item Tan Ho [contributor]\n \\item John Edwards \\email{edwards1860@gmail.com} [contributor]\n}\n\n}\n"
},
{
"path": "man/reexports.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/nflfastR-package.R\n\\docType{import}\n\\name{reexports}\n\\alias{reexports}\n\\alias{load_pbp}\n\\alias{load_player_stats}\n\\alias{load_team_stats}\n\\alias{load_schedules}\n\\alias{load_rosters}\n\\alias{nflverse_sitrep}\n\\alias{most_recent_season}\n\\title{Objects exported from other packages}\n\\keyword{internal}\n\\description{\nThese objects are imported from other packages. Follow the links\nbelow to see their documentation.\n\n\\describe{\n \\item{nflreadr}{\\code{\\link[nflreadr]{load_pbp}}, \\code{\\link[nflreadr]{load_player_stats}}, \\code{\\link[nflreadr]{load_rosters}}, \\code{\\link[nflreadr]{load_schedules}}, \\code{\\link[nflreadr]{load_team_stats}}, \\code{\\link[nflreadr:latest_season]{most_recent_season}}, \\code{\\link[nflreadr:sitrep]{nflverse_sitrep}}}\n}}\n\n"
},
{
"path": "man/report.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/report.R\n\\name{report}\n\\alias{report}\n\\title{Get a Situation Report on System, nflverse Package Versions and Dependencies}\n\\usage{\nreport(...)\n}\n\\arguments{\n\\item{...}{\n Arguments passed on to \\code{\\link[nflreadr:sitrep]{nflreadr::nflverse_sitrep}}\n \\describe{\n \\item{\\code{pkg}}{a character vector naming installed packages, or \\code{NULL}\n(the default) meaning all nflverse packages. The function checks internally\nif all packages are installed and informs if that is not the case.}\n \\item{\\code{recursive}}{a logical indicating whether dependencies of \\code{pkg} and their\ndependencies (and so on) should be included.\nCan also be a character vector listing the types of dependencies, a subset\nof \\code{c(\"Depends\", \"Imports\", \"LinkingTo\", \"Suggests\", \"Enhances\")}.\nCharacter string \\code{\"all\"} is shorthand for that vector, character string\n\\code{\"most\"} for the same vector without \\code{\"Enhances\"}, character string \\code{\"strong\"}\n(default) for the first three elements of that vector.}\n \\item{\\code{redact_path}}{a logical indicating whether options that contain \"path\"\nin the name should be redacted, default = TRUE}\n }}\n}\n\\description{\n\\ifelse{html}{\\href{https://lifecycle.r-lib.org/articles/stages.html#deprecated}{\\figure{lifecycle-deprecated.svg}{options: alt='[Deprecated]'}}}{\\strong{[Deprecated]}}\n\nThis function was deprecated. Please use \\code{\\link[nflreadr:sitrep]{nflreadr::nflverse_sitrep}}.\n\nThis function gives a quick overview of the versions of R and\nthe operating system as well as the versions of nflverse packages, options,\nand their dependencies. It's primarily designed to help you get a quick\nidea of what's going on when you're helping someone else debug a problem.\n}\n\\details{\nSee \\code{\\link[nflreadr:sitrep]{nflreadr::nflverse_sitrep}} for details.\n}\n\\examples{\n\\donttest{\n\\dontshow{\n# set CRAN mirror to avoid failing checks in weird scenarios\nold_ops <- options(repos = c(\"CRAN\" = \"https://cran.rstudio.com/\"))\n}\n\n# report(recursive = FALSE)\nnflverse_sitrep(pkg = \"nflreadr\", recursive = TRUE)\n\n\\dontshow{\n# restore old options\noptions(old_ops)\n}\n}\n}\n\\keyword{internal}\n"
},
{
"path": "man/save_raw_pbp.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/save_raw_pbp.R\n\\name{save_raw_pbp}\n\\alias{save_raw_pbp}\n\\title{Download Raw PBP Data to Local Filesystem}\n\\usage{\nsave_raw_pbp(\n game_ids,\n dir = getOption(\"nflfastR.raw_directory\", default = NULL)\n)\n}\n\\arguments{\n\\item{game_ids}{A vector of nflverse game IDs.}\n\n\\item{dir}{Path to local directory (defaults to option \"nflfastR.raw_directory\").\nnflfastR will download the raw game files split by season into one sub\ndirectory per season.}\n}\n\\value{\nThe function returns a data frame with one row for each downloaded file and\nthe following columns:\n\\itemize{\n\\item \\code{success} if the HTTP request was successfully performed, regardless of the\nresponse status code. This is \\code{FALSE} in case of a network error, or in case\nyou tried to resume from a server that did not support this. A value of \\code{NA}\nmeans the download was interrupted while in progress.\n\\item \\code{status_code} the HTTP status code from the request. A successful download is\nusually \\code{200} for full requests or \\code{206} for resumed requests. Anything else\ncould indicate that the downloaded file contains an error page instead of the\nrequested content.\n\\item \\code{resumefrom} the file size before the request, in case a download was resumed.\n\\item \\code{url} final url (after redirects) of the request.\n\\item \\code{destfile} downloaded file on disk.\n\\item \\code{error} if \\code{success == FALSE} this column contains an error message.\n\\item \\code{type} the \\code{Content-Type} response header value.\n\\item \\code{modified} the \\code{Last-Modified} response header value.\n\\item \\code{time} total elapsed download time for this file in seconds.\n\\item \\code{headers} vector with http response headers for the request.\n}\n}\n\\description{\nThe functions \\code{\\link[=build_nflfastR_pbp]{build_nflfastR_pbp()}} and \\code{\\link[=fast_scraper]{fast_scraper()}} support loading\nraw pbp data from local file systems instead of Github servers.\nThis function is intended to help setting this up. It loads raw pbp data\nand saves it in the given directory split by season in subdirectories.\n}\n\\examples{\n\\donttest{\n# CREATE LOCAL TEMP DIRECTORY\nlocal_dir <- tempdir()\n\n# LOAD AND SAVE A GAME TO TEMP DIRECTORY\nsave_raw_pbp(\"2021_20_BUF_KC\", dir = local_dir)\n\n# REMOVE THE DIRECTORY\nunlink(file.path(local_dir, 2021))\n}\n}\n\\seealso{\n\\code{\\link[=build_nflfastR_pbp]{build_nflfastR_pbp()}}, \\code{\\link[=missing_raw_pbp]{missing_raw_pbp()}}\n}\n"
},
{
"path": "man/stat_ids.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/data_documentation.R\n\\docType{data}\n\\name{stat_ids}\n\\alias{stat_ids}\n\\title{NFL Stat IDs and their Meanings}\n\\format{\nA data frame including NFL stat IDs, names and descriptions used in\nan nflfastR dataset.\n}\n\\source{\n\\url{http://www.nflgsis.com/gsis/Documentation/Partners/StatIDs.html}\n}\n\\usage{\nstat_ids\n}\n\\description{\nNFL Stat IDs and their Meanings\n}\n\\examples{\n\\donttest{\nstat_ids\n}\n}\n\\keyword{datasets}\n"
},
{
"path": "man/teams_colors_logos.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/data_documentation.R\n\\docType{data}\n\\name{teams_colors_logos}\n\\alias{teams_colors_logos}\n\\title{NFL Team names, colors and logo urls.}\n\\format{\nA data frame with 36 rows and 10 variables containing NFL team level\ninformation, including franchises in multiple cities:\n\\describe{\n\\item{team_abbr}{Team abbreviation}\n\\item{team_name}{Complete Team name}\n\\item{team_id}{Team id used in the roster function}\n\\item{team_nick}{Nickname}\n\\item{team_conf}{Conference}\n\\item{team_division}{Division}\n\\item{team_color}{Primary color}\n\\item{team_color2}{Secondary color}\n\\item{team_color3}{Tertiary color}\n\\item{team_color4}{Quaternary color}\n\\item{team_logo_wikipedia}{Url to Team logo on wikipedia}\n\\item{team_logo_espn}{Url to higher quality logo on espn}\n\\item{team_wordmark}{Url to team wordmarks}\n\\item{team_conference_logo}{Url to AFC and NFC logos}\n\\item{team_league_logo}{Url to NFL logo}\n}\nThe primary and secondary colors have been taken from nfl.com with some modifications\nfor better team distinction and most recent team color themes.\nThe tertiary and quaternary colors are taken from Lee Sharpe's teamcolors.csv\nwho has taken them from the \\code{teamcolors} package created by Ben Baumer and\nGregory Matthews. The Wikipeadia logo urls are taken from Lee Sharpe's logos.csv\nTeam wordmarks from nfl.com\n}\n\\usage{\nteams_colors_logos\n}\n\\description{\nNFL Team names, colors and logo urls.\n}\n\\examples{\n\\donttest{\nteams_colors_logos\n}\n}\n\\keyword{datasets}\n"
},
{
"path": "man/update_db.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/helper_database_functions.R\n\\name{update_db}\n\\alias{update_db}\n\\title{Update or Create a nflfastR Play-by-Play Database}\n\\usage{\nupdate_db(\n dbdir = getOption(\"nflfastR.dbdirectory\", default = \".\"),\n dbname = \"pbp_db\",\n tblname = \"nflfastR_pbp\",\n force_rebuild = FALSE,\n db_connection = NULL\n)\n}\n\\arguments{\n\\item{dbdir}{Directory in which the database is or shall be located. Can also\nbe set globally with \\code{options(nflfastR.dbdirectory)}}\n\n\\item{dbname}{File name of an existing or desired SQLite database within \\code{dbdir}}\n\n\\item{tblname}{The name of the play by play data table within the database}\n\n\\item{force_rebuild}{Hybrid parameter (logical or numeric) to rebuild parts\nof or the complete play by play data table within the database (please see details for further information)}\n\n\\item{db_connection}{A \\code{DBIConnection} object, as returned by\n\\code{\\link[DBI:dbConnect]{DBI::dbConnect()}} (please see details for further information)}\n}\n\\description{\n\\code{update_db} updates or creates a database with \\code{nflfastR}\nplay by play data of all completed games since 1999.\n}\n\\details{\nThis function creates and updates a data table with the name \\code{tblname}\nwithin a SQLite database (other drivers via \\code{db_connection}) located in\n\\code{dbdir} and named \\code{dbname}.\nThe data table combines all play by play data for every available game back\nto the 1999 season and adds the most recent completed games as soon as they\nare available for \\code{nflfastR}.\n\nThe argument \\code{force_rebuild} is of hybrid type. It can rebuild the play\nby play data table either for the whole nflfastR era (with \\code{force_rebuild = TRUE})\nor just for specified seasons (e.g. \\code{force_rebuild = c(2019, 2020)}).\nPlease note the following behavior:\n\\itemize{\n\\item \\code{force_rebuild = TRUE}: The data table with the name \\code{tblname}\nwill be removed completely and rebuilt from scratch. This is helpful when\nnew columns are added during the Off-Season.\n\\item \\code{force_rebuild = c(2019, 2020)}: The data table with the name \\code{tblname}\nwill be preserved and only rows from the 2019 and 2020 seasons will be\ndeleted and re-added. This is intended to be used for ongoing seasons because\nthe NFL fixes bugs in the underlying data during the week and we recommend\nrebuilding the current season every Thursday during the season.\n}\n\nThe parameter \\code{db_connection} is intended for advanced users who want\nto use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that\nthe arguments \\code{dbdir} and \\code{dbname} are dropped in case a \\code{db_connection}\nis provided but the argument \\code{tblname} will still be used to write the\ndata table into the database.\n}\n"
},
{
"path": "man/update_pbp_db.Rd",
"content": "% Generated by roxygen2: do not edit by hand\n% Please edit documentation in R/database.R\n\\name{update_pbp_db}\n\\alias{update_pbp_db}\n\\title{Update or Create a nflverse Play-by-Play Data Table in a Connected Database}\n\\usage{\nupdate_pbp_db(conn, ..., name = \"nflverse_pbp\", seasons = most_recent_season())\n}\n\\arguments{\n\\item{conn}{A \\code{DBIConnection} object, as returned by \\code{\\link[DBI:dbConnect]{DBI::dbConnect()}}}\n\n\\item{...}{These dots are for future extensions and must be empty.}\n\n\\item{name}{The table name, passed on to \\code{\\link[DBI:dbQuoteIdentifier]{dbQuoteIdentifier()}}. Options are:\n\\itemize{\n\\item a character string with the unquoted DBMS table name,\ne.g. \\code{\"table_name\"},\n\\item a call to \\code{\\link[DBI:Id]{Id()}} with components to the fully qualified table name,\ne.g. \\code{Id(schema = \"my_schema\", table = \"table_name\")}\n\\item a call to \\code{\\link[DBI:SQL]{SQL()}} with the quoted and fully qualified table name\ngiven verbatim, e.g. \\code{SQL('\"my_schema\".\"table_name\"')}\n}}\n\n\\item{seasons}{Hybrid argument (logical or numeric) to update parts\nof or the complete play by play table within the database.\n\nIt can update the play by play data table either for the whole nflfastR era\n(with \\code{seasons = TRUE}) or just for specified seasons\n(e.g. \\code{seasons = 2024:2025}).\n\nDefaults to \\link{most_recent_season}. Please see details for further information.}\n}\n\\value{\nAlways returns the database connection invisibly.\n}\n\\description{\nThe nflfastR play-by-play era dates back to 1999. To analyze all the data\nefficiently, there is practically no alternative to working with a database.\n\nThis function helps to create and maintain a table containing all\nplay-by-play data of the nflfastR era in a connected database.\nPrimarily, the preprocessed data from \\link{load_pbp} is written to the database\nand, if necessary, supplemented with the latest games using\n\\link{build_nflfastR_pbp}.\n}\n\\details{\n\\subsection{The \\code{seasons} argument}{\n\nThe \\code{seasons} argument controls how the table in the connected database is\nhandled.\n\nWith \\code{seasons = TRUE}, the table in argument \\code{name} will be removed completely\n(by calling \\link[DBI:dbRemoveTable]{DBI::dbRemoveTable}) and all seasons of the nflfastR era will be\nadded to a fresh table. This is helpful when new columns are added during the\noffseason.\n\nWith a numerical vector, e.g. \\code{seasons = 2024:2025}, the table in argument\n\\code{name} will be preserved and only rows from the given seasons will be deleted\nand re-added (by calling \\link[DBI:dbAppendTable]{DBI::dbAppendTable}). This is intended to be used\nfor ongoing seasons because the NFL fixes bugs in the underlying data during\nthe week and we recommend rebuilding the current season every Thursday during\nthe season.\n\nThe default behavior is \\code{seasons = most_recent_season()}, which means that\nonly the most recent season is updated or added.\n\nTo keep the table, and thus also the schema, but update all play-by-play\ndata of the nflfastR era, set\n\n\\if{html}{\\out{}}\\preformatted{seasons = seq(1999, most_recent_season())\n}\\if{html}{\\out{
}}\n\nIf \\code{seasons} contains multiple seasons, it is possible to control whether the\nseasons are loaded individually and written to the database, or whether\nmultiple seasons should be processed in chunks. The latter is more efficient\nbecause fewer write operations are required, but at the same time, the data\nmust first be stored in memory. The option \\verb{“nflfastR.db_chunk_size”} can\nbe used to control how many seasons are loaded together in a chunk and\nwritten to the database. With the following option, for example, 5 seasons\nare always loaded together and written to the database.\n\n\\if{html}{\\out{}}\\preformatted{options(\"nflfastR.db_chunk_size\" = 5L)\n}\\if{html}{\\out{
}}\n}\n}\n\\examples{\n\\donttest{\ncon <- DBI::dbConnect(duckdb::duckdb())\ntry({# to avoid CRAN test problems\nupdate_pbp_db(con, seasons = 2024)\n})\n}\n}\n"
},
{
"path": "nflfastR.Rproj",
"content": "Version: 1.0\nProjectId: e1e14382-386c-49b3-9b3f-206a4cc98503\n\nRestoreWorkspace: Default\nSaveWorkspace: Default\nAlwaysSaveHistory: Default\n\nEnableCodeIndexing: Yes\nUseSpacesForTab: Yes\nNumSpacesForTab: 2\nEncoding: UTF-8\n\nRnwWeave: Sweave\nLaTeX: pdfLaTeX\n\nAutoAppendNewline: Yes\nStripTrailingWhitespace: Yes\n\nBuildType: Package\nPackageUseDevtools: Yes\nPackageInstallArgs: --no-multiarch --with-keep.source\nPackageRoxygenize: rd,collate,namespace\n\nUseNativePipeOperator: Yes\n"
},
{
"path": "pkgdown/_pkgdown.yml",
"content": "url: https://nflfastr.com/\n\ntemplate:\n bootstrap: 5\n light-switch: true\n bslib:\n font_scale: 1.1\n base_font: {google: \"Roboto\"}\n heading_font: {google: \"Kanit\"}\n code_font: {google: \"Fira Code\"}\n opengraph:\n image:\n src: man/figures/card.png\n alt: \"nflfastR social preview card\"\n twitter:\n site: \"@nflfastR\"\n card: summary_large_image\n\ntoc:\n depth: 3\n\nauthors:\n Sebastian Carl:\n href: https://mrcaseb.com\n Ben Baldwin:\n href: https://bsky.app/profile/rbsdm.com\n Lee Sharpe:\n href: https://twitter.com/LeeSharpeNFL\n Maksim Horowitz:\n href: https://twitter.com/bklynmaks\n Ron Yurko:\n href: https://twitter.com/Stat_Ron\n Samuel Ventura:\n href: https://twitter.com/stat_sam\n Tan Ho:\n href: https://tanho.ca\n John Edwards:\n href: https://johnbedwards.io\nhome:\n title: An R package to quickly obtain clean and tidy NFL play by play data\n links:\n - text: nflverse Discord Chat\n href: https://discord.gg/5Er2FBnnQa\n - text: nflfastR Beginner's Guide\n href: articles/beginners_guide.html\n - text: nflfastR stats landing page\n href: https://rbsdm.com/stats/\n - text: Lee Sharpe's nfl game data\n href: https://nflgamedata.com\n\nnavbar:\n bg: dark\n type: light\n structure:\n left: [home, intro, reference, news, articles]\n right: [search, lightswitch, stats, games, discord, github, more]\n components:\n games:\n icon: \"fas fa-football-ball fa-lg\"\n href: http://nflgamedata.com/\n aria-label: Games\n stats:\n icon: \"fas fa-chart-line fa-lg\"\n href: https://rbsdm.com/stats/\n aria-label: Stats\n reference:\n text: \"Functions\"\n href: reference/index.html\n discord:\n icon: \"fab fa-discord fa-lg\"\n href: https://discord.com/invite/5Er2FBnnQa\n aria-label: Discord\n articles:\n text: \"Articles\"\n menu:\n - text: A beginner’s guide to nflfastR\n href: articles/beginners_guide.html\n - text: Field Descriptions\n href: articles/field_descriptions.html\n - text: Stats Variable Descriptions\n href: articles/stats_variables.html\n - text: nflfastR models\n href: https://www.opensourcefootball.com/posts/2020-09-28-nflfastr-ep-wp-and-cp-models/\n - text: Open Source Football\n href: https://www.opensourcefootball.com/\n more:\n text: \"Packages & More\"\n menu:\n - text: \"nflverse Packages\"\n - text: nflfastR\n href: https://nflfastr.com\n - text: nflseedR\n href: https://nflseedr.com\n - text: nfl4th\n href: https://www.nfl4th.com\n - text: nflreadr\n href: https://nflreadr.nflverse.com/\n - text: nflplotR\n href: https://nflplotr.nflverse.com/\n - text: nflverse\n href: https://nflverse.nflverse.com/\n - text: \"Open Source Football\"\n href: https://www.opensourcefootball.com\n - text: \"nflverse Data\"\n - text: nflverse GitHub\n href: https://github.com/nflverse\n - text: ffverse\n - text: \"ffverse.com\"\n href: https://www.ffverse.com\nreference:\n - title: Main Functions\n contents:\n - build_nflfastR_pbp\n - update_db\n - update_pbp_db\n - title: Load Functions\n desc: >\n These functions access precomputed data using the nflreadr package.\n See