% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/simulation-and-chunking.R
\name{simulate_gazepoint_biometrics}
\alias{simulate_gazepoint_biometrics}
\title{Simulate Gazepoint-style biometric signals}
\usage{
simulate_gazepoint_biometrics(
  n_seconds = 120,
  sampling_rate = 60,
  participant_id = "sim_p1",
  scr_onsets = NULL,
  scr_rate_per_min = 4,
  pulse_rate_bpm = 72,
  respiration_rate_bpm = 15,
  eda_noise_sd = 0.01,
  ppg_noise_sd = 0.02,
  include_ttl = TRUE,
  seed = NULL
)
}
\arguments{
\item{n_seconds}{Duration in seconds.}

\item{sampling_rate}{Sampling rate in Hz.}

\item{participant_id}{Participant identifier.}

\item{scr_onsets}{Optional SCR onset times in seconds.}

\item{scr_rate_per_min}{Expected SCR events per minute when \code{scr_onsets} is
\code{NULL}.}

\item{pulse_rate_bpm}{Mean pulse rate.}

\item{respiration_rate_bpm}{Respiration-modulation rate.}

\item{eda_noise_sd}{EDA noise SD.}

\item{ppg_noise_sd}{PPG noise SD.}

\item{include_ttl}{Logical. If \code{TRUE}, adds TTL0 pulses at SCR onsets.}

\item{seed}{Optional random seed.}
}
\value{
A list with \code{overview}, \code{data}, \code{ground_truth}, and \code{settings}.
}
\description{
Generates synthetic Gazepoint-style EDA, PPG, HR, IBI, and TTL-like signals
with known ground-truth events. This is intended for teaching, examples, unit
tests, and model-validation workflows. It does not generate real participant
physiology.
}
