NBDC Data Tools: Building Analysis-ready Datasets From ABCD and HBCD Releases in R and Python

Abstract

Abstract

act The NIH Brain Development Cohorts (NBDC) Data Hub provides access to large-scale longitudinal datasets, including the Adolescent Brain Cognitive Development (ABCD) Study® and the HEALthy Brain and Child Development (HBCD) Study. The studies release their tabulated data as hundreds of tables with tens of thousands of variables. Turning these files into a dataset for a particular analysis poses substantial informatics challenges, especially when data preparation and analysis workflows must be reproducible and reusable for new releases. We therefore developed NBDC Data Tools, a suite of open-source packages for preparing NBDC data in local or other approved computing environments. NBDCtools is the core R package for dataset construction and processing. The Python package nbdctools either calls the R workflow or assembles datasets natively in Python, and the R package NBDCtoolsData provides the release metadata support for both NBDCtools and nbdctools. Users define a dataset in code by naming the study, the release, and the variables or tables they need. The software then uses the standardized metadata released by the studies to locate the relevant files, join tables on the participant and session identifiers, convert data types, attach labels, and optionally recode non-response codes as missing values. Because the dataset definition is a short script that runs on the original release files, it can be rerun, shared with collaborators, and reported in publications. NBDC Data Tools complements the web-based data platforms of the NBDC Data Hub by providing a reproducible, scriptable path from approved data access to analysis-ready data for statistical analysis.