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.2.0 ──
#> # A tibble: 68 × 27
#> player_id player_name team_id team_abbreviation age player_height
#> <int> <chr> <int> <chr> <dbl> <chr>
#> 1 1643530 Aday Mara 1610612760 OKC 21 7-3
#> 2 1641737 Adem Bona 1610612755 PHI 23 6-10
#> 3 1642349 Ajay Mitchell 1610612760 OKC 24 6-4
#> 4 1627936 Alex Caruso 1610612760 OKC 32 6-5
#> 5 203083 Andre Drummond 1610612752 NYK 33 6-10
#> 6 1629014 Anfernee Simons 1610612755 PHI 27 6-4
#> 7 1641709 Ausar Thompson 1610612765 DET 23 6-7
#> 8 1631248 Baylor Scheierman 1610612738 BOS 26 6-6
#> 9 1642892 Bennett Stirtz 1610612760 OKC 23 6-3
#> 10 1642964 Brooks Barnhizer 1610612760 OKC 24 6-5
#> # ℹ 58 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>
# }