Package 'auvolley'

Title: Volleyball Scoring with the Athletes Unlimited Scoring System
Description: Volleyball scoring following the Athletes Unlimited scoring system.
Authors: Ben Raymond [aut, cre], Adrien Ickowicz [aut], openvolley.org [org]
Maintainer: Ben Raymond <[email protected]>
License: MIT + file LICENSE
Version: 0.0.7
Built: 2024-10-22 03:15:30 UTC
Source: https://github.com/openvolley/auvolley

Help Index


Calculate individual player scores

Description

The Athletes Unlimited league plays matches of 3 sets, each to 25 points. To apply their scoring system to normal volleyball games, we need to decide what to do with sets 4 and 5 (if played). If you only want to count things that happened in the first 3 (or 4) sets, then you should remove data rows associated with sets 5 and/or 4 before calling this function. Otherwise, the set_5_weighting parameter allows the count of actions from set 5 to be scaled.

Usage

au_individual(
  x,
  set_5_weighting = 25/15,
  scoring = au_scoring(),
  infer_sets = FALSE,
  no_set_attacks = c("PR", "PP", "P2")
)

Arguments

x

datavolley or datavolleyplays: a datavolley object as returned by datavolley::dv_read(), or the plays component of one

set_5_weighting

numeric: the weighting that should be applied to actions from the fifth set of a match (if it went that long)

scoring

list: the scores to apply for each outcome. See au_scoring() for details

infer_sets

logical: set this to TRUE if the scout has not included all setting actions. Some scouts will not include setting actions unless the set is an error, or made by the non-designated setter. Using infer_sets = TRUE will insert a new setting action (made by the on-court setter) on attacks that don't have a corresponding set action scouted (excluding those in no_set_attacks)

no_set_attacks

character: a vector of attack codes for which sets are not expected (setter dumps, attacks on overpasses, second-ball attacks)

Details

Most of the actions that are counted are self-explanatory: serve aces, attack kills, and serve, pass, attack, and set errors. The perhaps-less obvious ones:

  • A pass (serve reception) is counted if it is a perfect or positive pass

  • A set assist is a set that leads to an attack kill

  • Digs are counted on opposition attacks and block cover, if scouted, but not freeball passes. All dig grades except dig errors and digs directly back over the net are counted

  • Only block kills are counted

Value

A tibble with a breakdown by player of points in each category, along with

  • points : each player's total points scored. If set 5 results have been included, points scored in set 5 will be scaled by set_5_weighting

  • points_per_set: each player's total points divided by the number of sets they played

  • adjusted_points: each player's total points but adjusted for game length. The adjusted_points = points_per_set * 3 * nmatches * playing_time where nmatches is the average number of matches played by each team, and playing_time is (number of sets played by the player) / (number of sets played by their team)

References

https://auprosports.com/volleyball/how-we-play-volleyball/

See Also

au_scoring()

Examples

x <- datavolley::dv_read(datavolley::dv_example_file())
au_individual(x)

The default scores for each outcome

Description

The default scores for each outcome

Usage

au_scoring()

Value

A named list with components ace, serve_error, pass, pass_error, assist, set_error, kill, attack_error, block, and dig, giving the numeric score for each

References

https://auprosports.com/volleyball/how-we-play-volleyball/


auvolley

Description

Volleyball scoring following the Athletes Unlimited scoring system.