Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sportsdataverse/fastrhockey

Boxscore and play-by-play stat scraper for the Premier Hockey Federation (PHF, formerly known as the NWHL).
https://github.com/sportsdataverse/fastrhockey

hockey nhl phf r r-package rstats sportsdataverse

Last synced: 3 months ago
JSON representation

Boxscore and play-by-play stat scraper for the Premier Hockey Federation (PHF, formerly known as the NWHL).

Awesome Lists containing this project

README

        

---
output: github_document
---

#

# fastRhockey

```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```

[![CRAN version](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%2FfastRhockey)](https://CRAN.R-project.org/package=fastRhockey)
[![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%2FfastRhockey)](https://CRAN.R-project.org/package=fastRhockey)
[![Version-Number](https://img.shields.io/github/r-package/v/sportsdataverse/fastRhockey?label=fastRhockey&logo=R&style=for-the-badge)](https://github.com/sportsdataverse/fastRhockey/)
[![R-CMD-check](https://img.shields.io/github/actions/workflow/status/sportsdataverse/fastRhockey/R-CMD-check.yaml?branch=main&label=R-CMD-Check&logo=R&logoColor=white&style=for-the-badge)](https://github.com/sportsdataverse/fastRhockey/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/fastRhockey/) [![Contributors](https://img.shields.io/github/contributors/sportsdataverse/fastRhockey?style=for-the-badge)](https://github.com/sportsdataverse/fastRhockey/graphs/contributors)

[`fastRhockey`](https://github.com/sportsdataverse/fastRhockey) is an R Package that is designed to pull play-by-play (and boxscore) data from the newest version of the [Professional Women's Hockey League website](https://www.thepwhl.com/). In the past, there have been a few scrapers for the PHF (formerly the NWHL), but they have all been deprecated since the formation of the new PWHL league changed websites.

With the first season of the league kicking off on January 1st, and games being broadcast on ESPN+, this package was created to allow access to play-by-play data to continue pushing women's hockey analytics forward.

In Spring of 2021, the [Big Data Cup](https://www.theicegarden.com/2021/4/15/22374981/a-directory-of-womens-hockey-projects-from-big-data-cup-2021-analytics-otthac-stathletes) and the [data they made available](https://github.com/bigdatacup/Big-Data-Cup-2021) revolutionized what we were able to thanks to the detailed play-by-play data for the season and the x/y location data. That wave continued with the inaugural [WHKYHAC conference](https://www.whkyhac.com/) in July that produced some amazing conversations and projects in the women's hockey space.

In the past, the lack of data and poor access to data have been the biggest barrier to entry in women's hockey analytics, a barrier that this package intends to alleviate.

*****************************************************************

## Installation

You can install the CRAN version of [**```fastRhockey```** ](https://CRAN.R-project.org/package=fastRhockey) with:
```r
install.packages("fastRhockey")
```
You can install the released version of [**`fastRhockey`**](https://github.com/sportsdataverse/fastRhockey/) from [GitHub](https://github.com/sportsdataverse/fastRhockey) with:

``` r
# 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/fastRhockey", dependencies = TRUE, update = TRUE)
```
If you would prefer the `devtools` installation:
``` r
if (!requireNamespace('devtools', quietly = TRUE)){
install.packages('devtools')
}
devtools::install_github(repo = "sportsdataverse/fastRhockey")
```

*********************************************************

## Documentation

You can find the [documentation](https://fastRhockey.sportsdataverse.org/) for [**`fastRhockey`**](https://github.com/sportsdataverse/fastRhockey) on [GitHub pages](https://fastRhockey.sportsdataverse.org/).

You can view CSVs of historical boxscore and play-by-play on the [**`fastRhockey`**](https://github.com/sportsdataverse/fastRhockey/) [data repo](https://github.com/sportsdataverse/fastRhockey-data), as well as the process for scraping that historical data.

*********************************************************

## Breaking Changes

[**Full News on Releases**](http://fastrhockey.sportsdataverse.org/news/index.html)

********************************************************************

## Follow the SportsDataverse (@sportsdataverse) on Twitter and star this repo

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

## **Our Authors**

- Ben Howell (@BenHowell71)

@BenHowell71

- Saiem Gilani (@saiemgilani)

@saiemgilani

## **Our Contributors (they're awesome)**

- Alyssa Longmuir (@alyssastweeting)

@Aklongmuir

- Tan Ho (@_TanHo)
@tanho63

## **Citations**

To cite the [**`fastRhockey`**](https://fastRhockey.sportsdataverse.org/) R package in publications, use:

BibTex Citation
```bibtex
@misc{howell_gilani_fastRhockey_2021,
author = {Ben Howell and Saiem Gilani},
title = {fastRhockey: The SportsDataverse's R Package for Hockey Data.},
url = {https://fastRhockey.sportsdataverse.org/},
year = {2021}
}
```