% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/ibi-hr-hrv-core.R
\name{extract_gazepoint_hrv_features}
\alias{extract_gazepoint_hrv_features}
\title{Extract time-domain HRV features from Gazepoint IBI intervals}
\usage{
extract_gazepoint_hrv_features(
  data,
  ibi_col = "IBI_clean_ms",
  group_cols = NULL,
  unit = c("auto", "ms", "seconds"),
  min_intervals = 3,
  min_duration_s = 30,
  diff_threshold_ms = 50,
  collapse_repeated_intervals = TRUE,
  repeated_tolerance_ms = 1e-08
)
}
\arguments{
\item{data}{A Gazepoint biometric data frame or \code{gazepoint_ibi_filter} object.}

\item{ibi_col}{IBI/RR interval column.}

\item{group_cols}{Optional grouping columns.}

\item{unit}{Unit of the IBI column: \code{"auto"}, \code{"ms"}, or \code{"seconds"}.}

\item{min_intervals}{Minimum clean intervals required per group.}

\item{min_duration_s}{Minimum IBI-sequence duration in seconds required before
computed HRV features are treated as fully reportable. Groups below this
duration still return features but receive \code{warn_short_hrv_duration}.}

\item{diff_threshold_ms}{Threshold for NN50/pNN50.}

\item{collapse_repeated_intervals}{Logical. If \code{TRUE}, consecutive repeated
IBI values are collapsed before HRV features are computed. This is useful
for Gazepoint exports where the same IBI value may be repeated across
multiple gaze-sampling rows until a new interval is available.}

\item{repeated_tolerance_ms}{Numeric tolerance used when identifying
repeated consecutive IBI values.}
}
\value{
A list with \code{overview}, \code{features}, \code{settings}.
}
\description{
Computes simple time-domain HRV features from genuine IBI/RR intervals. This
helper does not use the Gazepoint \code{HRV} column as an HRV outcome.
}
