vald.extractor (version 0.1.1)

plot_vald_compare: Boxplot Comparison of Metrics by Sport, Sex, or Team

Description

Creates boxplots to compare performance metrics across different groups (e.g., sports, sex, teams). Useful for benchmarking and identifying performance differences between populations.

Usage

plot_vald_compare(
  data,
  metric_col,
  group_col = "sports",
  fill_col = "sex",
  title = NULL,
  y_label = NULL
)

Value

A ggplot2 object.

Arguments

data

Data frame. Test data with grouping variables and metrics.

metric_col

Character. Name of the metric to plot.

group_col

Character. Primary grouping variable (x-axis). Default is "sports".

fill_col

Character. Optional fill color grouping (e.g., "sex"). Default is "sex".

title

Character. Plot title. If NULL, auto-generates from metric name.

y_label

Character. Y-axis label. If NULL, uses metric_col.

Details

Compare Performance Across Groups

Examples

# \donttest{
if (FALSE) {
  test_datasets <- split_by_test(final_analysis_data)

  # Compare CMJ peak force across sports and sex
  plot_vald_compare(
    data = test_datasets$CMJ,
    metric_col = "PEAK_FORCE_Both",
    group_col = "sports",
    fill_col = "sex",
    title = "Peak Force Comparison by Sport and Sex"
  )
}
# }