% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/windows.R
\name{summarise_gazepoint_hr_windows}
\alias{summarise_gazepoint_hr_windows}
\title{Summarise Gazepoint heart-rate windows}
\usage{
summarise_gazepoint_hr_windows(
  data,
  group_columns = NULL,
  value_column = "HR",
  validity_column = "HRV",
  exclude_zero = TRUE
)
}
\arguments{
\item{data}{A data frame or a path to a Gazepoint CSV export.}

\item{group_columns}{Optional grouping columns defining windows, such as
\code{c("USER", "MEDIA_ID")}.}

\item{value_column}{Heart-rate value column. Defaults to \code{"HR"}.}

\item{validity_column}{Heart-rate validity column. Defaults to \code{"HRV"}.}

\item{exclude_zero}{Should zero values be excluded from usable summaries?}
}
\value{
A data frame with one row per window.
}
\description{
Summarises Gazepoint heart-rate values within participant, trial, stimulus,
AOI, or other user-defined windows. \code{HRV} is treated as a validity flag, not
as a heart-rate-variability metric.
}
