Load fastRhockey NHL three stars / decisions — load_nhl_three

Helper that loads multiple seasons of NHL three-star selections and game decisions from the sportsdataverse-data releases.

Usage

load_nhl_three_stars(
  seasons = most_recent_nhl_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons: A vector of 4-digit years (the end year of the NHL season; e.g., 2026 for the 2025-26 season). Min: 2011.
...: Additional arguments passed to an underlying function.
dbConnection: A DBIConnection object, as returned by DBI::dbConnect()
tablename: The name of the data table within the database

Value

A data frame (fastRhockey_data) with one row per star selection (plus the game winner/loser goalie decision) and the following columns:

col_name	types	description
star	integer	Star ranking (1, 2, or 3).
playerId	integer	Player id of the selected star.
teamAbbrev	character	Team abbreviation of the selected star.
headshot	character	URL to the player headshot image.
name	list	Player display name (localized list).
sweaterNo	integer	Jersey number.
position	character	Player position.
goals	integer	Goals scored in the game (skaters).
assists	integer	Assists in the game (skaters).
points	integer	Total points in the game (skaters).
goalsAgainstAverage	numeric	Goals-against average (goalies).
savePctg	numeric	Save percentage (goalies).
game_id	integer	Unique game identifier.
winner_id	integer	Player id of the winning goalie.
winner_name	character	Name of the winning goalie.
loser_id	integer	Player id of the losing goalie.
loser_name	character	Name of the losing goalie.

Examples

# \donttest{
  try(load_nhl_three_stars(2026))
#> ─────────────────────────────────────────────────────────── fastRhockey 1.0.0 ──
#> # A tibble: 4,176 × 22
#>     star playerId teamAbbrev headshot    sweaterNo position goals assists points
#>    <int>    <int> <chr>      <chr>           <int> <chr>    <int>   <int>  <int>
#>  1     1  8480003 FLA        https://as…        70 C            1       0      1
#>  2     2  8482713 FLA        https://as…        11 R            0       2      2
#>  3     3  8478421 FLA        https://as…        10 L            1       0      1
#>  4     1  8481668 PIT        https://as…        37 G           NA      NA     NA
#>  5     2  8479638 PIT        https://as…        16 R            2       0      2
#>  6     3  8478048 NYR        https://as…        31 G           NA      NA     NA
#>  7     1  8480039 COL        https://as…        88 C            2       0      2
#>  8     2  8477492 COL        https://as…        29 C            0       2      2
#>  9     3  8477476 COL        https://as…        62 L            1       1      2
#> 10     1  8477939 TOR        https://as…        88 R            1       2      3
#> # ℹ 4,166 more rows
#> # ℹ 13 more variables: game_id <int>, winner_id <int>, winner_name <chr>,
#> #   loser_id <int>, loser_name <chr>, goalsAgainstAverage <dbl>,
#> #   savePctg <dbl>, name.default <chr>, name.cs <chr>, name.sk <chr>,
#> #   name.fi <chr>, name.sv <chr>, name.de <chr>
# }