Skip to contents

Loads data on which officials are assigned to oversee a specific game. Data available from 2015 onwards.

Usage

load_officials(
  seasons = TRUE,
  file_type = getOption("nflreadr.prefer", default = "rds")
)

Arguments

seasons

a numeric vector specifying what seasons to return, if TRUE returns all available data

file_type

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

Value

A tibble with one row per game per official.

See also

Issues with this data should be filed here: https://github.com/nflverse/nflreadr and it will be triaged appropriately.

Examples

# \donttest{
try({ # prevents cran errors
  load_officials()
})
#> ── nflverse officials ──────────────────────────────────────────────────────────
#>  Data updated: 2023-02-02 07:02:37 UTC
#> # A tibble: 15,712 × 9
#>    game_id    game_key official_n…¹ posit…² jerse…³ offic…⁴ season seaso…⁵  week
#>    <chr>      <chr>    <chr>        <chr>     <int> <chr>    <int> <chr>   <int>
#>  1 2015091000 56503    Brad Freeman Field …      88 25        2015 REG         1
#>  2 2015091000 56503    Kent Payne   Head L…      79 28        2015 REG         1
#>  3 2015091000 56503    Terrence Mi… Back J…     111 139       2015 REG         1
#>  4 2015091000 56503    Tim Podraza  Line J…      47 123       2015 REG         1
#>  5 2015091000 56503    Scott Novak  Side J…       1 94        2015 REG         1
#>  6 2015091000 56503    Undrey Wash  Umpire       96 134       2015 REG         1
#>  7 2015091000 56503    Carl Cheffe… Referee      51 3         2015 REG         1
#>  8 2015091300 56505    Lee Dyer     Back J…      27 72        2015 REG         1
#>  9 2015091300 56505    Steve Zimmer Field …      33 116       2015 REG         1
#> 10 2015091300 56505    Mark Hittner Head L…      28 118       2015 REG         1
#> # … with 15,702 more rows, and abbreviated variable names ¹​official_name,
#> #   ²​position, ³​jersey_number, ⁴​official_id, ⁵​season_type
# }