% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/cardiorespiratory-causality.R
\name{analyze_gazepoint_cardiorespiratory_causality}
\alias{analyze_gazepoint_cardiorespiratory_causality}
\title{Analyse cardiorespiratory Granger-style directionality}
\usage{
analyze_gazepoint_cardiorespiratory_causality(
  dat,
  respiration_col,
  cardiac_col,
  time_col = NULL,
  group_cols = NULL,
  lag_order = 3,
  min_rows = 30,
  standardise = TRUE
)
}
\arguments{
\item{dat}{A data frame.}

\item{respiration_col}{Numeric respiration proxy column.}

\item{cardiac_col}{Numeric cardiac column, such as HR, IBI, or RR.}

\item{time_col}{Optional time column for ordering.}

\item{group_cols}{Optional grouping columns.}

\item{lag_order}{VAR lag order.}

\item{min_rows}{Minimum complete rows per group.}

\item{standardise}{Logical. If \code{TRUE}, z-standardise both series per group.}
}
\value{
A list with \code{overview}, \code{causality_summary}, and \code{settings}.
}
\description{
Computes dependency-light linear Granger-style directionality tests between a
respiration proxy and heart-rate or IBI/RR signal. This estimates predictive
directionality in a VAR-style model. It does not prove physiological
causality from observational data by itself.
}
