% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/hrv-fragmentation-asymmetry.R
\name{extract_gazepoint_hrv_fragmentation}
\alias{extract_gazepoint_hrv_fragmentation}
\title{Extract heart-rate fragmentation features}
\usage{
extract_gazepoint_hrv_fragmentation(
  dat,
  ibi_col = "IBI",
  group_cols = NULL,
  zero_tolerance = 0,
  short_segment_length = 3
)
}
\arguments{
\item{dat}{A data frame containing IBI/RR intervals.}

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

\item{group_cols}{Optional grouping columns.}

\item{zero_tolerance}{Absolute change below which interval differences are
treated as zero.}

\item{short_segment_length}{Maximum segment length counted as short.}
}
\value{
A list with \code{overview}, \code{features}, and \code{settings}.
}
\description{
Computes dependency-light heart-rate fragmentation descriptors from IBI/RR
intervals. Metrics include percentage of inflection points (PIP), inverse
average segment length (IALS), percentage of short segments (PSS), percentage
of alternation segments (PAS), and long/short segment summaries.
}
\details{
These are fragmentation descriptors of interbeat interval dynamics. They
should not be interpreted as clinical diagnoses or direct autonomic-state
labels by themselves.
}
