au_individual: Calculate individual player scores

In openvolley/auvolley: Volleyball Scoring with the Athletes Unlimited Scoring System

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)

openvolley/auvolley documentation built on Dec. 11, 2021, 12:47 p.m.