% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/hrv.R
\name{summarise_gazepoint_ibi_hrv_windows}
\alias{summarise_gazepoint_ibi_hrv_windows}
\title{Summarise Gazepoint IBI-derived HRV windows}
\usage{
summarise_gazepoint_ibi_hrv_windows(
  data,
  group_columns,
  ibi_column = "IBI",
  validity_column = "HRV",
  min_ibi = 0.3,
  max_ibi = 2
)
}
\arguments{
\item{data}{A data frame or a path to a Gazepoint CSV export.}

\item{group_columns}{Columns defining analysis windows, such as
\code{c("source_participant", "MEDIA_ID")}.}

\item{ibi_column}{Interbeat-interval column. Defaults to \code{"IBI"}.}

\item{validity_column}{Optional validity column. Defaults to \code{"HRV"}.}

\item{min_ibi}{Minimum plausible IBI in seconds.}

\item{max_ibi}{Maximum plausible IBI in seconds.}
}
\value{
A data frame with one row per window and IBI-derived HRV summaries.
}
\description{
Summarises interbeat-interval (IBI) values within participant, stimulus,
trial, AOI, or other user-defined windows. This function derives simple
time-domain variability features from \code{IBI}. It does not use the Gazepoint
\code{HRV} column as a heart-rate-variability metric, because \code{HRV} is treated as
the Gazepoint heart-rate validity flag.
}
