Skip to contents

Load Rosters

Usage

load_rosters(
  seasons = most_recent_season(roster = TRUE),
  file_type = getOption("nflreadr.prefer", default = "rds")
)

Arguments

seasons

a numeric vector of seasons to return, defaults to returning this year's data if it is March or later. If set to TRUE, will return all available data. Data available back to 1920.

file_type

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

Value

A tibble of season-level roster data.

See also

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

dictionary_rosters for the data dictionary as a dataframe

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

Examples

# \donttest{
try({ # prevents cran errors
  load_rosters(2020)
})
#> ── nflverse roster data ────────────────────────────────────────────────────────
#>  Data updated: 2022-08-18 20:01:49 UTC
#> # A tibble: 2,957 × 36
#>    season team  position depth_chart_po…¹ jerse…² status full_…³ first…⁴ last_…⁵
#>     <int> <chr> <chr>    <chr>              <int> <chr>  <chr>   <chr>   <chr>  
#>  1   2020 ARI   DB       CB                    25 R/Inj… Johnat… Johnat… Joseph 
#>  2   2020 ARI   DB       CB                    25 R/Inj… Johnat… Johnat… Joseph 
#>  3   2020 ARI   DB       CB                    21 Active Patric… Patrick Peters…
#>  4   2020 ARI   DB       CB                    20 PS; V… Prince… Prince  Amukam…
#>  5   2020 ARI   DB       CB                    20 Active Dre Ki… D'Andre Kirkpa…
#>  6   2020 ARI   DB       FS                    31 R/COV… Chris … Ayorun… Banjo  
#>  7   2020 ARI   DB       CB                    23 R/Inj… Robert… Robert  Alford 
#>  8   2020 ARI   DB       FS                    28 Active Charle… Charles Washin…
#>  9   2020 ARI   DB       CB                    27 Active Kevin … Kevin   Peters…
#> 10   2020 ARI   DB       SS                    32 Active Budda … Budda   Baker  
#> # … with 2,947 more rows, 27 more variables: birth_date <date>, height <chr>,
#> #   weight <int>, college <chr>, gsis_id <chr>, espn_id <chr>,
#> #   sportradar_id <chr>, yahoo_id <chr>, rotowire_id <chr>, pff_id <chr>,
#> #   pfr_id <chr>, fantasy_data_id <chr>, sleeper_id <chr>, years_exp <int>,
#> #   headshot_url <chr>, ngs_position <chr>, week <int>, game_type <chr>,
#> #   status_description_abbr <chr>, football_name <chr>, esb_id <chr>,
#> #   gsis_it_id <chr>, smart_id <chr>, entry_year <int>, rookie_year <int>, …
# }