% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/environment-confounds-and-ipfm.R
\name{model_gazepoint_hrv_ipfm}
\alias{model_gazepoint_hrv_ipfm}
\title{Model heartbeat timing using an IPFM-style impulse train}
\usage{
model_gazepoint_hrv_ipfm(
  dat,
  ibi_col = "IBI",
  beat_time_col = NULL,
  group_cols = NULL,
  ibi_units = c("auto", "seconds", "milliseconds"),
  output_sampling_rate = 4,
  max_frequency = 0.5
)
}
\arguments{
\item{dat}{A data frame.}

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

\item{beat_time_col}{Optional explicit beat-time column.}

\item{group_cols}{Optional grouping columns.}

\item{ibi_units}{\code{"auto"}, \code{"seconds"}, or \code{"milliseconds"}.}

\item{output_sampling_rate}{Sampling rate for regular impulse train in Hz.}

\item{max_frequency}{Maximum frequency returned in spectrum.}
}
\value{
A list with \code{overview}, \code{beat_table}, \code{impulse_table},
\code{spectrum_table}, \code{summary}, and \code{settings}.
}
\description{
Builds an impulse-train representation of heartbeat timing from IBI/RR
intervals or beat times and computes a simple spectrum of the resulting
impulse train. This is an IPFM-style model-preparation helper, not a perfect
reconstruction of sinoatrial-node physiology.
}
