% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/pyppg-hrp-support.R
\name{assess_gazepoint_hrp_waveform_quality}
\alias{assess_gazepoint_hrp_waveform_quality}
\title{Assess Gazepoint HRP waveform quality}
\usage{
assess_gazepoint_hrp_waveform_quality(
  data,
  hrp_col = NULL,
  time_col = NULL,
  group_cols = NULL,
  sampling_rate = NULL,
  time_unit = c("auto", "ms", "seconds", "samples"),
  min_rows = 20,
  min_finite_prop = 0.8,
  max_flat_prop = 0.95,
  flat_tolerance = 1e-08,
  max_gap_multiplier = 3
)
}
\arguments{
\item{data}{A Gazepoint biometric data frame or a list containing one.}

\item{hrp_col}{Optional HRP/PPG waveform column. If \code{NULL}, common column
names are detected.}

\item{time_col}{Optional time, timestamp, or sample-counter column.}

\item{group_cols}{Optional grouping columns.}

\item{sampling_rate}{Optional sampling rate in Hz.}

\item{time_unit}{Unit of \code{time_col}: \code{"auto"}, \code{"ms"}, \code{"seconds"}, or
\code{"samples"}.}

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

\item{min_finite_prop}{Minimum finite waveform proportion required per group.}

\item{max_flat_prop}{Maximum allowed proportion of near-zero consecutive
differences among finite waveform values.}

\item{flat_tolerance}{Absolute difference threshold used to identify near-flat
consecutive waveform changes.}

\item{max_gap_multiplier}{Time gaps larger than this multiple of the median
positive time step are flagged.}
}
\value{
A list with \code{overview}, \code{group_quality}, \code{row_flags}, and \code{settings}.
}
\description{
Computes descriptive quality-control summaries for a Gazepoint HRP/PPG
waveform column. The output is intended for waveform availability,
missingness, flatness, and timing-gap review. It does not infer diagnosis,
emotion, valence, cognition, preference, or true physiological state.
}
