wehoop: Access Women's Basketball Play by Play Data

Description

A utility for working with women's basketball data. A scraping and aggregating interface for the WNBA Stats API https://stats.wnba.com/ and ESPN's https://www.espn.com women's college basketball and WNBA statistics. It provides users with the capability to access the game play-by-plays, box scores, standings and results to analyze the data for themselves.

A utility for working with women's basketball data. A scraping and aggregating interface for the WNBA Stats API https://stats.wnba.com/ and ESPN's https://www.espn.com women's college basketball and WNBA statistics. It provides users with the capability to access the game play-by-plays, box scores, standings and results to analyze the data for themselves.

Author(s)

Maintainer: Saiem Gilani saiem.gilani@gmail.com

Authors:

• Geoffery Hutchinson geoffery.hutchinson@gmail.com

See Also

Useful links:

• https://wehoop.sportsdataverse.org

• https://github.com/sportsdataverse/wehoop

• Report bugs at https://github.com/sportsdataverse/wehoop/issues

Useful links:

• https://wehoop.sportsdataverse.org

• https://github.com/sportsdataverse/wehoop

• Report bugs at https://github.com/sportsdataverse/wehoop/issues

Add players on court in WNBA Stats API play-by-play

Description

Add players on court in WNBA Stats API play-by-play

Check Status function

Description

Check Status function

Usage

check_status(res)

Arguments

Load .csv / .csv.gz file from a remote connection

Description

This is a thin wrapper on data.table::fread

Usage

csv_from_url(...)

Arguments

Get women's college basketball conferences

Description

Get women's college basketball conferences

Usage

espn_wbb_conferences()

Value

Returns a tibble

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_conferences())

Get ESPN women's college basketball game data (play-by-play, team and player box)

Description

Get ESPN women's college basketball game data (play-by-play, team and player box)

Usage

espn_wbb_game_all(game_id)

Arguments

Value

A named list of dataframes: Plays, Team, Player

Plays

Team

Player

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_game_all(game_id = 401276115))
 

Get ESPN women's college basketball game rosters

Description

Get ESPN women's college basketball game rosters

Usage

espn_wbb_game_rosters(game_id)

Arguments

Value

A game rosters data frame

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_game_rosters(game_id = 401276115))

Get ESPN women's college basketball play by play data

Description

Get ESPN women's college basketball play by play data

Usage

espn_wbb_pbp(game_id)

Arguments

Value

Returns a play-by-play data frame

Plays

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_pbp(game_id = 401498717))

Get ESPN women's college basketball player box

Description

Get ESPN women's college basketball player box

Usage

espn_wbb_player_box(game_id)

Arguments

Value

Returns a player boxscore data frame

Player

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_player_box(game_id = 401276115))

Get ESPN women's college basketball player stats data

Description

Get ESPN women's college basketball player stats data

Usage

espn_wbb_player_stats(athlete_id, year, season_type = "regular", total = FALSE)

Arguments

Value

Returns a tibble with the player stats data

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_player_stats(athlete_id = 2984250, year = 2022))

Get women's college basketball AP and Coaches poll rankings

Description

Get women's college basketball AP and Coaches poll rankings

Usage

espn_wbb_rankings()

Value

Returns a tibble

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

# Get current AP and Coaches Poll rankings

  try(espn_wbb_rankings())

Get ESPN women's college basketball schedule for a specific year

Description

Get ESPN women's college basketball schedule for a specific year

Usage

espn_wbb_scoreboard(season)

Arguments

Value

Returns a tibble

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

# Get schedule from date 2022-11-15

  try(espn_wbb_scoreboard (season = "20230225"))

Get ESPN women's college basketball standings

Description

Get ESPN women's college basketball standings

Usage

espn_wbb_standings(year)

Arguments

Value

Returns a tibble

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_team_box(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_standings(2021))
 

Get ESPN women's college basketball team box data

Description

Get ESPN women's college basketball team box data

Usage

espn_wbb_team_box(game_id)

Arguments

Value

Returns a team boxscore data frame

Team

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_stats(), espn_wbb_teams()

Examples

  try(espn_wbb_team_box(game_id = 401276115))

Get ESPN women's college basketball team stats data

Description

Get ESPN women's college basketball team stats data

Usage

espn_wbb_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

Value

