Plot signal-quality diagnostics — plot_gazepoint_signal

Creates a lightweight ggplot diagnostic for signal-quality metrics or labels. The plot is intended for quality control and audit reporting only.

Usage

plot_gazepoint_signal_quality(
  quality,
  metric = "prop_missing",
  x = NULL,
  colour = NULL,
  facet = NULL
)

quality: A data frame returned by compute_gazepoint_signal_quality() or classify_gazepoint_signal_quality().
metric: Metric to plot. Use "quality_label" for label counts.
x: Optional x-axis column. If omitted, the function uses the first available column among participant, participant_id, trial, trial_id, segment, segment_id, session, or signal.
colour: Optional colour/grouping column.
facet: Optional faceting column. Defaults to "signal" when available.

A ggplot object.