Derivatives & Preprocessing
derivatives/
├── fmriprep/ # fMRIPrep v24.1.1 preprocessed data (all sessions)
├── fmriprep_nordic/ # fMRIPrep v24.1.1 run on NORDIC-denoised BOLD
├── nordic/ # Raw NORDIC denoising outputs (pre-fMRIPrep)
├── mriqc/ # MRIQC v24.1.0 quality metrics and HTML reports
├── qc_review/ # HTML QC dashboards and BOLD QC benchmarks
├── atlases/ # Group-level reference atlases in template space
├── anatomical_rois/ # Subject-specific anatomically-defined ROIs
├── functional_rois/ # Subject-specific functionally-defined ROIs
├── hippunfold/ # HippUnfold hippocampal surface unfolding (whole-brain T2w)
├── hippunfold_oblcor/ # HippUnfold using oblique-coronal T2w acquisition
├── hsf/ # Hippocampal subfield segmentation — HSF (Poiret et al.)
├── hsf_oblcor/ # HSF using oblique-coronal T2w acquisition
├── behavioral_analysis/ # Behavioral accuracy, d-prime, and learning analyses
├── bids_validation/ # Validation outputs, extracted event files, survey logs
└── fmriprep_pre022426/ # Archived earlier fMRIPrep run (legacy)
Target Pipeline
sourcedata (DICOMs, raw behavioral)
│
▼
BIDS raw (NIfTI + JSON + events TSV)
│
├──▶ MRIQC (quality metrics, outlier detection)
│
├──▶ fMRIPrep / fMRIPrep+NORDIC (preprocessing: registration, distortion correction, confounds)
│
├──▶ atlases/ (reference parcellations in template space)
│
├──▶ anatomical_rois/ (subject-specific anatomical segmentations)
│
├──▶ functional_rois/ (subject-specific task-defined ROIs)
│
└──▶ ready/ (analysis-ready streams — see Analysis-Ready Preprocessing Pipeline)
- MRIQC and fMRIPrep run in parallel, producing complementary QA output.
fmriprep_pre022426/is an archived earlier run; the canonical output is infmriprep/.- Analysis-ready outputs (
ready/glmsingle/,ready/naturalistic/,ready/connectivity/) are documented in the Analysis-Ready Preprocessing Pipeline page.
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
└── ...
fMRIPrep (NORDIC)
fmriprep_nordic/ contains a parallel fMRIPrep run using NORDIC-denoised BOLD
as input (see nordic/ below). Structure mirrors fmriprep/ exactly. The
canonical source for each run (original vs. NORDIC) is recorded per-run in the
QC decisions file; see Analysis-Ready Preprocessing Pipeline.
NORDIC
Raw outputs from the NORDIC thermal noise denoising step, applied to BOLD data
prior to fMRIPrep. Each run produces a denoised NIfTI (.nii.gz) and a
diagnostics file (.mat).
derivatives/nordic/
└── sub-03/
└── ses-04/
└── func/
├── sub-03_ses-04_task-TBencoding_run-01_bold.nii.gz
├── sub-03_ses-04_task-TBencoding_run-01_bold.mat
└── ...
QC Review
HTML dashboards for visual QC of structural and functional scans, generated
from MRIQC outputs. Includes per-subject and group-level views for T1w, T2w,
and BOLD, plus bold_qc_benchmarks.md — a reference table of absolute IQM
thresholds with citations.
derivatives/qc_review/
├── bold_qc_benchmarks.md
├── dashboards/
│ ├── qc_dashboard_all_bold.html
│ ├── qc_dashboard_sub-03_bold.html
│ └── ... (per-subject T1w, T2w, BOLD dashboards)
└── ...
MRIQC
Image quality metrics generated by MRIQC v24.1.0 for structural and functional scans. Outputs include individual HTML visual reports and per-image quality metric (IQM) JSON files for automated outlier detection.
derivatives/mriqc/
├── dataset_description.json
├── logs/
├── sub-03/
│ ├── figures/
│ ├── ses-01/
│ │ └── anat/ # T1w, T2w quality metrics + figures
│ ├── ses-02/ ...
│ └── ses-30/
│ └── func/ # BOLD quality metrics + figures
├── sub-04/
├── sub-05/
├── sub-03_ses-01_acq-MPR_run-01_T1w.html # Individual report pages
└── ...
Behavioral Analysis
Group-level and per-subject behavioral analysis results from the trial-based
memory paradigm, generated by analyze_behavior.py in the mmmdata codebase.
derivatives/behavioral_analysis/
├── group/
│ ├── accuracy_by_enCon.tsv # Accuracy broken down by encoding condition
│ └── dprime_by_subject.tsv # Signal detection (d') per subject
├── figures/ # Visualization outputs
├── sub-03/
├── sub-04/
└── sub-05/
BIDS Validation
Outputs from BIDS validation and event file extraction processes.
derivatives/bids_validation/
├── dataset_description.json
├── eventfiles/ # Extracted event files per subject
│ ├── sub-03/
│ ├── sub-04/
│ └── sub-05/
└── survey_logs/ # Pre-scan questionnaire processing logs
Analysis-Ready Outputs
The ready/ directory (GLMSingle, naturalistic, and connectivity streams) and
the preprocessing_qc/ QC decisions files are documented in the
Analysis-Ready Preprocessing Pipeline page.