helper that loads multiple seasons from the data repo either into memory or writes it into a db using some forwarded arguments in the dots
Usage
load_nba_player_box(
seasons = most_recent_nba_season(),
...,
dbConnection = NULL,
tablename = NULL
)Arguments
- seasons
A vector of 4-digit years associated with given NBA seasons. (Min: 2002)
- ...
Additional arguments passed to an underlying function that writes the season data into a database (used by
update_nba_db()).- dbConnection
A
DBIConnectionobject, as returned by- tablename
The name of the play by play data table within the database
Value
Returns a tibble
| col_name | types |
| game_id | integer |
| season | integer |
| season_type | integer |
| game_date | Date |
| game_date_time | POSIXct |
| athlete_id | integer |
| athlete_display_name | character |
| team_id | integer |
| team_name | character |
| team_location | character |
| team_short_display_name | character |
| minutes | numeric |
| field_goals_made | integer |
| field_goals_attempted | integer |
| three_point_field_goals_made | integer |
| three_point_field_goals_attempted | integer |
| free_throws_made | integer |
| free_throws_attempted | integer |
| offensive_rebounds | integer |
| defensive_rebounds | integer |
| rebounds | integer |
| assists | integer |
| steals | integer |
| blocks | integer |
| turnovers | integer |
| fouls | integer |
| plus_minus | character |
| points | integer |
| starter | logical |
| ejected | logical |
| did_not_play | logical |
| reason | character |
| active | logical |
| athlete_jersey | character |
| athlete_short_name | character |
| athlete_headshot_href | character |
| athlete_position_name | character |
| athlete_position_abbreviation | character |
| team_display_name | character |
| team_uid | character |
| team_slug | character |
| team_logo | character |
| team_abbreviation | character |
| team_color | character |
| team_alternate_color | character |
| home_away | character |
| team_winner | logical |
| team_score | integer |
| opponent_team_id | integer |
| opponent_team_name | character |
| opponent_team_location | character |
| opponent_team_display_name | character |
| opponent_team_abbreviation | character |
| opponent_team_logo | character |
| opponent_team_color | character |
| opponent_team_alternate_color | character |
| opponent_team_score | integer |
See also
Other hoopR Loader Functions:
load_mbb_pbp(),
load_mbb_player_box(),
load_mbb_schedule(),
load_mbb_team_box(),
load_nba_pbp(),
load_nba_schedule(),
load_nba_team_box()
Examples
# \donttest{
load_nba_player_box(seasons = most_recent_nba_season())
#> ── ESPN NBA Player Boxscores from hoopR data repository ───────── hoopR 2.1.1 ──
#> ℹ Data updated: 2026-01-17 12:30:00 UTC
#> # A tibble: 16,117 × 57
#> game_id season season_type game_date game_date_time athlete_id
#> <int> <int> <int> <date> <dttm> <int>
#> 1 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 4432907
#> 2 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 5174563
#> 3 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 5160992
#> 4 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 4845374
#> 5 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 5238230
#> 6 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 2581184
#> 7 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 4277848
#> 8 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 4565201
#> 9 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 4606840
#> 10 401810447 2026 2 2026-01-16 2026-01-16 22:00:00 5144126
#> # ℹ 16,107 more rows
#> # ℹ 51 more variables: athlete_display_name <chr>, team_id <int>,
#> # team_name <chr>, team_location <chr>, team_short_display_name <chr>,
#> # minutes <dbl>, field_goals_made <int>, field_goals_attempted <int>,
#> # three_point_field_goals_made <int>,
#> # three_point_field_goals_attempted <int>, free_throws_made <int>,
#> # free_throws_attempted <int>, offensive_rebounds <int>, …
# }