% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/ibi-hr-hrv-core.R
\name{filter_gazepoint_ibi_implausible}
\alias{filter_gazepoint_ibi_implausible}
\title{Filter implausible Gazepoint IBI values}
\usage{
filter_gazepoint_ibi_implausible(
  data,
  ibi_col = "IBI",
  time_col = NULL,
  group_cols = NULL,
  validity_col = NULL,
  unit = c("auto", "ms", "seconds"),
  min_ibi_ms = 300,
  max_ibi_ms = 2000,
  max_change_ms = 400,
  max_change_prop = 0.3,
  output_col = "IBI_clean_ms"
)
}
\arguments{
\item{data}{A Gazepoint biometric data frame.}

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

\item{time_col}{Optional time/counter column.}

\item{group_cols}{Optional grouping columns.}

\item{validity_col}{Optional validity column.}

\item{unit}{Unit of the IBI column: \code{"auto"}, \code{"ms"}, or \code{"seconds"}.}

\item{min_ibi_ms}{Minimum plausible IBI in milliseconds.}

\item{max_ibi_ms}{Maximum plausible IBI in milliseconds.}

\item{max_change_ms}{Maximum plausible absolute adjacent IBI change within
group, in milliseconds.}

\item{max_change_prop}{Maximum plausible proportional adjacent IBI change
within group.}

\item{output_col}{Name of the cleaned IBI output column.}
}
\value{
A list with \code{overview}, \code{data}, \code{row_flags}, \code{group_summary}, and
\code{settings}.
}
\description{
Flags and optionally cleans implausible inter-beat interval values. The helper
is conservative and does not remove rows; instead, it returns row-level flags
and a cleaned IBI column with implausible values set to \code{NA}.
}
