% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/aoi-biometrics.R
\name{prepare_gazepoint_aoi_biometrics_model_data}
\alias{prepare_gazepoint_aoi_biometrics_model_data}
\title{Prepare AOI-biometric model data}
\usage{
prepare_gazepoint_aoi_biometrics_model_data(
  x,
  outcome_col = "mean_value",
  predictor_cols = c("aoi_label", "signal"),
  factor_cols = c("aoi_label", "signal"),
  numeric_cols = NULL,
  group_cols = NULL,
  drop_missing_outcome = TRUE,
  min_rows = NULL,
  standardise_outcome = FALSE,
  standardise_within = c("signal", "all")
)
}
\arguments{
\item{x}{A \code{gazepoint_aoi_biometrics_summary} object or summary data frame.}

\item{outcome_col}{Outcome column to model.}

\item{predictor_cols}{Optional predictor columns to retain.}

\item{factor_cols}{Optional columns converted to factors.}

\item{numeric_cols}{Optional columns converted to numeric.}

\item{group_cols}{Optional grouping columns for random-effect formulas.}

\item{drop_missing_outcome}{Logical. If \code{TRUE}, rows with missing outcomes are
removed.}

\item{min_rows}{Optional minimum contributing rows required.}

\item{standardise_outcome}{Logical. If \code{TRUE}, add a z-scored outcome column.}

\item{standardise_within}{Standardization scope used when
\code{standardise_outcome = TRUE}. Use \code{"signal"} to z-score within each
biometric signal or \code{"all"} to z-score across all rows.}
}
\value{
A list with \code{overview}, \code{model_data}, \code{variable_summary},
\code{model_formulas}, and \code{settings}.
}
\description{
Converts AOI-biometric summaries into a modelling-ready table for GLM/LMM/GLMM
workflows.
}
