compute_fitbit_activity_week: Generates weekly activity summaries

In ABCDscores: Summary Scores of the Adolescent Brain Cognitive Development (ABCD) Study

Generates weekly activity summaries

Description

Generates weekly activity summaries from daily Fitbit activity data.

This wrapper function applies a standardized weekly aggregation pipeline using compute_fitbit_weekly_summary() and the summarize_activity() function to compute weekly activity metrics at the participant-session level.

Only days passing minimum quality control thresholds (qc_600min and qc_steps) are included in the weekly aggregation.

Usage

compute_fitbit_activity_week(df, filter_expr = qc_600min & qc_steps)

Arguments

df	tbl. Daily-level Fitbit activity dataset (standard or extended), typically fitbit_ss_activity_day or fitbit_ss_ext_activity_day.
filter_expr	expression. Logical filtering condition applied to the input dataset before summarization (e.g., QC thresholds). which retains only days with at least 600 valid minutes and passing step count quality checks.

Details

This function standardizes weekly activity computation across datasets by enforcing consistent filtering, aggregation, and output structure.

Value

tbl. Weekly activity dataset containing:

• Week identifiers (wk, wk_type)

• Day counts (n_day, n_wkdy, n_wknd)

• Activity summary metrics (steps, METs, intensity minutes, heart rate)

• Mean heart rate metrics (mean_hrate, mean_hrate_actv), present only when the daily input was built with include_mean_hrate = TRUE

• Weekly quality control flag (qc_wk)

Note

• df: fitbit_ss_activity_day or fitbit_ss_ext_activity_day (daily Fitbit activity dataset with QC flags)

ABCDscores documentation built on Nov. 12, 2026, 1:07 a.m.