• Study
  • Data Usage
    • Access & download data
    • Responsible use
    • Acknowledgment
  • Documentation
    • Curation & structure
    • Non-imaging
    • Imaging
    • Substudies
    • Release notes
  • Tools
    • Data tools
    • R Packages
  • Info
    • FAQs
    • Report issues
    • Changelog
    • Cite this website
  • Version
    • empty
  1. Imaging data
  2. ABCD BIDS Community Collection (ABCC)
  3. Documentation
  4. Imaging
  5. Data processing
  • Curation & structure
    • Data structure
    • Curation standards
    • Naming convention
    • Metadata
  • Non-imaging data
    • ABCD (General)
    • Friends, Family, & Community
    • Genetics
    • Linked External Data
    • Mental Health
    • Neurocognition
    • Novel Technologies
    • Physical Health
    • Substance Use
  • Imaging data
    • Administrative tables
    • Data types
      • Documentation
        • Imaging
          • Concatenated
          • MRI derivatives data documentation
          • Source data / raw data
          • Supplementary tables
    • Scan types
      • Documentation
        • Imaging
          • Diffusion MRI
          • MRI Quality Control
          • Resting-state fMRI
          • Structural MRI
          • Task-based fMRI
          • Task-based fMRI (Behavioral performance)
          • Trial level behavioral performance during task-based fMRI
    • ABCD BIDS Community Collection (ABCC)
      • Documentation
        • Imaging
          • ABCD-BIDS community collection
          • BIDS conversion
          • Data processing
          • Derivatives
          • Quality control procedures
  • Substudy data
    • COVID-19 rapid response research
    • Endocannabinoid
    • IRMA
    • MR Spectroscopy
  • Release notes
    • 6.0 data release

On this page

  • Processing & Analytic Standards
  • ABCD-BIDS Pipeline
    • Additional Details
    • Resolved ABCD-BIDS Pipeline Processing Issues
    • Software
  • QSIPrep
  1. Imaging data
  2. ABCD BIDS Community Collection (ABCC)
  3. Documentation
  4. Imaging
  5. Data processing

Data processing

Below we summarize the procedures and parameters used to process the BIDS input data described here through ABCD-BIDS and QSIPrep pipelines to produce processed derivative. Please see Feczko et al. (2021) for details.

Processing & Analytic Standards

Pipelines used for ABCC processing follow guidelines based on principles and utilities developed by NMIND aimed at promoting reproducibility and standardization in neuroimaging tools (Kiar et al. 2023). Among these is the NMIND Coding Standards Checklist, a comprehensive framework for evaluating the quality of a tool’s documentation, infrastructure, and testing capabilities against open, community-developed, scientific software-development standards. Badge ratings for all tools that complete this review process can be viewed at Evaluated Tools. Software utilized for the ABCC release must undergo NMIND peer review and be published with a DOI. At a minimum, tools must meet the standards equivalent to the Bronze badge in the rating system. Please see the NMIND ratings for ABCD-BIDS and QSIPrep pipelines as follows:

  • QSIPrep
  • ABCD-BIDS

ABCD-BIDS Pipeline

The ABCD-BIDS pipeline is available on GitHub, OSF, and DockerHub at the time of this release as the abcd-hcp-pipeline. It is a BIDS App which takes BIDS input data and uses the methods from both the Human Connectome Project’s minimal preprocessing pipeline (Glasser et al. 2013) and the DCAN Labs resting state fMRI analysis tools to output preprocessed MRI data in both volume and surface spaces. Please see the ABCD-BIDS pipeline webpage for a full overview of this pipeline.

ABCC data was processed through the ABCD-BIDS pipeline in two different ways with the following command and parameters.

For the structural pipeline up to the post-Freesurfer stage:

singularity run --cleanenv \
  -B ${data_dir}/bids_dataset:/bids_dir \
  -B ${data_dir}/derivatives/abcd-hcp-pipeline_v0.1.4:/output_dir \
  -B ${run_dir}/license.txt:/opt/freesurfer/license.txt \
  -B ${run_dir}/ABCD_BIDS_cleaning.json:/ABCD_BIDS_cleaning.json \
  /ABCD-BIDS/abcd-hcp-pipeline_R2019a-test_07222024a.sif \
  /bids_dir /output_dir \
  --freesurfer-license /opt/freesurfer/license.txt \
  --participant-label ${subject_id} \
  --stages "PreFreeSurfer:PostFreeSurfer" \
  --custom-clean /ABCD_BIDS_cleaning.json \
  --ignore func \
  --ncpus 8

For the full pipeline (including all stages):

env -i ${singualrity} run \
  -B ${data_dir}/bids_dataset:/bids_dir \
  -B ${data_dir}/derivatives/abcd-hcp-pipeline_v0.1.4:/output_dir \
  -B ${run_dir}/license.txt:/opt/freesurfer/license.txt \
  -B ${run_dir}/ABCD_BIDS_cleaning.json:/ABCD_BIDS_cleaning.json \
  /ABCD-BIDS/abcd-hcp-pipeline_R2019a-test_07222024a.sif \
  /bids_dir /output_dir \
  --freesurfer-license /opt/freesurfer/license.txt \
  --participant-label ${subject_id} \
  --stages "PreFreeSurfer:CustomClean" \
  --bandstop 18.582 25.726 \
  --custom-clean /ABCD_BIDS_cleaning.json \
  --ncpus 8

