Sovereign 8s.is mirror of standardgalactic/ADHD_SCdeviation
  • HTML 93.2%
  • R 6.7%
  • MATLAB 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-06-23 10:14:17 +08:00
ADHD_script ADHD_SCdeviation 2026-06-23 10:14:17 +08:00
Data_ABCD ADHD_SCdeviation 2026-06-23 10:14:17 +08:00
Data_Chinese ADHD_SCdeviation 2026-06-23 10:14:17 +08:00
functions upload 20260407 2026-04-07 18:19:27 +08:00
gamfunction upload 20260407 2026-04-07 18:19:27 +08:00
README.md ADHD_SCdeviation 2026-06-23 10:14:17 +08:00

ADHD_deviation

Data and codes for our paper "Developmental deviations of association-network structural connectivity in youths with ADHD predict symptom and treatment outcomes".

We investigated how structural connectivity alterations in youths with ADHD develop with age and their clinical relevance across two large cohorts: the U.S. Adolescent Brain Cognitive Development study (6,687 typically developing and 1,114 ADHD scans) and an independent Chinese cohort (355 typically developing and 477 ADHD participants). The Chinese cohort consist of two studies, EFNY (Executive Function and Neurodevelopment in Youth) and PKU6 (Peking University Sixth Hospital). Data from these two datasets are not yet available because data collection is still ongoing and data sharing is limited by participant privacy protections and institutional restrictions.

Software and system requirements

Diffusion & structural MRI preprocessing

Postprocessing

The system requirements and installation guide for each software can be found on its respective website.

Data

centiles_Yeo17_*.rds
Structure: a list of length 120. Each element contains two 3 × 1000 matrices:

  1. Males: rows correspond to P2.5, P50, and P97.5; columns index age points.
  2. Females: rows correspond to P2.5, P50, and P97.5; columns index age points. Age grid: the 1,000 columns represent age points sampled uniformly across the dataset’s age range.

plotdatasum.df_Yeo17_sumSCdeviation_CV75_*.rds
Data for visualizing developmental trajectories of deviations in structural connectivity strength.

Yeo17_SArank.csv
Median sensorimotor–association (S–A) rank of vertices within each Yeo network.

schaefer376_index_Yeo17.csv
Indices and network labels for the Schaefer-400 atlas with limbic regions removed (376 regions).

ADHD_script

S0_NetworkPlot

Scripts for:

  • plotting the S–A rank distributions across Yeo networks,
  • generating the S–A connectional-axis matrix,
  • creating Yeo-17 network CIFTI files ordered along the S–A axis, and
  • computing Euclidean distances between atlas regions.

S1_dataclean_merge

Scripts for screening participants and organizing structural-connectivity strengths for 120 connections into N_obs × N_conn data frames.

S2_normativemodeling

Scripts for constructing normative models and computing individual deviations per connection.

  1. S1_selectparameters_*.html: Code to select the optimal distribution family and spline parameters for all connections.
  2. S2_bootstrap_*.R: Defines a function that performs one iteration of the bootstrap analysis. Called by S2_bootstrap_*_exe.R.
  3. S3_constructNM_forDeviation_*.R: Constructs the normative models and computes individual deviations.
  4. S4_Evaluate_GAMLSS_*.html: Evaluates the fitted normative models and summarizes model performance.
  5. S5_plotNM_eachGroup_*.html: Visualizes developmental trajectories derived from the normative models and their key features; also plots mean deviations for both groups.
  • R1_bootstrap_ABCD_sigma.R: Defines bootstrap function for sigma-related analyses in the ABCD cohort.
  • R1_bootstrap_ABCD_sigma_exe.R: Executes repeated bootstrap runs for the sigma analysis.
  • R2_NMsigma_Trajectory.R: Examines developmental trajectories of scale (sigma) estimated by the normative models.
  • R3_CompareDevSlopes.R: Compares developmental slopes of deviations across three connection types.

subfolder:

  • R_combat: Validation-analysis scripts for ComBat harmonization in the ABCD cohort.
  • R_nolongitudinal: Validation-analysis scripts for repeating normative modeling using TD training set without longitudinal measurements in the ABCD cohort.
  • R_SiteEffect: Scripts for quantifying site effects (ICC).

S3_directcompare

Scripts for comparing developmental trajectories between ADHD and TD groups and testing age effects on deviations.

  1. S1_compareSCDeviation_ADHDall_VS_TD_ABCD.R: Performs an age × diagnosis interaction analysis on SC deviations.
  2. S2_DeviationChangeByAge_*.html: Tests age effects on SC deviations within each diagnosis group.
  3. R1_AgeBySex_Deviation_ADHD_ABCD.R: Examines age-by-sex effects on SC deviations within the ABCD ADHD sample.
  4. R2_DeviationDevSex_ADHD_ABCD.R: Tests sex differences in developmental patterns of SC deviations.
  5. R3_compareSCDeviationMean_ADHDall_VS_TD_ABCD.R: Compares group-level mean SC deviations between ADHD and TD participants.

S4_association_ADHDsymp_SCstrength

Scripts for examining symptom relevance and treatment associations with deviations in structural connectivity strength.

  1. S1_ADHDsymp_SCstrengthDeviation_ABCD.html: Tests associations between SC deviations and ADHD symptoms in the ABCD dataset.
  2. S1_ADHDsymp_SCstrengthDeviation_EFNYnoCCNP_Update.html: Tests associations between SC deviations and treatment effects in the Chinese cohort.
  3. S2_ADHDsymp_SCDeviation_Med_ABCD.html: Performs mediation analyses of age, deviations, and symptoms.
  4. S3_delta_deviation_delta_symptom_ABCD.html: Tests within-subject associations between rates of change in deviations and rates of change in symptoms.
  5. S4_ADHDsymp_medication_PKU6_Update.html: Examines changes in deviations following medication treatment in the PKU6 cohort.

functions & gamfunction

These two folders contain the R functions required for conducting the analyses in this study.
functions contains project-specific helper functions, including the core GAMLSS functions for normative-model construction and selection of model parameters.
gamfunction contains GAM/GAMM-based utilities used mainly for downstream trajectory analyses, association testing, and result visualization.

GAMLSS-related function scripts:

  • functions/Compare_distributions_gamlss.R:

    • gamlss_comparedistribution(): Compares candidate continuous GAMLSS distribution families and summarizes convergence status and BIC to select the best-fitting family for each structural-connectivity measure.
    • gamlss_compare.bs.df(): Compares B-spline degrees of freedom and polynomial degrees for the mu and sigma model terms under a selected GAMLSS distribution family.
    • Boot.Function(): Performs one bootstrap resampling iteration, refits the specified GAMLSS model, and returns the bootstrap sample and fitted model object for downstream centile and trajectory estimation.
  • functions/Construct_gamlss_set.R:

    • construct_gamlss(): Fits the final GAMLSS normative model for a given structural-connectivity measure, computes model performance summaries including BIC and convergence status, and estimates requested centile curves across the age range, optionally stratified by variables such as sex and site.