Repository navigation
Expand file tree
/
Copy pathREADME.Rmd
More file actions
63 lines (42 loc) · 4.45 KB
/
Copy pathREADME.Rmd
File metadata and controls
63 lines (42 loc) · 4.45 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-"
)
```
# datavolley
<!-- badges: start -->
[](https://github.com/openvolley/datavolley/actions/workflows/R-CMD-check.yaml)
[](https://www.tidyverse.org/lifecycle/#stable)

[](https://codecov.io/gh/openvolley/datavolley?branch=master)
<!-- badges: end -->
An R package for reading volleyball scouting files in DataVolley format (`*.dvw`), collected for example with [ovscout2](https://ovscout2.openvolley.org) or the commercial DataVolley, Click and Scout, or VolleyStation software. VolleyStation files in `*.vsm` format are also supported.
See also:
- the [package vignette](https://datavolley.openvolley.org/articles/datavolley.html) for more examples and information
- these [code snippets](https://snippets.openvolley.org/) for volleyball analytics in R with datavolley and the other openvolley packages
- this [DataVolley file validator](https://apps.untan.gl/dvalidate/) and [suite of analytical apps](https://apps.untan.gl/), which are built on the datavolley package.
The [peranavolley](https://peranavolley.openvolley.org/) package provides similar functionality for reading files scouted by the [AOC VBStats](http://peranasports.com/software/vbstatshd/) software.
If you want to analyze your own volleyball matches, you can use the [ovscout2](https://ovscout2.openvolley.org) application to collect the data.
## Installation
```{r eval=FALSE}
install.packages("datavolley", repos = c("https://openvolley.r-universe.dev",
"https://cloud.r-project.org"))
## or
## install.packages("remotes") ## if needed
remotes::install_github("openvolley/datavolley")
```
## Example
Read one of the example data files bundled with the package:
```{r}
library(datavolley)
x <- dv_read(dv_example_file(), insert_technical_timeouts = FALSE)
summary(x)
```
## Troubleshooting
If you see unexpected behaviour, try `dv_read(..., do_warn = TRUE, verbose = TRUE)` to obtain more diagnostic information during the process of reading and parsing the DataVolley file. If your player or team names are garbled (strange characters) check the text encoding that `dv_read(..., verbose = TRUE)` tells you that it is using - you may need to override this with the correct one via the `encoding` parameter.