Additional Details

Distortion Correction
A single optimal pair of positive (posterior to anterior) and negative (anterior to posterior) spin echo field maps are utilized to correct for distortions in the phase encoding direction of ALL anatomical and functional acquisitions using FSL’s topup (see section on BIDS Conversion for details on fmap pair selection)

Respiratory Motion Filter
In working with ABCD data, we have found that a respiratory artifact is produced within multi-band data (Fair et al. 2020). While this artifact occurs outside the brain, it can affect estimates of frame alignment, leading to inappropriate motion censoring. By filtering the frequencies (18.582 to 25.726 breaths per minute) of the respiratory signal from the motion realignment data (during the DCANBoldProc stage), our respiratory motion filter produces better estimates of FD.

Resolved ABCD-BIDS Pipeline Processing Issues

The following issues occurred while processing the ABCD MRI data through the ABCD-BIDS pipeline. They have been resolved for the current release data, but are included here for additional guidance for those who may wish to process the data themselves:

  1. Fieldmap Dimension Mismatch in TopupPreprocessingAll.sh (GE Only)
    Description: The spin echo fieldmap has different dimensions than the scout image in a portion of GE sessions, causing a preprocessing error.
    Solution: Resize the fieldmaps (fmaps) using the bold file as the reference size.
    Steps to Resolve:
    Run the following command: flirt -in "$fmap_file" -ref "$func_run" -out "$output_file" -applyisoxfm 2.4

  2. Incorrect Fieldmap Assignment in FMRIVolume Step
    Description: The wrong fieldmap is being assigned, leading to processing errors during the FMRIVolume step.
    Solution: Update the fieldmap JSON files to include the correct runs that were missed during previous steps.

  3. FNIRT Read Error - Insufficient Volumes
    Description: FNIRT requires at least three volumes to process. This error occurs when functional data is incomplete or corrupted.
    Solution: Skip the functional pipeline and run only the anatomical pipeline for affected cases.

  4. Issue: Index Error in anat_only Cases
    Description: In anat_only cases, fmap JSON files interfere with the pipeline, causing index errors.
    Solution: Sync only the anat folder for such cases temporarily.

Software

  • ABCD-BIDS Pipeline
  • Advanced Normalization Tools (ANTs)
  • FreeSurfer
  • DCAN Labs resting state fMRI analysis tools
  • BrainSprite
  • DCAN-Labs/cifti-connectivity tools

QSIPrep

QSIPrep configures pipelines for processing diffusion-weighted MRI (dMRI or DWI) data. For more information see the QSIPrep documentation. This is the command used to run ABCC subjects through QSIPrep preprocessing:

singularity run --cleanenv -B ${PWD} \
  pennlinc-containers/.datalad/environments/qsiprep-0-16-1/image \
  inputs/data \
  prep \
  participant \
  -w ${PWD}/.git/wkdir \
  --n_cpus 8 \
  --stop-on-first-crash \
  --fs-license-file code/license.txt \
  --skip-bids-validation \
  --participant-label "$subid" \
  --unringing-method mrdegibbs \
  --output-resolution 1.7 \
  --eddy-config code/eddy_params.json \
  --notrack

Contents of code/eddy_params.json

{
  "flm": "linear",
  "slm": "linear",
  "fep": false,
  "interp": "spline",
  "nvoxhp": 1000,
  "fudge_factor": 10,
  "dont_sep_offs_move": false,
  "dont_peas": false,
  "niter": 5,
  "method": "jac",
  "repol": true,
  "num_threads": 1,
  "is_shelled": true,
  "use_cuda": false,
  "cnr_maps": true,
  "residuals": false,
  "output_type": "NIFTI_GZ",
  "args": ""
}

References

Fair, Damien A., Oscar Miranda-Dominguez, Abraham Z. Snyder, Anders Perrone, Eric A. Earl, Andrew N. Van, Jonathan M. Koller, et al. 2020. NeuroImage 208 (March): 116400. doi:10.1016/j.neuroimage.2019.116400.
Feczko, Eric, Greg Conan, Scott Marek, Brenden Tervo-Clemmens, Michaela Cordova, Olivia Doyle, Eric Earl, et al. 2021. doi:10.1101/2021.07.09.451638.
Glasser, Matthew F., Stamatios N. Sotiropoulos, J. Anthony Wilson, Timothy S. Coalson, Bruce Fischl, Jesper L. Andersson, Junqian Xu, et al. 2013. NeuroImage 80 (October): 105–24. doi:10.1016/j.neuroimage.2013.04.127.
Kiar, Gregory, Jon Clucas, Eric Feczko, Mathias Goncalves, Dorota Jarecka, Christopher J. Markiewicz, Yaroslav O. Halchenko, et al. 2023. Nature Human Behaviour 7 (7): 1027–28. doi:10.1038/s41562-023-01647-0.
 

ABCD Study®, Teen Brains. Today’s Science. Brighter Future.® and the ABCD Study Logo are registered marks of the U.S. Department of Health & Human Services (HHS). Adolescent Brain Cognitive Development℠ Study is a service mark of the U.S. Department of Health & Human Services (HHS).