Load fastRhockey PWHL shootout summaries

Helper that loads multiple seasons of PWHL shootout-attempt data from the sportsdataverse-data releases either into memory or writes it into a database.

Source release tag: pwhl_shootout. File naming convention: shootout_summary_{end_year}.rds. Note that some seasons (notably the 2024 inaugural season) do not contain any shootout games.

Usage

load_pwhl_shootout(
  seasons = most_recent_pwhl_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given PWHL seasons. (Min: 2024)

...

Additional arguments (currently unused; kept for API symmetry).

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the shootout data table within the database

Value

A data frame of class fastRhockey_data. One row per shootout attempt. Common columns include:

column	type	description
game_id	integer	PWHL game id
round	integer	shootout round number
team_side	character	"home" or "away"
shooter_id	integer	shooter player id
shooter_first	character	shooter first name
shooter_last	character	shooter last name
goalie_id	integer	opposing goalie id
goalie_first	character	goalie first name
goalie_last	character	goalie last name
is_goal	integer	scored flag

Examples

# \donttest{
  try(load_pwhl_shootout(2024))
#> Warning: cannot open URL 'https://github.com/sportsdataverse/sportsdataverse-data/releases/download/pwhl_shootout/shootout_summary_2024.rds': HTTP status was '404 Not Found'
#> Warning: Failed to readRDS from <https://github.com/sportsdataverse/sportsdataverse-data/releases/download/pwhl_shootout/shootout_summary_2024.rds>
#> ─────────────────────────────────────────────────────────── fastRhockey 1.0.0 ──
#> # A tibble: 0 × 0
# }