Loads one asset of the nba_stats_leaguedash release tag –
the parameter cube that supersedes the narrower Base-measure tags
(load_nba_stats_player_season_stats(), load_nba_stats_team_season_stats(),
load_nba_stats_lineups(), load_nba_stats_standings()). The cube
publishes 36 tables per season and is the only route to
Advanced/Misc/Scoring/Usage/Defense/Opponent/Four Factors
measures, 2/3/4-man lineup groupings, the *_bio/*_master wide joins,
and player tracking (drives, passing, touches, catch-and-shoot,
pull-up shooting, rebounding, speed/distance).
Coverage floors differ by table and are not individually enforced
here (only the global 1996 floor is): the lineups_* tables start at
the 2007-08 season and the player_tracking_* tables (other than
catchshoot/pullupshot, which go back to 1996) start at the 2013-14
season. Requesting an out-of-range season for those tables 404s
gracefully with a warning and contributes no rows, same as any other
nba_stats_* loader.
Usage
load_nba_stats_leaguedash(
seasons = most_recent_nba_stats_season(),
table = NULL,
...,
dbConnection = NULL,
tablename = NULL
)Arguments
- seasons
A vector of 4-digit years – the season's START year (e.g.
2024for the 2024-25 season). Published coverage runs 1996 through the most recent season for most tables (see Description for per-table floors). Passseasons = TRUEfor every published season. (Min: 1996)- table
Name of the cube table to load. One of
player_bio,player_master,player_stats_base,player_stats_advanced,player_stats_misc,player_stats_scoring,player_stats_usage,player_stats_defense,player_tracking_catchshoot,player_tracking_defense,player_tracking_drives,player_tracking_efficiency,player_tracking_elbowtouch,player_tracking_painttouch,player_tracking_passing,player_tracking_possessions,player_tracking_posttouch,player_tracking_pullupshot,player_tracking_rebounding,player_tracking_speeddistance,team_master,team_stats_base,team_stats_advanced,team_stats_misc,team_stats_scoring,team_stats_defense,team_stats_opponent,team_stats_fourfactors,lineups_master,lineups_base,lineups_advanced,lineups_misc,lineups_scoring,lineups_opponent,lineups_fourfactors,standings.- ...
Additional arguments passed to an underlying function that writes the season data into a database.
- dbConnection
A
DBIConnectionobject, as returned byDBI::dbConnect()- tablename
The name of the data table within the database
Value
Returns a hoopR_data tibble of the requested cube table, one
row per player-season, team-season or lineup-season depending on
table. Column sets differ per table (11 to 625 columns); the
*_master tables are wide joins of every measure type for that entity.
See also
Other NBA Stats loader functions:
load_nba_stats_coaches()
Examples
# \donttest{
try(load_nba_stats_leaguedash(seasons = most_recent_nba_stats_season(),
table = "player_bio"))
#> ───────────────────────────────────────────────────────────────── hoopR 3.1.0 ──
#> # A tibble: 812 × 27
#> player_id player_name team_id team_abbreviation age player_height
#> <int> <chr> <int> <chr> <dbl> <chr>
#> 1 1630639 A.J. Lawson 1610612761 TOR 25 6-6
#> 2 1631260 AJ Green 1610612749 MIL 26 6-4
#> 3 1642358 AJ Johnson 1610612742 DAL 21 6-5
#> 4 203932 Aaron Gordon 1610612743 DEN 30 6-8
#> 5 1628988 Aaron Holiday 1610612745 HOU 29 6-0
#> 6 1630174 Aaron Nesmith 1610612754 IND 26 6-5
#> 7 1630598 Aaron Wiggins 1610612760 OKC 27 6-5
#> 8 1642846 Ace Bailey 1610612762 UTA 19 6-9
#> 9 1642380 Adama Bal 1610612763 MEM 22 6-7
#> 10 1641737 Adem Bona 1610612755 PHI 23 6-10
#> # ℹ 802 more rows
#> # ℹ 21 more variables: player_height_inches <int>, player_weight <chr>,
#> # college <chr>, country <chr>, draft_year <chr>, draft_round <chr>,
#> # draft_number <chr>, gp <int>, pts <int>, reb <int>, ast <int>,
#> # net_rating <dbl>, oreb_pct <dbl>, dreb_pct <dbl>, usg_pct <dbl>,
#> # ts_pct <dbl>, ast_pct <dbl>, season <int>, league_id <chr>,
#> # season_type <chr>, per_mode <chr>
# }