% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/scr-threshold-sensitivity.R
\name{run_gazepoint_scr_threshold_sensitivity}
\alias{run_gazepoint_scr_threshold_sensitivity}
\title{Run Gazepoint SCR threshold sensitivity checks}
\usage{
run_gazepoint_scr_threshold_sensitivity(
  data,
  phasic_col = NULL,
  signal_col = NULL,
  time_col = NULL,
  group_cols = NULL,
  amplitude_min_values = c(0.005, 0.01, 0.02, 0.03),
  min_peak_distance_values = c(1, 5, 10, 20, 30),
  recovery_fraction = 0.5,
  smooth_width = 1,
  events = NULL,
  event_time_col = NULL,
  event_id_col = NULL,
  event_label_col = NULL,
  ttl_cols = NULL,
  ttl_valid_col = NULL,
  event_detection = c("rising", "active"),
  analysis_window = c(0, 6),
  response_window = c(1, 4),
  peak_selection = c("largest_amplitude", "first_peak"),
  collapse_simultaneous_events = FALSE,
  include_event_windows = TRUE,
  keep_objects = FALSE
)
}
\arguments{
\item{data}{A Gazepoint biometric data frame.}

\item{phasic_col}{Optional phasic EDA signal column, typically
\code{GSR_US_PHASIC}.}

\item{signal_col}{Optional conductance-like fallback signal column, typically
\code{GSR_US}.}

\item{time_col}{Optional time/counter column.}

\item{group_cols}{Optional grouping columns.}

\item{amplitude_min_values}{Numeric vector of SCR amplitude thresholds.}

\item{min_peak_distance_values}{Numeric vector of minimum peak distances.}

\item{recovery_fraction}{Fraction used by \code{detect_gazepoint_scr_peaks()} to
define recovery.}

\item{smooth_width}{Optional moving-average width passed to
\code{detect_gazepoint_scr_peaks()}.}

\item{events}{Optional event table passed to
\code{summarise_gazepoint_scr_event_windows()}.}

\item{event_time_col}{Optional event-time column when \code{events} is supplied.}

\item{event_id_col}{Optional event identifier column when \code{events} is supplied.}

\item{event_label_col}{Optional event label column when \code{events} is supplied.}

\item{ttl_cols}{Optional TTL columns for event derivation when \code{events} is
\code{NULL}.}

\item{ttl_valid_col}{Optional TTL validity column.}

\item{event_detection}{Event-detection rule for TTL columns.}

\item{analysis_window}{Event-relative analysis window.}

\item{response_window}{Event-relative response window.}

\item{peak_selection}{Peak-selection rule for event-window summaries.}

\item{collapse_simultaneous_events}{Logical. Passed to
\code{summarise_gazepoint_scr_event_windows()}.}

\item{include_event_windows}{Logical. If \code{TRUE}, compute event-window
summaries for each sensitivity setting.}

\item{keep_objects}{Logical. If \code{TRUE}, retain peak-detection and
event-window objects in list columns.}
}
\value{
A list with \code{overview}, \code{sensitivity_grid},
\code{peak_group_summary}, \code{event_window_summary}, optional \code{objects}, and
\code{settings}.
}
\description{
Re-runs SCR peak detection across combinations of amplitude thresholds and
minimum peak-distance settings. Optionally, it also carries each peak-detection
result through SCR event-window summaries so users can see how preprocessing
choices affect event-level response rates.
}
