% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/eda-artifact-qc.R
\name{audit_gazepoint_eda_artifacts}
\alias{audit_gazepoint_eda_artifacts}
\title{Audit Gazepoint EDA/GSR artifacts}
\usage{
audit_gazepoint_eda_artifacts(
  data,
  signal_col = NULL,
  time_col = NULL,
  group_cols = NULL,
  prefer_gsr_us = TRUE,
  jump_threshold_sd = 6,
  slope_threshold_sd = 6,
  flat_run_length = 20,
  zero_run_length = 20,
  saturation_min = NULL,
  saturation_max = NULL,
  negative_allowed = NULL
)
}
\arguments{
\item{data}{A data frame containing Gazepoint biometric rows.}

\item{signal_col}{Optional EDA/GSR signal column. If \code{NULL}, the function
prefers \code{GSR_US} and then falls back to common Gazepoint EDA columns.}

\item{time_col}{Optional time/counter column. If \code{NULL}, common Gazepoint
time columns are detected automatically.}

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

\item{prefer_gsr_us}{Logical. If \code{TRUE}, prefer \code{GSR_US} when \code{signal_col}
is not supplied.}

\item{jump_threshold_sd}{Robust z threshold for absolute signal jumps.}

\item{slope_threshold_sd}{Robust z threshold for absolute signal slopes.}

\item{flat_run_length}{Minimum repeated-value run length flagged as flatline.}

\item{zero_run_length}{Minimum zero-value run length flagged as zero run.}

\item{saturation_min}{Optional lower bound for acceptable signal values.}

\item{saturation_max}{Optional upper bound for acceptable signal values.}

\item{negative_allowed}{Optional logical. If \code{NULL}, negative values are
allowed for phasic component columns but not for conductance-like columns.}
}
\value{
A list with \code{overview}, \code{row_flags}, \code{artifact_runs},
\code{group_summary}, and \code{settings}.
}
\description{
Flags row-level artifacts in Gazepoint electrodermal activity signals,
preferring \code{GSR_US} conductance when available. The helper detects abrupt
jumps, abrupt slopes, flatline runs, zero runs, negative conductance values,
and optional out-of-range values. It is a conservative preprocessing/QC
helper and does not interpret EDA as emotional valence.
}
