wehoop

An R package to quickly obtain clean and tidy women's basketball play by play data.

https://github.com/sportsdataverse/wehoop

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
  • Committers with academic emails
    1 of 18 committers (5.6%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.8%) to scientific vocabulary

Keywords

college-basketball espn espn-stats ncaa ncaa-basketball professional-basketball-data r rstats sportsdataverse wnba wnba-players wnba-stats womens-basketball
Last synced: 6 months ago · JSON representation

Repository

An R package to quickly obtain clean and tidy women's basketball play by play data.

Basic Info
Statistics
  • Stars: 37
  • Watchers: 3
  • Forks: 4
  • Open Issues: 11
  • Releases: 8
Topics
college-basketball espn espn-stats ncaa ncaa-basketball professional-basketball-data r rstats sportsdataverse wnba wnba-players wnba-stats womens-basketball
Created about 5 years ago · Last pushed 8 months ago
Metadata Files
Readme Changelog License Code of conduct

README.Rmd

---
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:

```


[![CRAN status](https://img.shields.io/badge/dynamic/json?style=for-the-badge&color=success&label=CRAN%20version&prefix=v&query=%24.Version&url=https%3A%2F%2Fcrandb.r-pkg.org%2Fwehoop)](https://CRAN.R-project.org/package=wehoop)
[![CRAN downloads](https://img.shields.io/badge/dynamic/json?style=for-the-badge&color=success&label=Downloads&query=%24%5B0%5D.downloads&url=https%3A%2F%2Fcranlogs.r-pkg.org%2Fdownloads%2Ftotal%2F2021-10-26%3Alast-day%2Fwehoop)](https://CRAN.R-project.org/package=wehoop)
[![Version-Number](https://img.shields.io/github/r-package/v/sportsdataverse/wehoop?label=wehoop&logo=R&style=for-the-badge)](https://github.com/sportsdataverse/wehoop) [![R-CMD-check](https://img.shields.io/github/actions/workflow/status/sportsdataverse/wehoop/R-CMD-check.yaml?branch=main&label=R-CMD-Check&logo=R&logoColor=white&style=for-the-badge)](https://github.com/sportsdataverse/wehoop/actions/workflows/R-CMD-check.yaml) [![Lifecycle:maturing](https://img.shields.io/badge/lifecycle-maturing-blue.svg?style=for-the-badge&logo=github)](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

 

[![GitHub stars](https://img.shields.io/github/stars/sportsdataverse/wehoop.svg?color=eee&logo=github&style=for-the-badge&label=Star%20wehoop&maxAge=2592000)](https://github.com/sportsdataverse/wehoop/stargazers/)


# **Our Authors**

-   Saiem Gilani (@saiemgilani)       


@saiemgilani

-   Geoff Hutchinson (@HutchNGo)       


@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 
}
```

Owner

  • Name: SportsDataverse
  • Login: sportsdataverse
  • Kind: organization
  • Email: sportsdataverse@gmail.com

GitHub Events

Total
  • Issues event: 3
  • Watch event: 13
  • Delete event: 1
  • Issue comment event: 2
  • Pull request event: 1
  • Fork event: 2
Last Year
  • Issues event: 3
  • Watch event: 13
  • Delete event: 1
  • Issue comment event: 2
  • Pull request event: 1
  • Fork event: 2

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 250
  • Total Committers: 18
  • Avg Commits per committer: 13.889
  • Development Distribution Score (DDS): 0.084
Past Year
  • Commits: 17
  • Committers: 1
  • Avg Commits per committer: 17.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
saiemgilani s****i@g****m 229
Geoff Hutchinson g****n@g****m 4
Davis Vaughan d****s@r****m 2
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
runner r****r@M****l 1
Andrew Weatherman t****8@d****u 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 16
  • Total pull requests: 25
  • Average time to close issues: about 2 months
  • Average time to close pull requests: 8 days
  • Total issue authors: 14
  • Total pull request authors: 4
  • Average comments per issue: 1.5
  • Average comments per pull request: 1.04
  • Merged pull requests: 22
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 6
  • Pull requests: 2
  • Average time to close issues: N/A
  • Average time to close pull requests: about 2 hours
  • Issue authors: 5
  • Pull request authors: 2
  • Average comments per issue: 0.33
  • Average comments per pull request: 2.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • jrbarber37 (2)
  • rplain1 (2)
  • BrandanW (1)
  • jmhyman-su (1)
  • tafamusoni (1)
  • reillykevin (1)
  • hoopsadoops (1)
  • tommyanthony (1)
  • bmacGTPM (1)
  • hypebright (1)
  • sambruchhaus (1)
  • saiemgilani (1)
  • dbaggot3 (1)
  • bmargio (1)
Pull Request Authors
  • saiemgilani (22)
  • DavisVaughan (2)
  • rplain1 (2)
  • andreweatherman (1)
Top Labels
Issue Labels
enhancement (2) documentation (1) bug (1)
Pull Request Labels
enhancement (1)

Packages

  • Total packages: 1
  • Total downloads:
    • cran 425 last-month
  • Total docker downloads: 21,613
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 5
  • Total maintainers: 1
cran.r-project.org: wehoop

Access Women's Basketball Play by Play Data

  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 425 Last month
  • Docker Downloads: 21,613
Rankings
Docker downloads count: 0.6%
Stargazers count: 15.8%
Forks count: 17.0%
Average: 19.0%
Dependent repos count: 23.9%
Downloads: 28.1%
Dependent packages count: 28.7%
Maintainers (1)
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 4.0.0 depends
  • Rcpp >= 1.0.7 imports
  • RcppParallel >= 5.1.4 imports
  • cli >= 3.0.0 imports
  • data.table >= 1.14.0 imports
  • dplyr * imports
  • glue * imports
  • janitor * imports
  • jsonlite * imports
  • magrittr * imports
  • progressr >= 0.6.0 imports
  • purrr >= 0.3.0 imports
  • rlang >= 0.4.0 imports
  • rvest >= 1.0.0 imports
  • stringr >= 1.3.0 imports
  • tidyr >= 1.2.0 imports
  • usethis >= 1.6.0 imports
  • DBI * suggests
  • RSQLite * suggests
  • crayon >= 1.3.4 suggests
  • curl * suggests
  • ggplot2 * suggests
  • ggrepel * suggests
  • httr >= 0.5 suggests
  • knitr * suggests
  • rmarkdown * suggests
  • stats * suggests
  • stringi * suggests
  • testthat * suggests
  • tibble >= 3.0 suggests
  • tictoc * suggests
  • xml2 >= 1.3 suggests
.github/workflows/R-CMD-check.yaml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • actions/upload-artifact main composite
  • r-lib/actions/setup-pandoc v1 composite
  • r-lib/actions/setup-r v1 composite
.github/workflows/pkgdown.yaml actions
  • actions/checkout v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite