| Title: | Visualise and Report 'VALD ForceDecks' Test Results |
| Version: | 1.0.0 |
| Description: | Provides a 'shiny' dashboard and plotting utilities to explore and report 'VALD ForceDecks' testing data. Includes interactive modules for metric exploration, radar charts, longitudinal comparisons, quadrant plots, and athlete reports. |
| License: | MIT + file LICENSE |
| Encoding: | UTF-8 |
| RoxygenNote: | 7.3.3 |
| Depends: | R (≥ 4.1.0) |
| Suggests: | rmarkdown, knitr, testthat (≥ 3.0.0) |
| Imports: | shiny, bslib, readr, dplyr, ggplot2, tibble, tidyr, zoo, DT, plotly, magrittr, lubridate, RColorBrewer, pagedown, webshot2, shinycssloaders, rlang |
| Config/testthat/edition: | 3 |
| NeedsCompilation: | no |
| Packaged: | 2026-01-12 01:58:42 UTC; KieranHarrison |
| Author: | Kieran Harrison [aut, cre], VALD Support [ctb], VALD [cph] (Copyright holder) |
| Maintainer: | Kieran Harrison <k.harrison@vald.com> |
| Repository: | CRAN |
| Date/Publication: | 2026-01-17 11:10:02 UTC |
valdrViz: VALD ForceDecks visualisations
Description
Tools to explore and report ForceDecks testing data, including metric exploration, radar charts, longitudinal comparisons, quadrants and player reports.
Author(s)
Maintainer: Kieran Harrison k.harrison@vald.com
Other contributors:
VALD Support support@vald.com [contributor]
VALD (Copyright holder) [copyright holder]
Forward pipe operator
Description
See 'magrittr::%>%' for details.
Usage
lhs %>% rhs
Arguments
lhs, rhs |
Objects to pipe. |
Value
The result of applying the right-hand side expression to the left-hand side value.
Required ForceDecks columns
Description
Vector of column names expected in ForceDecks CSV exports.
Usage
REQ
Format
An object of class character of length 10.
Read all valid ForceDecks CSVs from a folder
Description
Recursively scans a folder for .csv files, keeps only those that
contain the required ForceDecks columns, and returns a standardised
combined data.frame. Returns NULL if nothing valid is found.
Usage
fd_read_folder(folder)
Arguments
folder |
Folder path. |
Standardise ForceDecks data
Description
Adds Date and Athlete columns and removes duplicate
trialId/resultName rows.
Usage
fd_standardise(df)
Arguments
df |
A data.frame read from one or more ForceDecks CSVs. |
Run the VALD ForceDecks Performance Dashboard
Description
Launches an interactive 'shiny' application for exploring your ForceDecks data.
Usage
forcedecks_performance_dashboard(
data = NULL,
launch.browser = TRUE,
tabs = c("metric_explorer", "radar", "longit", "quadrant", "player_report")
)
Arguments
data |
Optional ForceDecks data.frame. If NULL, the app will prompt for CSV files. |
launch.browser |
Logical. Launch app in a browser window. |
tabs |
Character vector of tabs to show. |
Value
No return value, called for side effects (launches the 'shiny' application).
Examples
if (interactive()) {
forcedecks_performance_dashboard()
}
Convert a HTML file to PDF
Description
Tries pagedown::chrome_print() if Chrome is available,
otherwise falls back to webshot2::webshot().
Usage
html_to_pdf(html_file, out_pdf)
Arguments
html_file |
Path to source HTML file. |
out_pdf |
Path to output PDF. |
Palette helper for metric plots
Description
Returns a qualitative palette for up to ~12 metrics, then falls back
to hcl.colors() for larger sets.
Usage
metric_pal(n)
Arguments
n |
Number of colours required. |
Read a single ForceDecks CSV
Description
Safely reads a CSV file and checks that all required columns are present.
Returns NULL on failure.
Usage
read_fd(path)
Arguments
path |
Path to a CSV file. |
Rotated x-axis theme for metric plots
Description
Used in Metric Explorer box/violin plots.
Usage
rot_theme
Format
An object of class theme (inherits from ggplot2::theme, gg, S7_object) of length 1.
Shared ggplot theme
Description
Shared ggplot theme
Usage
viz_theme(base_size = 14, base_family = "Roboto")