Skip to contents

Welcome folks,

I’m Saiem Gilani, one of the authors of wehoop, and I hope to give the community a high-quality resource for accessing women’s basketball data for statistical analysis, basketball research, and more. I am excited to show you some of what you can do with this edition of the package.

Installing R and RStudio

  1. Head to https://cran.r-project.org
  2. Select the appropriate link for your operating system (Windows, Mac OS X, or Linux)
  • Windows - Select base and download the most recent version
  • Mac OS X - Select Latest Release, but check to make sure your OS is the correct version. Look through Binaries for Legacy OS X Systems if you are on an older release
  • Linux - Select the appropriate distro and follow the installation instructions
  1. Head to RStudio.com
  2. Follow the associated download and installation instructions for RStudio.
  3. Start peering over the RStudio IDE Cheatsheet. An IDE is an integrated development environment.
  4. For Windows users: I recommend you install Rtools. This is not an R package! It is “a collection of resources for building packages for R under Microsoft Windows, or for building R itself”. Go to https://cran.r-project.org/bin/windows/Rtools/ and follow the directions for installation.

Install wehoop

# You can install using the pacman package using the following code:
if (!requireNamespace('pacman', quietly = TRUE)){
  install.packages('pacman')
}

pacman::p_load(wehoop, dplyr, glue, tictoc, progressr)

Quick Start

WNBA full play-by-play seasons (2002-2022) ~ 30-60 seconds

tictoc::tic()
progressr::with_progress({
  wnba_pbp <- wehoop::load_wnba_pbp()
})
tictoc::toc()
## 0.576 sec elapsed
## 13.91 sec elapsed
glue::glue("{nrow(wnba_pbp)} rows of WNBA play-by-play data from {length(unique(wnba_pbp$game_id))} games.")
## 20162 rows of WNBA play-by-play data from 51 games.
## 1782985 rows of WNBA play-by-play data from 4674 games.
dplyr::glimpse(wnba_pbp)
## Rows: 20,162
## Columns: 42
## $ shooting_play             <lgl> FALSE, FALSE, FALSE, TRUE, FALSE, FALSE, TRU…
## $ sequence_number           <chr> "4", "7", "9", "12", "14", "15", "16", "17",…
## $ period_display_value      <chr> "1st Quarter", "1st Quarter", "1st Quarter",…
## $ period_number             <int> 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,…
## $ home_score                <int> 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 2, 4, 4, 4, 4,…
## $ coordinate_x              <int> -214748340, 38, -214748340, 37, 37, 32, 12, …
## $ coordinate_y              <int> -214748365, 24, -214748365, 9, 9, 3, 0, 0, 2…
## $ scoring_play              <lgl> FALSE, FALSE, FALSE, FALSE, FALSE, FALSE, FA…
## $ clock_display_value       <chr> "10:00", "9:47", "9:33", "9:31", "9:31", "9:…
## $ team_id                   <chr> "5", "16", "5", "5", "5", "5", "16", "5", "5…
## $ type_id                   <chr> "615", "45", "615", "92", "156", "70", "136"…
## $ type_text                 <chr> "Jumpball", "Personal Foul", "Jumpball", "Ju…
## $ away_score                <int> 0, 0, 0, 0, 0, 0, 0, 0, 2, 2, 5, 5, 7, 7, 8,…
## $ id                        <dbl> 4013916504, 4013916507, 4013916509, 40139165…
## $ text                      <chr> "Queen Egbo vs. Myisha Hines-Allen (Destanni…
## $ score_value               <int> 0, 0, 0, 0, 0, 0, 0, 0, 2, 2, 3, 2, 2, 0, 1,…
## $ participants_0_athlete_id <chr> "4398779", "3142055", "4398776", "4398751", …
## $ participants_1_athlete_id <chr> "3142055", NA, "3146151", "3058893", NA, NA,…
## $ participants_2_athlete_id <chr> "4398751", NA, "4398751", NA, NA, NA, NA, NA…
## $ season                    <int> 2022, 2022, 2022, 2022, 2022, 2022, 2022, 20…
## $ season_type               <int> 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2,…
## $ game_id                   <int> 401391650, 401391650, 401391650, 401391650, …
## $ away_team_id              <int> 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5, 5,…
## $ away_team_name            <chr> "Indiana", "Indiana", "Indiana", "Indiana", …
## $ away_team_mascot          <chr> "Fever", "Fever", "Fever", "Fever", "Fever",…
## $ away_team_abbrev          <chr> "IND", "IND", "IND", "IND", "IND", "IND", "I…
## $ away_team_name_alt        <chr> "Indiana", "Indiana", "Indiana", "Indiana", …
## $ home_team_id              <int> 16, 16, 16, 16, 16, 16, 16, 16, 16, 16, 16, …
## $ home_team_name            <chr> "Washington", "Washington", "Washington", "W…
## $ home_team_mascot          <chr> "Mystics", "Mystics", "Mystics", "Mystics", …
## $ home_team_abbrev          <chr> "WSH", "WSH", "WSH", "WSH", "WSH", "WSH", "W…
## $ home_team_name_alt        <chr> "Washington", "Washington", "Washington", "W…
## $ home_team_spread          <dbl> 2.5, 2.5, 2.5, 2.5, 2.5, 2.5, 2.5, 2.5, 2.5,…
## $ game_spread               <dbl> 2.5, 2.5, 2.5, 2.5, 2.5, 2.5, 2.5, 2.5, 2.5,…
## $ home_favorite             <lgl> TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TRUE, TR…
## $ clock_minutes             <chr> "10", "9", "9", "9", "9", "9", "9", "9", "8"…
## $ clock_seconds             <chr> "00", "47", "33", "31", "31", "31", "11", "0…
## $ half                      <chr> "1", "1", "1", "1", "1", "1", "1", "1", "1",…
## $ lag_half                  <chr> NA, "1", "1", "1", "1", "1", "1", "1", "1", …
## $ lead_half                 <chr> "1", "1", "1", "1", "1", "1", "1", "1", "1",…
## $ game_play_number          <int> 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 1…
## $ type_abbreviation         <lgl> NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, NA, …

