% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/scores_nt_fitbit.R
\name{check_params_compute_fitbit_sleep_table}
\alias{check_params_compute_fitbit_sleep_table}
\title{Check parameters for compute_fitbit_sleep_table}
\usage{
check_params_compute_fitbit_sleep_table(
  data_activity,
  data_sleep_combined,
  data_daily,
  hr_low,
  hr_high,
  hr_rep_day,
  hr_rep_sleep,
  bin_minutes,
  offset,
  min_slp_minutes
)
}
\arguments{
\item{data_activity}{tbl. Data frame with the following columns with
minute-level epoch data with the following columns:
\itemize{
\item \code{participant_id}: Participant identifier
\item \code{session_id}: Session identifier
\item \code{dtt}: POSIXct epoch timestamp
\item \code{dtt} POSIXct epoch timestamp.
}}

\item{data_sleep_combined}{tbl. Data frame with the following columns in
30-second epoch level with the following columns:
\itemize{
\item \code{participant_id}: Participant identifier
\item \code{session_id}: Session identifier
\item \code{dtt}: POSIXct epoch timestamp
\item \code{stage}: Sleep stage classification (e.g., \code{"light"},  \code{"deep"}, \code{"rem"},
\code{"awake"}).
\item \code{main_slp}: logical. Indicates if epoch is associated with 'main' sleep.
}}

\item{data_daily}{tbl. Daily-level Fitbit-generated summary data containing:
\itemize{
\item \code{participant_id}: Participant identifier
\item \code{session_id}: Session identifier
\item \code{dt}: Calendar date
\item \code{hrate_rest_fitb}: Fitbit-reported resting heart rate in beats per
minute.
}}

\item{hr_low}{numeric. Lower bound threshold for valid heart rate values.}

\item{hr_high}{numeric or NULL. Optional upper bound threshold for valid
heart rate values. If NULL, no upper threshold is applied.}

\item{hr_rep_day}{numeric. Threshold (number of epochs) for identifying
repeated heart rate values during wake/activity periods.}

\item{hr_rep_sleep}{numeric. Threshold (number of epochs) for identifying
repeated heart rate values during sleep periods.}

\item{bin_minutes}{numeric. Number of minutes used to bin activity data when
computing intensity scores (e.g., 1440 for daily aggregation). Default is
NULL. When NULL, it uses \code{offset} to split days, which by default is
\code{12:00} (noon).}

\item{offset}{character. Time of day (HH:MM) used as the cutoff for defining
the sleep day. Timestamps occuring after this time are assigned to the next
day.}

\item{min_slp_minutes}{numeric. Minimum number of sleep minutes required
for a day to pass quality control. Used to create a \code{qc_Xmin} flag
column in the output.}
}
\value{
NULL. Called for its side effects (parameter validation).
}
\description{
Validates all input parameters for \code{\link{compute_fitbit_sleep_table}},
including data frame structure, required column presence, and numeric
parameter constraints.
}
\keyword{internal}
