% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/distributional-drift.R
\name{audit_gazepoint_distributional_drift}
\alias{audit_gazepoint_distributional_drift}
\title{Audit distributional drift across sessions or ordered blocks}
\usage{
audit_gazepoint_distributional_drift(
  dat,
  signal_cols,
  session_col = "session",
  participant_col = NULL,
  reference_session = NULL,
  bins = 10,
  psi_warn = 0.1,
  psi_fail = 0.25
)
}
\arguments{
\item{dat}{A data frame containing longitudinal biometric data.}

\item{signal_cols}{Numeric signal columns to audit.}

\item{session_col}{Session/block/timepoint column.}

\item{participant_col}{Optional participant column.}

\item{reference_session}{Optional reference session. If \code{NULL}, the first
ordered session is used within each participant/global group.}

\item{bins}{Number of bins for PSI.}

\item{psi_warn}{PSI threshold for warning.}

\item{psi_fail}{PSI threshold for failure.}
}
\value{
A list with \code{overview}, \code{drift_summary}, and \code{settings}.
}
\description{
Compares signal distributions across sessions/blocks using baseline-vs-current
differences, Kolmogorov-Smirnov tests, and Population Stability Index (PSI).
}
