% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/pdr-rsa.R
\name{calculate_gazepoint_rsa}
\alias{calculate_gazepoint_rsa}
\title{Calculate respiration-informed RSA proxy features}
\usage{
calculate_gazepoint_rsa(
  dat,
  ibi_col = "IBI",
  time_col = "CNT",
  group_cols = NULL,
  pdr = NULL,
  resp_rate_hz = NULL,
  respiration_band = c(0.12, 0.4),
  resample_rate = 4
)
}
\arguments{
\item{dat}{A data frame containing IBI/RR data.}

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

\item{time_col}{Time column for the IBI/RR observations.}

\item{group_cols}{Optional grouping columns.}

\item{pdr}{Optional output from \code{extract_gazepoint_pdr_signals()}.}

\item{resp_rate_hz}{Optional fixed respiration rate in Hz.}

\item{respiration_band}{Default respiration/HF band when no PDR rate is
available.}

\item{resample_rate}{Resampling rate for spectral RSA proxy calculation.}
}
\value{
A list with \code{overview}, \code{rsa_summary}, and \code{settings}.
}
\description{
Calculates dependency-light RSA proxy summaries from IBI/RR intervals and,
optionally, PPG-derived respiration features from
\code{extract_gazepoint_pdr_signals()}. This provides peak-to-trough and
Porges-Bohrer-inspired band-power proxy summaries. These outputs should be
interpreted as respiration-informed HRV/RSA features, not direct clinical
vagal-tone estimates.
}
