Derivatives & Preprocessing
derivatives/
├── fmriprep/ # fMRIPrep preprocessed data (all sessions)
├── atlases/ # Group-level reference atlases in template space
├── anatomical_rois/ # Subject-specific anatomically-defined ROIs
├── functional_rois/ # Subject-specific functionally-defined ROIs
├── mriqc/ # MRIQC output (currently empty — not yet run)
├── fmriprepFR/ # Earlier fMRIPrep run (legacy — to be deprecated)
└── QA/ # Legacy QA images (likely superseded by MRIQC)
Target Pipeline
sourcedata (DICOMs, raw behavioral)
│
▼
BIDS raw (NIfTI + JSON + events TSV)
│
├──▶ MRIQC (quality metrics, outlier detection)
│
├──▶ fMRIPrep (preprocessing: registration, distortion correction, confounds)
│
├──▶ atlases/ (reference parcellations in template space)
│
├──▶ anatomical_rois/ (subject-specific anatomical segmentations)
│
├──▶ functional_rois/ (subject-specific task-defined ROIs)
│
└──▶ [downstream analysis stages TBD]
- MRIQC and fMRIPrep can likely run in parallel, producing complementary QA output.
- Long-term goal: a single
fmriprep/output directory (the currentfmriprepFR/andQA/directories are legacy and will be deprecated).
Atlases
Group-level reference atlases stored at the template level (no per-subject data).
Each atlas has a dataset_description.json and an atlas-<label>_description.json
sidecar with provenance, license, and citation info.
Schaefer 2018
Local-global cortical parcellation (Schaefer et al., 2018, Cerebral Cortex).
Available in 7-network and 17-network solutions at 8 granularities
(100, 200, 300, 400, 500, 600, 800, 1000 parcels). All files are in
MNI152NLin2009cAsym space at 2 mm resolution, matching fMRIPrep output.
derivatives/atlases/
├── dataset_description.json
├── atlas-Schaefer2018_description.json
└── tpl-MNI152NLin2009cAsym/
└── anat/
├── tpl-MNI152NLin2009cAsym_atlas-Schaefer2018_seg-7n_scale-100_res-2_dseg.nii.gz
├── tpl-MNI152NLin2009cAsym_atlas-Schaefer2018_seg-7n_scale-100_res-2_dseg.tsv
├── ... (7n × 8 scales + 17n × 8 scales = 32 NIfTI + 32 TSV)
└── tpl-MNI152NLin2009cAsym_atlas-Schaefer2018_seg-17n_scale-1000_res-2_dseg.tsv
Entity key: seg-7n / seg-17n = network solution, scale-100 = number of
parcels, res-2 = 2 mm isotropic resolution.
Anatomical ROIs
Subject-specific ROIs derived from structural imaging (e.g., hippocampal subfield segmentations, custom FreeSurfer-based masks). Stored per-subject (and optionally per-session if the definition is session-specific).
derivatives/anatomical_rois/
├── dataset_description.json
└── sub-03/
└── anat/
├── sub-03_seg-hippsubfields_dseg.nii.gz # Full subfield parcellation
├── sub-03_seg-hippsubfields_dseg.tsv # Label lookup table
├── sub-03_label-CA1_mask.nii.gz # Individual subfield mask
└── sub-03_label-CA1_mask.json # {"Type": "ROI", "Sources": [...]}
Functional ROIs
Subject-specific ROIs derived from task-based or resting-state analyses (e.g., localizer contrasts, seed-based connectivity maps). Each mask’s JSON sidecar documents the contrast, threshold, and statistical criteria.
derivatives/functional_rois/
├── dataset_description.json
└── sub-03/
└── ses-01/
└── func/
├── sub-03_ses-01_task-localizer_space-MNI152NLin2009cAsym_label-FFA_mask.nii.gz
├── sub-03_ses-01_task-localizer_space-MNI152NLin2009cAsym_label-FFA_mask.json
└── ...
Minimally Preprocessed Version
Documentation forthcoming.
GLMSingle Output
Documentation forthcoming.