% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/nonlinear-complexity.R
\name{extract_gazepoint_hrv_nonlinear}
\alias{extract_gazepoint_hrv_nonlinear}
\title{Extract nonlinear HRV features from IBI/RR intervals}
\usage{
extract_gazepoint_hrv_nonlinear(
  dat,
  ibi_col = "IBI",
  group_cols = NULL,
  min_intervals = 10,
  sampen_m = 2,
  sampen_r_multiplier = 0.2,
  mse_scales = 1:5
)
}
\arguments{
\item{dat}{A data frame containing IBI/RR intervals.}

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

\item{group_cols}{Optional grouping columns.}

\item{min_intervals}{Minimum finite intervals per group.}

\item{sampen_m}{Embedding dimension for sample entropy.}

\item{sampen_r_multiplier}{Tolerance multiplier applied to the within-group SD.}

\item{mse_scales}{Integer scales used for multiscale entropy.}
}
\value{
A list with \code{overview}, \code{features}, and \code{settings}.
}
\description{
Computes dependency-light nonlinear HRV descriptors from IBI/RR intervals,
including Poincare SD1/SD2, sample entropy, approximate entropy,
multiscale entropy, and detrended fluctuation analysis.
}
\details{
These are variability and complexity descriptors. They should not be
interpreted as direct emotion, cognitive-load, health-status, or diagnostic
labels by themselves.
}
