https://github.com/sportsdataverse/wehoop
An R package to quickly obtain clean and tidy women's basketball play by play data.
https://github.com/sportsdataverse/wehoop
college-basketball espn espn-stats ncaa ncaa-basketball professional-basketball-data r rstats sportsdataverse wnba wnba-players wnba-stats womens-basketball
Last synced: 2 months ago
JSON representation
An R package to quickly obtain clean and tidy women's basketball play by play data.
- Host: GitHub
- URL: https://github.com/sportsdataverse/wehoop
- Owner: sportsdataverse
- License: other
- Created: 2021-02-26T00:43:43.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-07-21T23:48:31.000Z (11 months ago)
- Last Synced: 2025-03-28T03:05:29.514Z (3 months ago)
- Topics: college-basketball, espn, espn-stats, ncaa, ncaa-basketball, professional-basketball-data, r, rstats, sportsdataverse, wnba, wnba-players, wnba-stats, womens-basketball
- Language: R
- Homepage: https://wehoop.sportsdataverse.org/
- Size: 16.1 MB
- Stars: 31
- Watchers: 2
- Forks: 3
- Open Issues: 7
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
---
output: github_document
---
# wehoop 
```{r setup_readme, include = FALSE}
require(knitr)
if (!requireNamespace('pacman')){
install.packages('pacman')
}
pacman::p_load(wehoop, magick, grid, dplyr, lubridate)
# You can install using the pacman package using the following code:
```
[](https://CRAN.R-project.org/package=wehoop)
[](https://CRAN.R-project.org/package=wehoop)
[](https://github.com/sportsdataverse/wehoop) [](https://github.com/sportsdataverse/wehoop/actions/workflows/R-CMD-check.yaml) [](https://github.com/sportsdataverse/wehoop)
`wehoop` is an R package for working with women's college and professional basketball data. The package has functions to access **live play by play and box score** data from ESPN with shot locations when available.
A scraping and aggregating interface for ESPN's women's college basketball and WNBA statistics. It provides users with the capability to access the API's game play-by-plays, box scores, standings and results to analyze the data for themselves.
## **Installation**
You can install the CRAN version of [**```wehoop```** ](https://CRAN.R-project.org/package=wehoop) with:
```{r readme_cran_install, eval=FALSE}
install.packages("wehoop")
```
You can install the released version of [**`wehoop`**](https://github.com/sportsdataverse/wehoop) from [GitHub](https://github.com/sportsdataverse/wehoop) with:
```{r pacman_readme, eval=FALSE}
# You can install using the pacman package using the following code:
if (!requireNamespace('pacman', quietly = TRUE)){
install.packages('pacman')
}
pacman::p_load_current_gh("sportsdataverse/wehoop", dependencies = TRUE, update = TRUE)
```
## **Quick Start**
### **WNBA full play-by-play seasons (2002-`r wehoop::most_recent_wnba_season()`) ~ 1-2 minutes**
```{r wnba_load_pbp_readme}
tictoc::tic()
progressr::with_progress({
wnba_pbp <- wehoop::load_wnba_pbp()
})
tictoc::toc()
```
```{r wnba_pbp_message, echo = FALSE}
glue::glue("{nrow(wnba_pbp)} rows of WNBA play-by-play data from {length(unique(wnba_pbp$game_id))} games.")
```
### **Women's college basketball full play-by-play seasons (2004-`r wehoop::most_recent_wbb_season()`) ~ 2-3 minutes**
```{r wbb_load_pbp_readme}
tictoc::tic()
progressr::with_progress({
wbb_pbp <- wehoop::load_wbb_pbp()
})
tictoc::toc()
```
```{r wbb_pbp_message, echo = FALSE}
glue::glue("{nrow(wbb_pbp)} rows of women's college basketball play-by-play data from {length(unique(wbb_pbp$game_id))} games.")
```
## **Documentation**
For more information on the package and function reference, please see the [**`wehoop`** documentation website](https://wehoop.sportsdataverse.org).
## **Breaking Changes**
[**Full News on Releases**](https://wehoop.sportsdataverse.org/news/index.html)
## Follow the SportsDataverse (@SportsDataverse) on Twitter and star this repo
[](https://github.com/sportsdataverse/wehoop/stargazers/)
# **Our Authors**
- Saiem Gilani (@saiemgilani)
- Geoff Hutchinson (@HutchNGo)
## **Citations**
To cite the [**`wehoop`**](https://wehoop.sportsdataverse.org) R package in publications, use:
BibTex Citation
```bibtex
@misc{hutchinson_gilani_2021_wehoop,
title = {wehoop: Access Women’s Basketball Play by Play Data},
url = {http://doi.org/10.32614/CRAN.package.wehoop},
DOI = {10.32614/cran.package.wehoop},
journal = {CRAN: Contributed Packages},
publisher = {The R Foundation},
author = {Gilani, Saiem and Hutchinson, Geoffery},
year = {2021},
month = nov
}
```