% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/qc-dashboard-plots.R
\name{plot_gazepoint_signal_activity}
\alias{plot_gazepoint_signal_activity}
\title{Plot Gazepoint biometric signal activity}
\usage{
plot_gazepoint_signal_activity(
  data,
  signal_cols = NULL,
  group_cols = NULL,
  metric = c("active_signal", "nonzero_prop", "missing_prop", "n_unique_finite"),
  max_groups = 30,
  title = NULL
)
}
\arguments{
\item{data}{A Gazepoint biometric data frame, or an
\code{audit_gazepoint_signal_activity()} result.}

\item{signal_cols}{Optional signal columns used when \code{data} is a raw data
frame.}

\item{group_cols}{Optional grouping columns used when \code{data} is a raw data
frame.}

\item{metric}{Summary metric to plot.}

\item{max_groups}{Maximum number of groups to display.}

\item{title}{Optional plot title.}
}
\value{
A ggplot object with the package plot contract attached.
}
\description{
Plots signal-activity summaries produced by
\code{\link[=audit_gazepoint_signal_activity]{audit_gazepoint_signal_activity()}}, or computes them from a biometric data
frame. The plot is intended for quality-control review of signal
availability, missingness, zero activity, and basic activity status. It does
not infer emotion, valence, cognition, preference, trust, or physiological
diagnosis.
}
