% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/time-activity-qc.R
\name{audit_gazepoint_signal_activity}
\alias{audit_gazepoint_signal_activity}
\title{Audit Gazepoint biometric signal activity}
\usage{
audit_gazepoint_signal_activity(
  data,
  signal_cols = NULL,
  group_cols = NULL,
  zero_is_inactive = TRUE,
  min_unique_nonzero = 2,
  missing_as_inactive = TRUE
)
}
\arguments{
\item{data}{A data frame containing Gazepoint biometric rows.}

\item{signal_cols}{Optional signal columns. If \code{NULL}, common Gazepoint
biometric columns are detected automatically.}

\item{group_cols}{Optional grouping columns. If \code{NULL}, available source,
participant, media, or trial columns are used.}

\item{zero_is_inactive}{Logical. If \code{TRUE}, all-zero signals are labelled as
inactive.}

\item{min_unique_nonzero}{Minimum number of distinct non-zero finite values
required for an \code{"active"} status.}

\item{missing_as_inactive}{Logical. If \code{TRUE}, all-missing signals are labelled
as insufficient/inactive.}
}
\value{
A list with \code{overview}, \code{signal_by_group}, \code{inactive_groups},
\code{inactive_signals}, and \code{settings}.
}
\description{
Screens biometric signal columns for missingness, all-zero channels, constant
values, low variation, and active signal presence within groups. This helper
is designed to identify inactive files or channels before event-level EDA,
HR, IBI, or multimodal analysis.
}