Returns a tibble with the team stats data

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_teams()

Examples

  try(espn_wbb_team_stats(team_id = 52, year = 2020))

Get ESPN women's college basketball team names and ids

Description

Get ESPN women's college basketball team names and ids

Usage

espn_wbb_teams(year = most_recent_wbb_season())

Arguments

Value

Returns a teams infomation data frame

Author(s)

Saiem Gilani

See Also

Other ESPN WBB Functions: espn_wbb_conferences(), espn_wbb_game_all(), espn_wbb_game_rosters(), espn_wbb_pbp(), espn_wbb_player_box(), espn_wbb_player_stats(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_standings(), espn_wbb_team_box(), espn_wbb_team_stats()

Examples

  try(espn_wbb_teams())

Get ESPN's WNBA game data (play-by-play, team and player box)

Description

Get ESPN's WNBA game data (play-by-play, team and player box)

Usage

espn_wnba_game_all(game_id)

Arguments

Value

A named list of dataframes: Plays, Team, Player

Plays

Team

Player

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

  try(espn_wnba_game_all(game_id = 401244185))

Get ESPN WNBA game rosters

Description

Get ESPN WNBA game rosters

Usage

espn_wnba_game_rosters(game_id)

Arguments

Value

A game rosters data frame

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

  try(espn_wnba_game_rosters(game_id = 401244185))

Get ESPN's WNBA play by play data

Description

Get ESPN's WNBA play by play data

Usage

espn_wnba_pbp(game_id)

Arguments

Value

Returns a play-by-play data frame

Plays

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

   try(espn_wnba_pbp(game_id = 401455681))

Get ESPN's WNBA player box data

Description

Get ESPN's WNBA player box data

Usage

espn_wnba_player_box(game_id)

Arguments

Value

Returns a player boxscore data frame

Player

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

  try(espn_wnba_player_box(game_id = 401244185))

Get ESPN WNBA player stats data

Description

Get ESPN WNBA player stats data

Usage

espn_wnba_player_stats(
  athlete_id,
  year,
  season_type = "regular",
  total = FALSE
)

Arguments

Value

Returns a tibble with the player stats data

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

  try(espn_wnba_player_stats(athlete_id = 2529130, year = 2022))

Get WNBA schedule for a specific year/date from ESPN's API

Description

Get WNBA schedule for a specific year/date from ESPN's API

Usage

espn_wnba_scoreboard(season)

Arguments

Value

Returns a tibble

Author(s)

Saiem Gilani.

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

# Get schedule from date 2022-08-31

  try(espn_wnba_scoreboard (season = "20220831"))

Get ESPN WNBA Standings

Description

Get ESPN WNBA Standings

Usage

espn_wnba_standings(year)

Arguments

Value

Returns a tibble

Author(s)

Geoff Hutchinson

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_team_box(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

  try(espn_wnba_standings(year = 2021))

Get ESPN's WNBA team box data

Description

Get ESPN's WNBA team box data

Usage

espn_wnba_team_box(game_id)

Arguments

Value

Returns a team boxscore data frame

Team

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_stats(), espn_wnba_teams()

Examples

   try(espn_wnba_team_box(game_id = 401244185))

Get ESPN WNBA team stats data

Description

Get ESPN WNBA team stats data

Usage

espn_wnba_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

Value

Returns a tibble with the team stats data

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_teams()

Examples

  try(espn_wnba_team_stats(team_id = 18, year = 2020))

Get ESPN's WNBA team names and ids

Description

Get ESPN's WNBA team names and ids

Usage

espn_wnba_teams()

Value

Returns a tibble

Author(s)

Saiem Gilani

See Also

Other ESPN WNBA Functions: espn_wnba_game_all(), espn_wnba_game_rosters(), espn_wnba_pbp(), espn_wnba_player_box(), espn_wnba_player_stats(), espn_wnba_scoreboard(), espn_wnba_standings(), espn_wnba_team_box(), espn_wnba_team_stats()

Examples

  try(espn_wnba_teams())

Parse ESPN WBB PBP, helper function

Description

Parse ESPN WBB PBP, helper function

Usage

helper_espn_wbb_pbp(resp)

Arguments

Value

Returns a tibble

Parse ESPN WBB Player Box, helper function

Description

Parse ESPN WBB Player Box, helper function

Usage

helper_espn_wbb_player_box(resp)

Arguments

Value

Returns a tibble

Parse ESPN WBB Team Box, helper function

Description

Parse ESPN WBB Team Box, helper function

Usage

helper_espn_wbb_team_box(resp)

Arguments

Value

Returns a tibble

Parse ESPN WNBA PBP, helper function

Description

Parse ESPN WNBA PBP, helper function

Usage

helper_espn_wnba_pbp(resp)

Arguments

Value

Returns a tibble

Parse ESPN WNBA Player Box, helper function

Description

Parse ESPN WNBA Player Box, helper function

Usage

helper_espn_wnba_player_box(resp)

Arguments

Value

Returns a tibble

Parse ESPN WNBA Team Box, helper function

Description

Parse ESPN WNBA Team Box, helper function

Usage

helper_espn_wnba_team_box(resp)

Arguments

Value

Returns a tibble

Load wehoop women's college basketball play-by-play

Description

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_wbb_pbp(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

A dataframe with 55 columns:

shooting_play

Logical value (TRUE/FALSE) indicating whether the play was a shooting play

sequence_number

Sequence number is supposed to represent a shot-possession, examine the last two numbers to see if there are multiple events that occur within the same shot-possession. A shot-possession is basically any sequence of plays until there is a shot, change in possession, and probably things like technical fouls and the like. So as soon as a shot goes up, a new sequence starts regardless, even if the shooting team retains possession via offensive or deadball rebound. The first portion of the number is usually time related (i.e. the numeric representation of when the sequence started, from a seconds remaining in the period perspective or so)

period_display_value

Long form of period (1st quarter, 2nd Quarter, OT, etc.)

period_number

The numeric period of play in the game

home_score

Home score at the time of the play

scoring_play

Logical value (TRUE/FALSE) indicating whether the play was a play on which the offense scored

clock_display_value

Time left within the period

team_id

Unique team identification number for the offensive team

type_id

Unique play type identifcation number

type_text

Play type text description

away_score

Away score at the time of the play

id

Unique play identifcation number

text

Text description of the play

score_value

The points value of the shot taken

participants_0_athlete_id

Unique player identification number

participants_1_athlete_id

Unique player identification number

season

Season of the game

season_type

Season type of the game, 1 is pre-season, 2 is regular season, 3 is post-season, 4 is off-season

away_team_id

Unique away team identification number

away_team_name

Away team name

away_team_mascot

Away team mascot

away_team_abbrev

Text abbreviation for the away team

away_team_name_alt

Alternate versions of the away team abbreviation

home_team_id

Unique home team identification number

home_team_name

home team name

home_team_mascot

home team mascot

home_team_abbrev

Text abbreviation for the home team

home_team_name_alt

Alternate versions of the home team abbreviation

home_team_spread

The game spread with respect to the home team

game_spread

Game spread in (-X Team) format

home_favorite

Logical (TRUE/FALSE) indicating whether the home team is favored

game_spread_available

Logical (TRUE/FALSE) indicating whether the spread was available from ESPN. Basically, I would just not recommend using any of the spread information, I think I defaulted a lot of them to -2.5 for the home team. Most games probably do not have spread information. This column should really be listed first

game_id

Unique identifier for the game event

qtr

Quarter of the game

time

Time left within the period

clock_minutes

Clock minutes split from seconds for developer convenience

clock_seconds

Clock seconds split from minutes for developer convenience

half

Half of the game

game_half

Half of the game

lag_qtr

A lag column on the quarter

lead_qtr

A lead column on the quarter

lag_game_half

A lag column on the half

lead_game_half

A lead column on the half

start_quarter_seconds_remaining

Quarter seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)

start_half_seconds_remaining

Game half seconds remaining at the start of the play (these are more or less code artifacts from other sports, but may eventually be used more seriously)

start_game_seconds_remaining

Game seconds remaining at the start of the play (”')

game_play_number

Game play number

end_quarter_seconds_remaining

Quarter seconds remaining at the end of the play (”')

end_half_seconds_remaining

Game half seconds remaining at the end of the play (”')

end_game_seconds_remaining

Game seconds remaining at the end of the play (”')

period

Period of the game

coordinate_x

The entire scale is a rectangle of size 25x47, intended as a half-court representation of the basketball court (i.e. on the side of the offense), with each coordinate unit representing a foot. It appears that the basket is roughly represented as the (25, 0) point. This is a nonsensical definition when considering that the basket overhangs the court, with the backboard aligned 48 inches from the baseline, then the center of the hoop being roughly 11 inches from there. This is an idiosyncracy of either sensor placement or software and data entry. Use your best judgement in making your charts, I think you will find that making some translations will be helpful.

coordinate_y

week

Apparently there are weeks

media_id

Where did you come from

Examples

  try(load_wbb_pbp())

Load wehoop women's college basketball player box scores

Description

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_wbb_player_box(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

Returns a tibble

Examples

  try(load_wbb_player_box())

Load wehoop women's college basketball schedule

Description

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_wbb_schedule(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

Returns a tibble

Examples

  try(load_wbb_schedule())

Load wehoop women's college basketball team box scores

Description

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_wbb_team_box(
  seasons = most_recent_wbb_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

Returns a tibble

Examples

  try(load_wbb_team_box())

Load wehoop WNBA play-by-play

Description

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_wnba_pbp(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

A dataframe with 42 columns

shooting_play

Logical value (TRUE/FALSE) indicating whether the play was a shooting play

sequence_number

Sequence number is supposed to represent a shot-possession, examine the last two numbers to see if there are multiple events that occur within the same shot-possession. A shot-possession is basically any sequence of plays until there is a shot, change in possession, and probably things like technical fouls and the like. So as soon as a shot goes up, a new sequence starts regardless, even if the shooting team retains possession via offensive or deadball rebound. The first portion of the number is usually time related (i.e. the numeric representation of when the sequence started, from a seconds remaining in the period perspective or so)

period_display_value

Long form of period (1st quarter, 2nd Quarter, OT, etc.)

period_number

The numeric period of play in the game

home_score

Home score at the time of the play

coordinate_x

The entire scale is a rectangle of size 25x47, intended as a half-court representation of the basketball court (i.e. on the side of the offense), with each coordinate unit representing a foot. It appears that the basket is roughly represented as the (25, 0) point. This is a nonsensical definition when considering that the basket overhangs the court, with the backboard aligned 48 inches from the baseline, then the center of the hoop being roughly 11 inches from there. This is an idiosyncracy of either sensor placement or software and data entry. Use your best judgement in making your charts, I think you will find that making some translations will be helpful.

coordinate_y

scoring_play

Logical value (TRUE/FALSE) indicating whether the play was a play on which the offense scored

clock_display_value

Time left within the period

team_id

Unique team identification number for the offensive team

type_id

Unique play type identifcation number

type_text

Play type text description

away_score

Away score at the time of the play

id

Unique play identifcation number

text

Text description of the play

score_value

The points value of the shot taken

participants_0_athlete_id

Unique player identification number

participants_1_athlete_id

Unique player identification number

participants_2_athlete_id

Unique player identification number

type_abbreviation

Play type abbreviation

season

Season of the game

season_type

Season type of the game, 1 is pre-season, 2 is regular season, 3 is post-season, 4 is off-season

away_team_id

Unique away team identification number

away_team_name

Away team name

away_team_mascot

Away team mascot

away_team_abbrev

Text abbreviation for the away team

away_team_name_alt

Alternate versions of the away team abbreviation

home_team_id

Unique home team identification number

home_team_name

home team name

home_team_mascot

home team mascot

home_team_abbrev

Text abbreviation for the home team

home_team_name_alt

Alternate versions of the home team abbreviation

home_team_spread

The game spread with respect to the home team

game_spread

Game spread in (-X Team) format. There are almost none, I would recommend not trusting any of these three columns

home_favorite

Logical (TRUE/FALSE) indicating whether the home team is favored

clock_minutes

Clock minutes split from seconds for developer convenience

clock_seconds

Clock seconds split from minutes for developer convenience

half

Half of the game

lag_half

A lag column on the half

lead_half

A lead column on the half

game_play_number

Game play number

game_id

Unique identifier for the game event

Examples

  try(load_wnba_pbp())

Load wehoop WNBA player box scores

Description

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_wnba_player_box(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

Returns a tibble

Examples

  try(load_wnba_player_box())

Load wehoop WNBA schedules

Description

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_wnba_schedule(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

Returns a tibble

Examples

  try(load_wnba_schedule())

Load wehoop WNBA team box scores

Description

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_wnba_team_box(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

Value

Returns a tibble

Examples

  try(load_wnba_team_box())

Most Recent Women's College Basketball Season

Description

Most Recent Women's College Basketball Season

Usage

most_recent_wbb_season()

Most Recent WNBA Season

Description

Most Recent WNBA Season

Usage

most_recent_wnba_season()

Get Women's college basketball NET rankings for the current date from the NCAA website

Description

Get Women's college basketball NET rankings for the current date from the NCAA website

Usage

ncaa_wbb_NET_rankings()

Value

Returns a tibble

Author(s)

Saiem Gilani

Examples

# Get current NCAA NET rankings

  try(ncaa_wbb_NET_rankings())

Scrape NCAA Women's Baskebtall Teams (Division I, II, and III)

Description

This function allows the user to obtain NCAA teams by year and division

Usage

ncaa_wbb_teams(year = most_recent_wbb_season(), division = 1, ...)

Arguments

Details

  ncaa_wbb_teams(year = 2023, division = 1)

Value

A data frame with the following variables

Progressively

Description

This function helps add progress-reporting to any function - given function f() and progressor p(), it will return a new function that calls f() and then (on-exiting) will call p() after every iteration.

Usage

progressively(f, p = NULL)

Arguments

Details

This is inspired by purrr's safely, quietly, and possibly function decorators.

Value

a function that does the same as f but it calls p() after iteration.

Load .rds file from a remote connection

Description

Load .rds file from a remote connection

Usage

rds_from_url(url)

Arguments

Value

a dataframe as created by readRDS()

Retry http request with proxy

Description

This is a thin wrapper on httr::RETRY

Usage

request_with_proxy(
  url,
  params = list(),
  origin = "https://stats.wnba.com",
  referer = "https://www.wnba.com/",
  ...
)

Arguments

Build/update wehoop WBB play-by-play database

Description

update_wbb_db() updates or creates a database with wehoop play by play data of all completed and available games since 2002.

Usage

update_wbb_db(
  dbdir = ".",
  dbname = "wehoop_db",
  tblname = "wehoop_wbb_pbp",
  force_rebuild = FALSE,
  db_connection = NULL
)

Arguments

Details

This function creates and updates a data table with the name tblname within a SQLite database (other drivers via db_connection) located in dbdir and named dbname. The data table combines all play by play data for every available game back to the 2002 season and adds the most recent completed games as soon as they are available for wehoop.

The argument force_rebuild is of hybrid type. It can rebuild the play by play data table either for the whole wehoop era (with force_rebuild = TRUE) or just for specified seasons (e.g. force_rebuild = c(2019, 2020)). Please note the following behavior:

• force_rebuild = TRUE: The data table with the name tblname will be removed completely and rebuilt from scratch. This is helpful when new columns are added during the Off-Season.

• force_rebuild = c(2019, 2020): The data table with the name tblname will be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.

The parameter db_connection is intended for advanced users who want to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that the arguments dbdir and dbname are dropped in case a db_connection is provided but the argument tblname will still be used to write the data table into the database.

Value

Logical TRUE/FALSE

Build/update wehoop WNBA play-by-play database

Description

update_wnba_db() updates or creates a database with wehoop play by play data of all completed and available games since 2002.

Usage

update_wnba_db(
  dbdir = ".",
  dbname = "wehoop_db",
  tblname = "wehoop_wnba_pbp",
  force_rebuild = FALSE,
  db_connection = NULL
)

Arguments

Details

This function creates and updates a data table with the name tblname within a SQLite database (other drivers via db_connection) located in dbdir and named dbname. The data table combines all play by play data for every available game back to the 2002 season and adds the most recent completed games as soon as they are available for wehoop.

The argument force_rebuild is of hybrid type. It can rebuild the play by play data table either for the whole wehoop era (with force_rebuild = TRUE) or just for specified seasons (e.g. force_rebuild = c(2019, 2020)). Please note the following behavior:

• force_rebuild = TRUE: The data table with the name tblname will be removed completely and rebuilt from scratch. This is helpful when new columns are added during the Off-Season.

• force_rebuild = c(2019, 2020): The data table with the name tblname will be preserved and only rows from the 2019 and 2020 seasons will be deleted and re-added. This is intended to be used for ongoing seasons because ESPN's data provider can make changes to the underlying data during the week.

The parameter db_connection is intended for advanced users who want to use other DBI drivers, such as MariaDB, Postgres or odbc. Please note that the arguments dbdir and dbname are dropped in case a db_connection is provided but the argument tblname will still be used to write the data table into the database.

Value

Logical TRUE/FALSE

Get WNBA Stats API All-time Leaders Grid

Description

Get WNBA Stats API All-time Leaders Grid

Get WNBA Stats API All-time Leaders Grid

Usage

wnba_alltimeleadersgrids(
  league_id = "10",
  per_mode = "PerGame",
  season_type = "Regular Season",
  top_x = 10,
  ...
)

Arguments

Details

  wnba_alltimeleadersgrids(league_id = '10')

Value

Returns a named list of data frames: ASTLeaders, BLKLeaders, DREBLeaders, FG3ALeaders, FG3MLeaders, FG3_PCTLeaders, FGALeaders, FGMLeaders, FG_PCTLeaders, FTALeaders, FTMLeaders, FT_PCTLeaders, GPLeaders, OREBLeaders, PFLeaders, PTSLeaders, REBLeaders, STLLeaders, TOVLeaders

GPLeaders

PTSLeaders

ASTLeaders

STLLeaders

OREBLeaders

DREBLeaders

REBLeaders

BLKLeaders

FGMLeaders

FGALeaders

FG_PCTLeaders

TOVLeaders

FG3MLeaders

FG3ALeaders

FG3_PCTLeaders

PFLeaders

FTMLeaders

FTALeaders

FT_PCTLeaders

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_assistleaders(), wnba_assisttracker(), wnba_homepagewidget(), wnba_leagueleaders()

Get WNBA Stats API Assist Leaders

Description

Get WNBA Stats API Assist Leaders

Get WNBA Stats API Assist Leaders

Usage

wnba_assistleaders(
  league_id = "10",
  per_mode = "PerGame",
  player_or_team = "Team",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

Details

 wnba_assistleaders(league_id = '10', player_or_team = "Player")
 wnba_assistleaders(league_id = '10', player_or_team = "Team")

Value

Returns a named list of data frames: AssistLeaders

AssistLeaders

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_alltimeleadersgrids(), wnba_assisttracker(), wnba_homepagewidget(), wnba_leagueleaders()

Get WNBA Stats API Assist Tracker

Description

Get WNBA Stats API Assist Tracker

Get WNBA Stats API Assist Tracker

Usage

wnba_assisttracker(
  league_id = "10",
  per_mode = "PerGame",
  season = most_recent_wnba_season() - 1,
  season_type = "Regular Season",
  ...
)

Arguments

Details

  wnba_assisttracker(league_id = '10')

Value

Returns a named list of data frames: AssistTracker

AssistTracker

Author(s)

Saiem Gilani

See Also

Other WNBA Leaders Functions: wnba_alltimeleadersgrids(), wnba_assistleaders(), wnba_homepagewidget(), wnba_leagueleaders()

Get WNBA Stats API Boxscore Advanced V2

Description

Get WNBA Stats API Boxscore Advanced V2

Get WNBA Stats API Boxscore Advanced V2

Usage

wnba_boxscoreadvancedv2(
  game_id,
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments

Details

  wnba_boxscoreadvancedv2(game_id = "1022200034")

Value

Returns a named list of data frames: PlayerStats, TeamStats

PlayerStats

TeamStats

Author(s)

Saiem Gilani

See Also

Other WNBA Boxscore Functions: wnba_boxscorefourfactorsv2(), wnba_boxscoremiscv2(), wnba_boxscoreplayertrackv2(), wnba_boxscorescoringv2(), wnba_boxscoresummaryv2(), wnba_boxscoretraditionalv2(), wnba_boxscoreusagev2(), wnba_gamerotation(), wnba_hustlestatsboxscore()

Get WNBA Stats API Boxscore Advanced V3

Description

Get WNBA Stats API Boxscore Advanced V3

Get WNBA Stats API Boxscore Advanced V3

Usage

wnba_boxscoreadvancedv3(
  game_id = "1022200034",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

Arguments