WNBA full team box score seasons (2003-2022) ~ 5-30 seconds

tictoc::tic()
progressr::with_progress({
  wnba_team_box <- wehoop::load_wnba_team_box()
})

tictoc::toc()
## 0.037 sec elapsed
glue::glue("{nrow(wnba_team_box)} rows of WNBA team boxscore data from {length(unique(wnba_team_box$game_id))} games.")
## 102 rows of WNBA team boxscore data from 51 games.
dplyr::glimpse(wnba_team_box)
## Rows: 102
## Columns: 40
## $ team_short_display_name                                        <chr> "Fever"…
## $ team_uid                                                       <chr> "s:40~l…
## $ team_alternate_color                                           <chr> "08265b…
## $ team_color                                                     <chr> "e2382f…
## $ team_display_name                                              <chr> "Indian…
## $ team_name                                                      <chr> "Fever"…
## $ team_logo                                                      <chr> "https:…
## $ team_location                                                  <chr> "Indian…
## $ team_id                                                        <chr> "5", "1…
## $ team_abbreviation                                              <chr> "IND", …
## $ team_slug                                                      <chr> "indian…
## $ field_goals_made_field_goals_attempted                         <chr> "30-72"…
## $ field_goal_pct                                                 <chr> "41.7",…
## $ three_point_field_goals_made_three_point_field_goals_attempted <chr> "5-22",…
## $ three_point_field_goal_pct                                     <chr> "22.7",…
## $ free_throws_made_free_throws_attempted                         <chr> "5-8", …
## $ free_throw_pct                                                 <chr> "62.5",…
## $ total_rebounds                                                 <chr> "42", "…
## $ offensive_rebounds                                             <chr> "12", "…
## $ defensive_rebounds                                             <chr> "30", "…
## $ assists                                                        <chr> "17", "…
## $ steals                                                         <chr> "3", "4…
## $ blocks                                                         <chr> "4", "5…
## $ turnovers                                                      <chr> "14", "…
## $ team_turnovers                                                 <chr> "4", "1…
## $ total_turnovers                                                <chr> "18", "…
## $ technical_fouls                                                <chr> "0", "0…
## $ total_technical_fouls                                          <chr> "0", "0…
## $ flagrant_fouls                                                 <chr> "0", "0…
## $ fouls                                                          <chr> "20", "…
## $ largest_lead                                                   <chr> "4", "2…
## $ home_away                                                      <chr> "HOME",…
## $ opponent_id                                                    <int> 16, 5, …
## $ opponent_name                                                  <chr> "Washin…
## $ opponent_mascot                                                <chr> "Mystic…
## $ opponent_abbrev                                                <chr> "WSH", …
## $ game_id                                                        <int> 4013916…
## $ season                                                         <int> 2022, 2…
## $ season_type                                                    <int> 2, 2, 2…
## $ game_date                                                      <date> 2022-0…

WNBA full player box score seasons (2002-2022) ~ 5-30 seconds

tictoc::tic()
progressr::with_progress({
  wnba_player_box <- wehoop::load_wnba_player_box()
})
tictoc::toc()
## 0.044 sec elapsed
length(unique(wnba_player_box$game_id))
## [1] 51
nrow(wnba_player_box)
## [1] 962

Women’s college basketball full play-by-play seasons (2004-2022) ~ 45-90 seconds

tictoc::tic()
progressr::with_progress({
  wbb_pbp <- wehoop::load_wbb_pbp()
})
tictoc::toc()
## 18.479 sec elapsed
length(unique(wbb_pbp$game_id))
## [1] 5347
nrow(wbb_pbp)
## [1] 1760447

Women’s college basketball full team box score seasons (2006-2022) ~ 5-30 seconds

tictoc::tic()
progressr::with_progress({
  wbb_team_box <- wehoop::load_wbb_team_box()
})
tictoc::toc()
## 0.188 sec elapsed
length(unique(wbb_team_box$game_id))
## [1] 5509
nrow(wbb_team_box)
## [1] 11018

Women’s college basketball full player box score seasons (2006-2022) ~ 5-30 seconds

tictoc::tic()
progressr::with_progress({
  wbb_player_box <- wehoop::load_wbb_player_box()
})
tictoc::toc()
## 1.091 sec elapsed
length(unique(wbb_player_box$game_id))
## [1] 5508
nrow(wbb_player_box)
## [1] 111857