| Title: | Extract Data from Professional Volleyball Leagues in North America |
| Version: | 2.0.0 |
| Description: | Gather boxscore, play-by-play, and auxiliary data from Major League Volleyball (MLV) https://provolleyball.com, League One Volleyball Pro (LOVB) https://www.lovb.com/pro-league, and Athletes Unlimited Pro Volleyball (AU) https://auprosports.com/volleyball/ to create a repository of basic and advanced statistics for teams and players. |
| License: | MIT + file LICENSE |
| Encoding: | UTF-8 |
| RoxygenNote: | 7.3.2 |
| URL: | https://github.com/awosoga/rvolleydata, https://awosoga.github.io/rvolleydata/ |
| BugReports: | https://github.com/awosoga/rvolleydata/issues |
| Depends: | R (≥ 4.1.0) |
| Imports: | dplyr, lubridate, readr, tibble |
| Suggests: | knitr, rmarkdown |
| VignetteBuilder: | knitr |
| NeedsCompilation: | no |
| Packaged: | 2026-01-07 21:07:16 UTC; ddawosog |
| Author: | David Awosoga 
[aut, cre, cph],
Matthew Chow
[aut],
Ryan Du [aut] |
| Maintainer: | David Awosoga <odo.awosoga@gmail.com> |
| Repository: | CRAN |
| Date/Publication: | 2026-01-08 04:00:02 UTC |
Load cleaned events log data from the volleydata repository.
Description
Load cleaned events log data from the volleydata repository.
Usage
load_events_log(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
A data frame containing the events log data for the specified seasons.
| Column Name | Type |
| match_id | int |
| season | int |
| match_datetime | chr |
| set | int |
| set_start_time | chr |
| set_end_time | chr |
| set_duration | int |
| set_final_home_score | int |
| set_final_away_score | int |
| event_type | chr |
| event_time | chr |
| libero_enters | lgl |
| team_involved | chr |
| libero_jersey_number | int |
| libero_substitute_jersey_number | int |
| rally_start_time | chr |
| rally_end_time | chr |
| rally_point_winner | chr |
| substitute_in_jersey_number | int |
| substitute_out_jersey_number | int |
| challenge_approved | chr |
| challenge_reason | chr |
| challenge_method | chr |
| challenge_response | chr |
| challenge_at_home_score | dbl |
| challenge_at_away_score | dbl |
| challenge_score_change | chr |
| serving_team | chr |
| current_home_score | dbl |
| current_away_score | dbl |
| home_team_p1 | dbl |
| home_team_p2 | dbl |
| home_team_p3 | dbl |
| home_team_p4 | dbl |
| home_team_p5 | dbl |
| home_team_p6 | dbl |
| away_team_p1 | dbl |
| away_team_p2 | dbl |
| away_team_p3 | dbl |
| away_team_p4 | dbl |
| away_team_p5 | dbl |
| away_team_p6 | dbl |
| verified_time | chr |
| verified_method | chr |
| sanction_type | chr |
| sanction_remark | dbl |
| sanction_staff_role | chr |
| staff_first_name | chr |
| staff_last_name | chr |
| staff_type | chr |
| is_exceptional | chr |
| league | chr |
Examples
try({load_events_log("mlv", 2024)})
Load cleaned officials data from the volleydata repository.
Description
Load cleaned officials data from the volleydata repository.
Usage
load_officials(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
| Column Name | Type |
| match_id | int |
| season | int |
| match_datetime | chr |
| officials_type | chr |
| full_name | chr |
| first_name | chr |
| last_name | chr |
| level | chr |
| league | chr |
Examples
try({load_officials("mlv", 2024)})
Load cleaned play-by-play data form the volleydata repository.
Description
Load cleaned play-by-play data form the volleydata repository.
Usage
load_pbp(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
A data frame containing the play-by-play data for the specified seasons.
| Column Name | Type |
| match_id | int |
| season | int |
| match_datetime | chr |
| home_team_name | chr |
| away_team_name | chr |
| team_involved | chr |
| jersey_number | int |
| action | chr |
| outcome | chr |
| set | int |
| point_number | int |
| point_winner | chr |
| home_score | int |
| away_score | int |
| rally_length | int |
Examples
try({load_pbp("mlv", 2024)})
Load cleaned player boxscore data from the volleydata repository.
Description
Load cleaned player boxscore data from the volleydata repository.
Usage
load_player_boxscore(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
A data frame containing player boxscore data for the specified seasons.
| Column Name | Type |
| match_id | int |
| season | int |
| match_datetime | chr |
| team_involved | chr |
| team_name | chr |
| player_name | chr |
| last_name | chr |
| first_name | chr |
| sets_played | int |
| player_number | chr |
| is_captain | lgl |
| is_libero | int |
| set_starting_position | chr |
| set_number | int |
| serves | int |
| serve_errors | int |
| serve_aces | int |
| serve_efficiency | dbl |
| attack_attempts | int |
| attack_errors | int |
| attack_kills | int |
| attack_success_ratio | dbl |
| attack_efficiency | dbl |
| receptions | int |
| reception_errors | int |
| positive_reception_ratio | dbl |
| perfect_reception_ratio | dbl |
| block_points | int |
| block_touches | int |
| earned_points | int |
| net_points | int |
| assists | int |
| successful_digs | int |
| id | chr |
| spike_hp | int |
| points | int |
| league | chr |
Examples
try({load_player_boxscore("mlv", 2024)})
Load cleaned player info from the volleydata repository.
Description
Load cleaned player info from the volleydata repository.
Usage
load_player_info(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
A data frame containing the player info data for the specified seasons.
| Column Name | Type |
| match_id | int |
| season | int |
| match_datetime | chr |
| player_id | int |
| player_name | chr |
| first_name | chr |
| last_name | chr |
| jersey_number | int |
| primary_position | int |
| roster_status | chr |
| is_foreign | lgl |
| is_confederation | lgl |
| is_captain | lgl |
| is_libero | lgl |
| set_1_is_starter | lgl |
| set_1_starting_position | int |
| set_2_is_starter | lgl |
| set_2_starting_position | int |
| set_3_is_starter | lgl |
| set_3_starting_position | int |
| set_4_is_starter | lgl |
| set_4_starting_position | int |
| set_5_is_starter | lgl |
| set_5_starting_position | int |
| team_name | chr |
| team_short_name | chr |
| team_code | chr |
| team_color | chr |
| league | chr |
Examples
try({load_player_info("mlv", 2024)})
Load cleaned schedule data from the volleydata repository.
Description
Load cleaned schedule data from the volleydata repository.
Usage
load_schedule(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. All years must be 2023 or later. |
Value
| Column Name | Type |
| season | int |
| date | chr |
| home_team | chr |
| away_team | chr |
| home_team_set_wins | int |
| away_team_set_wins | int |
| result | chr |
| match_id | int |
| phase | chr |
| league | chr |
Examples
try({load_schedule("mlv", 2024)})
Load cleaned team boxscore data from the volleydata repository.
Description
Load cleaned team boxscore data from the volleydata repository.
Usage
load_team_boxscore(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
A data frame containing team boxscore data for the specified seasons.
| Column Name | Type |
| match_id | int |
| season | int |
| match_datetime | chr |
| team_involved | chr |
| team_name | chr |
| set_number | int |
| serves | int |
| serve_errors | int |
| serve_aces | int |
| serve_efficiency | dbl |
| attack_attempts | int |
| attack_errors | int |
| attack_kills | int |
| attack_success_ratio | dbl |
| attack_efficiency | dbl |
| receptions | int |
| reception_errors | int |
| positive_reception_ratio | dbl |
| perfect_reception_ratio | dbl |
| block_points | int |
| block_touches | int |
| earned_points | int |
| net_points | int |
| assists | int |
| successful_digs | int |
| id | chr |
| spike_hp | int |
| points | int |
| league | chr |
Examples
try({load_team_boxscore("mlv", 2024)})
Load cleaned team staff data from the volleydata repository.
Description
Load cleaned team staff data from the volleydata repository.
Usage
load_team_staff(league = NULL, seasons = NULL)
Arguments
league |
A string specifying which of "mlv", "lovb", or "au" to load data for. |
seasons |
An integer or vector of integers of seasons to fetch data for. Defaults to all available seasons. |
Value
A data frame containing the team staff data for the specified seasons.
| Column Name | Type |
| match_id | dbl |
| season | dbl |
| match_datetime | chr |
| team_name | chr |
| staff_type | chr |
| full_name | chr |
| first_name | chr |
| last_name | chr |
| league | chr |
Examples
try({load_team_staff("mlv", 2024)})