Volleyball analytics snippets
1 Introduction
This document provides some code snippets and guidance that might help you with volleyball analytics in R, and in particular with the openvolley
family of packages.
openvolley
The openvolley project aims to provide an open-source, freely available software ecosystem to support volleyball analytics. It consists of a family of add-on packages that can be used with the R software package. R provides an enormous range of data manipulation, analysis, modelling, and graphical display functionality, including the ability to build interactive data analysis and visualisation apps.
Contributing
Have some code or corrections that you’d like to contribute to this project? Or a request for something you’d like to see covered? Please join in! Either:
- fork the GitHub repository, create a new branch with your changes, and submit a pull request; or
- open an issue (especially for requests); or
- contact the maintainers directly.
Maintainers and contributors must follow this project’s code of conduct.
Contribution guidelines
if you are forking the repo and submitting a pull request, please create a new branch and make your changes there
please follow the existing code styling and conventions
existing examples typically use tidyverse functions (e.g. using
x %>% dplyr::filter(blah)
rather than direct dataframe-indexing likex[blah, ]
) — but base R code is perfectly fine too, particularly if it’s easier to understandif your code example should actually run and show an output, use
x
and/orpx
as your data inputs if possible. These are from the example file bundled with the datavolley package:<- dv_read(dv_example_file()) x <- plays(x) px
Note that this example file does not have some information scouted (e.g. attack or serve coordinates).
be aware that the project maintainers might modify your code to better fit the existing code style and document structure.