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_pbp(
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 |
| id | numeric |
| sequence_number | character |
| type_id | integer |
| type_text | character |
| text | character |
| away_score | integer |
| home_score | integer |
| period_number | integer |
| period_display_value | character |
| clock_display_value | character |
| scoring_play | logical |
| score_value | integer |
| team_id | integer |
| athlete_id_1 | integer |
| athlete_id_2 | integer |
| athlete_id_3 | integer |
| wallclock | character |
| shooting_play | logical |
| coordinate_x_raw | numeric |
| coordinate_y_raw | numeric |
| season | integer |
| season_type | integer |
| away_team_id | integer |
| away_team_name | character |
| away_team_mascot | character |
| away_team_abbrev | character |
| away_team_name_alt | character |
| home_team_id | integer |
| home_team_name | character |
| home_team_mascot | character |
| home_team_abbrev | character |
| home_team_name_alt | character |
| home_team_spread | numeric |
| game_spread | numeric |
| home_favorite | logical |
| game_spread_available | logical |
| game_id | integer |
| qtr | integer |
| time | character |
| clock_minutes | integer |
| clock_seconds | numeric |
| half | character |
| game_half | character |
| lead_qtr | integer |
| lead_game_half | character |
| start_quarter_seconds_remaining | integer |
| start_half_seconds_remaining | integer |
| start_game_seconds_remaining | integer |
| game_play_number | integer |
| end_quarter_seconds_remaining | integer |
| end_half_seconds_remaining | integer |
| end_game_seconds_remaining | integer |
| period | integer |
| lag_qtr | integer |
| lag_game_half | character |
| coordinate_x | numeric |
| coordinate_y | numeric |
| game_date | Date |
| game_date_time | POSIXct |
| type_abbreviation | character |
See also
Other hoopR Loader Functions:
load_mbb_pbp(),
load_mbb_player_box(),
load_mbb_schedule(),
load_mbb_team_box(),
load_nba_player_box(),
load_nba_schedule(),
load_nba_team_box()
Examples
# \donttest{
load_nba_pbp(seasons = most_recent_nba_season())
#> ── ESPN NBA Play-by-Play from hoopR data repository ───────────── hoopR 2.1.0 ──
#> ℹ Data updated: 2023-11-28 12:28:41 UTC
#> # A tibble: 118,869 × 62
#> game_play_number id sequence_number type_id type_text text away_score
#> <int> <dbl> <int> <int> <chr> <chr> <int>
#> 1 1 4.02e 9 4 615 Jumpball Dani… 0
#> 2 2 4.02e 9 7 126 Layup Dr… Jade… 0
#> 3 3 4.02e 9 8 156 Offensiv… Jade… 0
#> 4 4 4.02e 9 9 94 Tip Shot Jade… 0
#> 5 5 4.02e10 10 110 Driving … Jale… 0
#> 6 6 4.02e10 12 155 Defensiv… Cade… 0
#> 7 7 4.02e10 13 95 Layup Sh… Cade… 0
#> 8 8 4.02e10 14 132 Step Bac… Kyle… 0
#> 9 9 4.02e10 15 155 Defensiv… Jale… 0
#> 10 10 4.02e10 16 127 Layup Ru… Ausa… 0
#> # ℹ 118,859 more rows
#> # ℹ 55 more variables: home_score <int>, period_number <int>,
#> # period_display_value <chr>, clock_display_value <chr>, scoring_play <lgl>,
#> # score_value <int>, team_id <int>, athlete_id_1 <int>, athlete_id_2 <int>,
#> # athlete_id_3 <int>, wallclock <chr>, shooting_play <lgl>,
#> # coordinate_x_raw <dbl>, coordinate_y_raw <dbl>, game_id <int>,
#> # season <int>, season_type <int>, home_team_id <int>, …
# }