Skip to contents

Loads depth charts for each NFL team for each week back to 2001.

Usage

load_depth_charts(
  seasons = most_recent_season(),
  file_type = getOption("nflreadr.prefer", default = "rds")
)

Arguments

seasons

a numeric vector specifying what seasons to return, if TRUE returns all available data. Defaults to latest season.

file_type

One of c("rds", "qs", "csv", "parquet"). Can also be set globally with options(nflreadr.prefer)

Value

A tibble of week-level depth charts for each team.

See also

https://nflreadr.nflverse.com/articles/dictionary_depth_charts.html for a web version of the dictionary

dictionary_depth_charts for the data dictionary as bundled within the package

Issues with this data should be filed here: https://github.com/nflverse/nflverse-data

Examples

# \donttest{
try({ # prevents cran errors
  load_depth_charts(2020)
})
#> ── nflverse depth charts ───────────────────────────────────────────────────────
#>  Data updated: 2022-08-02 01:40:11 UTC
#> # A tibble: 36,168 × 15
#>    season club_c…¹  week game_…² depth…³ last_…⁴ first…⁵ footb…⁶ forma…⁷ gsis_id
#>     <dbl> <chr>    <dbl> <chr>   <chr>   <chr>   <chr>   <chr>   <chr>   <chr>  
#>  1   2020 ATL          1 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  2   2020 ATL          2 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  3   2020 ATL          3 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  4   2020 ATL          4 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  5   2020 ATL          5 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  6   2020 ATL          6 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  7   2020 ATL          7 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  8   2020 ATL          8 REG     2       Schaub  Matt    Matt    Offense 00-002…
#>  9   2020 ATL          9 REG     2       Schaub  Matt    Matt    Offense 00-002…
#> 10   2020 ATL         10 REG     2       Schaub  Matt    Matt    Offense 00-002…
#> # … with 36,158 more rows, 5 more variables: jersey_number <chr>,
#> #   position <chr>, elias_id <chr>, depth_position <chr>, full_name <chr>, and
#> #   abbreviated variable names ¹​club_code, ²​game_type, ³​depth_team, ⁴​last_name,
#> #   ⁵​first_name, ⁶​football_name, ⁷​formation
# }