% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/time-activity-qc.R
\name{audit_gazepoint_time_resets}
\alias{audit_gazepoint_time_resets}
\title{Audit Gazepoint biometric time resets}
\usage{
audit_gazepoint_time_resets(
  data,
  time_col = NULL,
  group_cols = NULL,
  allow_ties = TRUE,
  split_on_negative_step = TRUE,
  return_reindexed_time = FALSE,
  min_segment_rows = 1
)
}
\arguments{
\item{data}{A data frame containing Gazepoint biometric rows.}

\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{allow_ties}{Logical. If \code{TRUE}, repeated time values are not treated as
non-monotonic.}

\item{split_on_negative_step}{Logical. If \code{TRUE}, negative time steps start a
new segment within each group.}

\item{return_reindexed_time}{Logical. If \code{TRUE}, adds
\code{time_reindexed_within_segment}, starting at zero within each detected
segment.}

\item{min_segment_rows}{Minimum rows expected per segment before a segment is
flagged as short.}
}
\value{
A list with \code{overview}, \code{segment_summary}, \code{row_flags},
\code{data_with_segments}, and \code{settings}.
}
\description{
Detects negative time steps, duplicate time steps, non-finite time values, and
recording segments within grouped Gazepoint biometric exports. This helper is
intended for quality control and synchronization inspection. It does not alter
raw values unless \code{return_reindexed_time = TRUE}, in which case an additional
segment-relative time column is added.
}
