Inputs


1. About this Document

The data collection contains anatomical MRI images (T1w and T2w), functional MRI images processed through a modified version of the minimal preprocessing pipeline for the Human Connectome Project (HCP), and spin-echo field maps used in preprocessing. BIDS-formatted diffusion-weighted images and their field maps are included as input data, but have not been minimally preprocessed. This document describes the BIDS input data and the steps involved in setting it up for processing through the ABCD-BIDS pipeline. Other documents describe how to download the data using our nda-abcd-s3-downloader tool.

2. Input Data Subsets Breakdown

Sections 3 and onward of this document generally describe what each of the input data subsets are. This section breaks down the exact contents of each of the input data subsets. Subject and session identifiers are instead labeled as #. Each input data subset comes with modality-agnostic BIDS-compatible dataset_description.json, README, and CHANGES files.

inputs.anat.(T1w|T2w)

  • sub-#/ses-#/anat/sub-#_ses-#(_rec-normalized)(_run-#)_(T1w|T2w).json
  • sub-#/ses-#/anat/sub-#_ses-#(_rec-normalized)(_run-#)_(T1w|T2w).nii.gz

inputs.dwi.dwi

  • sub-#/ses-#/dwi/sub-#_ses-#_dwi.bval
  • sub-#/ses-#/dwi/sub-#_ses-#_dwi.bvec
  • sub-#/ses-#/dwi/sub-#_ses-#_dwi.json
  • sub-#/ses-#/dwi/sub-#_ses-#_dwi.nii.gz

inputs.fmap.all

  • sub-#/ses-#/fmap/sub-#_ses-#_dir-(AP|PA)_run-#_epi.json
  • sub-#/ses-#/fmap/sub-#_ses-#_dir-(AP|PA)_run-#_epi.nii.gz
  • sub-#/ses-#/fmap/sub-#_ses-#_acq-dwi_dir-(AP|PA)_epi.json
  • sub-#/ses-#/fmap/sub-#_ses-#_acq-dwi_dir-(AP|PA)_epi.nii.gz

inputs.func.task-(MID|nback|SST|rest)

  • sub-#/ses-#/func/sub-#_ses-#_task-(MID|nback|SST|rest)_run-#_bold.json
  • sub-#/ses-#/func/sub-#_ses-#_task-(MID|nback|SST|rest)_run-#_bold.nii.gz

sourcedata.func.task_events

  • sourcedata/sub-#/ses-#/func/sub-#_ses-#_task-(MID|nback|SST)_run-#_bold_EventRelatedInformation.txt

3. DAIC Quality Control (QC) Selection Process

QC is performed by scan operators at the time of the scan. Subjects may fail for a variety of reasons whether the subject was moving, began talking, fell asleep, used the squeeze ball, the scan had to be stopped, etc. These operator notes are taken into account and each scan is given a binary pass or fail. This QC information is now provided by the NIMH Data Archive (NDA) and instructions to download it can be found on the ABCD repository for downloading and setting up the BIDS dataset (ABCD-STUDY/abcd-dicom2bids). Only scans that passed this initial QC were considered for processing. Subjects without a passing T1w image were excluded from this dataset. If there were valid anatomical scans, but no functional scans the subjects were processed through an anatomical-only version of the pipeline that excludes any functional image processing.

4. DICOM to BIDS Conversion

DICOMS were converted using the abcd-dcm2bids wrapper. The wrapper includes multiple steps involving pulling the data from ABCD fast-track, as described in recommendations here. ABCD-dcm2bids wrapper pulls DICOMS based on the ABCD fast track QC. DICOMs were first converted into NIfTIs using Christophe Bedetti's Dcm2Bids, which is a wrapper for the Chris Rorden's Lab dcm2niix that restructures NIfTIs into BIDS format.

5. MRI Acquisition Parameters

For a summary of the MRI acquisition parameters for each modality and scanner see https://abcdstudy.org/images/Protocol_Imaging_Sequences.pdf.

6. Scanner Differences

Images in this dataset were acquired from three brands of MRI scanner: Siemens, Philips, and General Electric (GE). After initially processing the dataset we noticed a relatively high post-processing quality control failure rate, particularly for images derived from GE and Philips scanners. Upon further investigation we noticed that images from GE scanners had no intensity normalization applied to them and images from both Philips and GE appeared more "grainy" than those from Siemens scanners.

This motivated inclusion of Advanced Normalization Tools (ANTs) de-noising as well as ANTs N4 bias field correction during the PreFreeSurfer stage of the processing pipeline for all data. We also implemented ANTs-based atlas registration in PostFreeSurfer instead of FSL's FNIRT-based method.

While these changes had little effect on the high-quality anatomical Siemens data they significantly improved results for both Philips and GE scanner data.

7. Field Map Selection Process

A pair of positive (posterior to anterior) and negative (anterior to posterior) spin echo field maps are taken along with each functional scan. These field maps are highly susceptible to motion artifacts and can have a negative effect on procesing if they are not high-quality. Field maps are largely consistent between runs so we select the field map with the least variance from the registered group average and apply the pair to each functional scan to avoid processing with a poor-quality field map. This assumes that field maps with large motion artifacts will have more noise and higher variance from the average.

8. BIDS Field Map "IntendedFor" Metadata

The chosen field map pair is used for all anatomical and functional bias field corrections. This is specified with the IntendedFor field in the side car JSONs of the associated field map's BIDS metadata.

9. Diffusion-Weighted Imaging (DWI)

BIDS-formatted inputs for DWI have been included although they have not been processed through the minimal preprocessing pipeline.

The bval and bvec files associated with the DWI data for each scanner and software version were provided by the DAIC and can be found in the nda-abcd-s3-downloader repository. This was due to formatting issues and irregularities with these files that were packaged along with the DICOMs.

Field maps for the DWI data are included in each subject's fmap directory and can be distinguished from the functional fieldmaps by the _acq-dwi tag in their filenames.

The text files containing fMRI task event related information (ERI) have duplicated information. Specifically, per task within each subject's session, each run's ERI text file contains both run 1 and run 2. When extracting task event information for task-fMRI analysis, please make sure to take into account the duplicated structure for each ERI file. Our abcd-bids-tfmri-pipeline already takes this duplication into account for both derived contrasts and the pipeline code itself.

11. BIDS Modality-Agnostic Files

To maintain a valid BIDS data structure dataset_description.json, README, and CHANGES files are included. They respectively: minimally describe the dataset, provide a small blurb about the datsaet, and log the changes from version to version.

12. BIDS Validator Compliance

This dataset was validated using the official BIDS validator.