Neuroimaging QC Decision-Making
Evidence-based guidance for interpreting QC metrics and making principled inclusion/exclusion decisions.
Core Principles
1. No Universal Thresholds
QC thresholds are study-specific. Factors affecting appropriate cutoffs:
- Population: Infants tolerate higher motion than adults
- Paradigm: Task fMRI has different constraints than resting-state
- Analysis: Connectivity analyses are more motion-sensitive than activation
- Sample size: Stricter thresholds with larger N; lenient with small N
2. Distribution-Based Decisions
Always examine your sample's QC distribution before applying thresholds:
- Plot histograms of key metrics
- Identify natural breakpoints/outliers (>2-3 SD from mean)
- Apply literature-based thresholds as starting points, adjust based on distribution
- Report both threshold AND resulting exclusion rate
3. Multi-Metric Assessment
Never exclude based on single metric. Combine:
- Motion metrics (FD, DVARS)
- Signal quality metrics (tSNR, SNR)
- Artifact indicators (outlier volumes, registration quality)
- Visual inspection for edge cases
Decision Workflow
1. IDENTIFY your QC source
├── Known pipeline (fMRIPrep, MRIQC, etc.) → See modality references
└── Custom/unknown output → Parse available metrics, map to known categories
2. CHARACTERIZE your study
├── Population: adult / pediatric / infant / clinical
├── Paradigm: rest / task / naturalistic / sleep
└── Analysis: activation / connectivity / other
3. ESTABLISH thresholds
├── Start with literature recommendations (see references)
├── Examine your sample distribution
└── Adjust based on trade-off: data quality vs. statistical power
4. APPLY and DOCUMENT
├── Generate exclusion summary
├── Report thresholds with citations
└── Conduct sensitivity analysis with stricter/lenient thresholds
Quick Reference: Common Thresholds
fMRI Motion (FD)
| Population |
Conservative |
Standard |
Lenient |
Citation |
| Adults (rest) |
0.2 mm |
0.3 mm |
0.5 mm |
Power et al., 2012, 2014 |
| Adults (task) |
0.5 mm |
0.9 mm |
1.0 mm |
Siegel et al., 2014 |
| Children (6-12y) |
0.3 mm |
0.4 mm |
0.5 mm |
Fair et al., 2012 |
| Infants |
0.3 mm |
0.5 mm |
— |
Population-dependent |
| Neonates |
0.2 mm |
0.5 mm |
— |
Smyser et al., 2010 |
Additional motion criteria:
- fd_perc (% volumes > threshold): typically exclude if >20-50%
- Maximum FD spike: consider >3-5 mm as problematic
- Minimum usable data: ≥5 min for resting-state, task-dependent for task fMRI
EEG Amplitude (Peak-to-Peak)
| Channel Type |
Reject Threshold |
Flat Threshold |
Notes |
| EEG |
100-200 µV |
1 µV |
Hardware-dependent |
| EOG |
200-250 µV |
— |
Blink detection |
| MEG (mag) |
3000-4000 fT |
1 fT |
Magnetometers |
| MEG (grad) |
3000-4000 fT/cm |
1 fT/cm |
Gradiometers |
Additional EEG criteria:
- Channel rejection: >20-30% bad epochs → mark as bad channel
- Epoch rejection: typically accept 10-30% epoch loss; >50% problematic
- Interpolation limit: ≤10% of channels can be interpolated
Structural MRI
| Metric |
Direction |
Concern Level |
Notes |
| CNR (GM/WM) |
Higher better |
<2.5 |
Tissue contrast |
| SNR |
Higher better |
Site-dependent |
Compare within-site |
| QI1 |
Lower better |
>0.1 |
Artifact detection |
| EFC |
Lower better |
Outlier in distribution |
Ghosting indicator |
Modality-Specific References
For detailed metrics, thresholds, and Python code:
- fMRI (fMRIPrep/MRIQC): See references/fmri_qc.md
- EEG/MEG (MNE-Python): See references/eeg_qc.md
- fNIRS (Homer3/MNE-NIRS): See references/fnirs_qc.md
- Structural MRI: See references/structural_qc.md
Python Utilities
Scripts for parsing QC outputs and applying thresholds:
scripts/parse_mriqc.py: Parse MRIQC group TSV, flag subjects
scripts/parse_fmriprep_confounds.py: Summarize fMRIPrep confounds
scripts/qc_report.py: Generate QC summary reports
Methods Section Templates
fMRI QC Methods
Quality control was performed using [MRIQC/fMRIPrep] outputs. Subjects were
excluded based on the following criteria: (1) mean framewise displacement
(FD) > X mm [cite Power et al., 2012], (2) >Y% of volumes exceeding FD
threshold of Z mm, or (3) visual inspection revealing [registration
failures/artifacts]. This resulted in N subjects excluded (X% of sample),
yielding a final sample of M participants.
EEG QC Methods
Continuous EEG data underwent artifact rejection using MNE-Python. Epochs
containing peak-to-peak amplitudes exceeding X µV were rejected. Channels
with >Y% rejected epochs were marked as bad and interpolated using spherical
spline interpolation. Participants with >Z% rejected epochs or >N bad
channels were excluded from analysis.
Handling Unknown QC Outputs
When encountering unfamiliar QC metrics:
Identify metric category:
- Motion/movement: Look for displacement, rotation, translation terms
- Signal quality: SNR, tSNR, CNR, variance-related
- Artifacts: Outlier counts, spike detection, artifact indices
Determine directionality:
- Higher-is-better: SNR, tSNR, CNR
- Lower-is-better: FD, DVARS, artifact indices, outlier counts
Establish thresholds:
- Plot distribution, identify outliers
- If metric has known analog, use those thresholds
- Otherwise: use ±2-3 SD from mean as starting point
Validate:
- Cross-reference with visual inspection
- Check correlation with known metrics
- Verify excluded subjects are actually problematic
Population-Specific Considerations
Infants (0-24 months)
- Higher baseline motion expected; adjust FD thresholds upward
- Shorter usable data segments acceptable
- Age-appropriate templates critical for registration QC
- Sleep state affects data quality (deep sleep preferred)
Pediatric (3-12 years)
- Motion decreases with age; consider age as covariate
- Task compliance affects data quality
- Mock scanner training reduces motion
- Consider breaks during long protocols
Adolescents
- Motion intermediate between children and adults
- Developmental stage affects hemodynamics
- Consider puberty stage as potential confound
Clinical Populations
- Disease-specific considerations (lesions, atrophy)
- Medication effects on signal
- May need population-specific templates
- Balance data quality vs. already-reduced sample sizes
Paradigm-Specific Considerations
Resting-State
- Scrubbing viable (can remove timepoints)
- Need minimum continuous/total duration (≥5 min recommended)
- Strict motion thresholds (FD < 0.2-0.3 mm)
Task fMRI
- Cannot arbitrarily remove timepoints
- Consider motion relative to task timing
- More lenient thresholds acceptable (FD < 0.5-0.9 mm)
- Ensure sufficient trials survive exclusion
Naturalistic (movies, stories)
- Long durations increase motion likelihood
- Consider segment-wise QC
- Drift artifacts more relevant
Sleep Studies
- State-dependent QC (arousal events)
- EEG quality for sleep staging
- Movement during state transitions
1---2name: neuroimaging-qc3description: Evidence-based QC decision-making for neuroimaging data. Interpret QC metrics from any pipeline (fMRIPrep, MRIQC, FreeSurfer, MNE-Python, Homer3, custom outputs) to make justified inclusion/exclusion decisions. Covers fMRI, EEG, fNIRS, and structural MRI across populations (adults, infants, adolescents, clinical) and paradigms (resting-state, task, naturalistic, sleep). Use when filtering subjects based on QC outputs, setting exclusion thresholds, justifying QC criteria for methods sections, or parsing QC files programmatically with Python.4---56# Neuroimaging QC Decision-Making78Evidence-based guidance for interpreting QC metrics and making principled inclusion/exclusion decisions.910## Core Principles1112### 1. No Universal Thresholds13QC thresholds are study-specific. Factors affecting appropriate cutoffs:14- **Population**: Infants tolerate higher motion than adults15- **Paradigm**: Task fMRI has different constraints than resting-state16- **Analysis**: Connectivity analyses are more motion-sensitive than activation17- **Sample size**: Stricter thresholds with larger N; lenient with small N1819### 2. Distribution-Based Decisions20Always examine your sample's QC distribution before applying thresholds:211. Plot histograms of key metrics222. Identify natural breakpoints/outliers (>2-3 SD from mean)233. Apply literature-based thresholds as starting points, adjust based on distribution244. Report both threshold AND resulting exclusion rate2526### 3. Multi-Metric Assessment27Never exclude based on single metric. Combine:28- Motion metrics (FD, DVARS)29- Signal quality metrics (tSNR, SNR)30- Artifact indicators (outlier volumes, registration quality)31- Visual inspection for edge cases3233## Decision Workflow3435```361. IDENTIFY your QC source37 ├── Known pipeline (fMRIPrep, MRIQC, etc.) → See modality references38 └── Custom/unknown output → Parse available metrics, map to known categories39402. CHARACTERIZE your study41 ├── Population: adult / pediatric / infant / clinical42 ├── Paradigm: rest / task / naturalistic / sleep43 └── Analysis: activation / connectivity / other44453. ESTABLISH thresholds46 ├── Start with literature recommendations (see references)47 ├── Examine your sample distribution48 └── Adjust based on trade-off: data quality vs. statistical power49504. APPLY and DOCUMENT51 ├── Generate exclusion summary52 ├── Report thresholds with citations53 └── Conduct sensitivity analysis with stricter/lenient thresholds54```5556## Quick Reference: Common Thresholds5758### fMRI Motion (FD)5960| Population | Conservative | Standard | Lenient | Citation |61|------------|-------------|----------|---------|----------|62| Adults (rest) | 0.2 mm | 0.3 mm | 0.5 mm | Power et al., 2012, 2014 |63| Adults (task) | 0.5 mm | 0.9 mm | 1.0 mm | Siegel et al., 2014 |64| Children (6-12y) | 0.3 mm | 0.4 mm | 0.5 mm | Fair et al., 2012 |65| Infants | 0.3 mm | 0.5 mm | — | Population-dependent |66| Neonates | 0.2 mm | 0.5 mm | — | Smyser et al., 2010 |6768**Additional motion criteria:**69- fd_perc (% volumes > threshold): typically exclude if >20-50%70- Maximum FD spike: consider >3-5 mm as problematic71- Minimum usable data: ≥5 min for resting-state, task-dependent for task fMRI7273### EEG Amplitude (Peak-to-Peak)7475| Channel Type | Reject Threshold | Flat Threshold | Notes |76|--------------|-----------------|----------------|-------|77| EEG | 100-200 µV | 1 µV | Hardware-dependent |78| EOG | 200-250 µV | — | Blink detection |79| MEG (mag) | 3000-4000 fT | 1 fT | Magnetometers |80| MEG (grad) | 3000-4000 fT/cm | 1 fT/cm | Gradiometers |8182**Additional EEG criteria:**83- Channel rejection: >20-30% bad epochs → mark as bad channel84- Epoch rejection: typically accept 10-30% epoch loss; >50% problematic85- Interpolation limit: ≤10% of channels can be interpolated8687### Structural MRI8889| Metric | Direction | Concern Level | Notes |90|--------|-----------|---------------|-------|91| CNR (GM/WM) | Higher better | <2.5 | Tissue contrast |92| SNR | Higher better | Site-dependent | Compare within-site |93| QI1 | Lower better | >0.1 | Artifact detection |94| EFC | Lower better | Outlier in distribution | Ghosting indicator |9596## Modality-Specific References9798For detailed metrics, thresholds, and Python code:99100- **fMRI (fMRIPrep/MRIQC)**: See [references/fmri_qc.md](references/fmri_qc.md)101- **EEG/MEG (MNE-Python)**: See [references/eeg_qc.md](references/eeg_qc.md)102- **fNIRS (Homer3/MNE-NIRS)**: See [references/fnirs_qc.md](references/fnirs_qc.md)103- **Structural MRI**: See [references/structural_qc.md](references/structural_qc.md)104105## Python Utilities106107Scripts for parsing QC outputs and applying thresholds:108109- `scripts/parse_mriqc.py`: Parse MRIQC group TSV, flag subjects110- `scripts/parse_fmriprep_confounds.py`: Summarize fMRIPrep confounds111- `scripts/qc_report.py`: Generate QC summary reports112113## Methods Section Templates114115### fMRI QC Methods116```117Quality control was performed using [MRIQC/fMRIPrep] outputs. Subjects were 118excluded based on the following criteria: (1) mean framewise displacement 119(FD) > X mm [cite Power et al., 2012], (2) >Y% of volumes exceeding FD 120threshold of Z mm, or (3) visual inspection revealing [registration 121failures/artifacts]. This resulted in N subjects excluded (X% of sample), 122yielding a final sample of M participants.123```124125### EEG QC Methods126```127Continuous EEG data underwent artifact rejection using MNE-Python. Epochs 128containing peak-to-peak amplitudes exceeding X µV were rejected. Channels 129with >Y% rejected epochs were marked as bad and interpolated using spherical 130spline interpolation. Participants with >Z% rejected epochs or >N bad 131channels were excluded from analysis.132```133134## Handling Unknown QC Outputs135136When encountering unfamiliar QC metrics:1371381. **Identify metric category**:139 - Motion/movement: Look for displacement, rotation, translation terms140 - Signal quality: SNR, tSNR, CNR, variance-related141 - Artifacts: Outlier counts, spike detection, artifact indices1421432. **Determine directionality**:144 - Higher-is-better: SNR, tSNR, CNR145 - Lower-is-better: FD, DVARS, artifact indices, outlier counts1461473. **Establish thresholds**:148 - Plot distribution, identify outliers149 - If metric has known analog, use those thresholds150 - Otherwise: use ±2-3 SD from mean as starting point1511524. **Validate**:153 - Cross-reference with visual inspection154 - Check correlation with known metrics155 - Verify excluded subjects are actually problematic156157## Population-Specific Considerations158159### Infants (0-24 months)160- Higher baseline motion expected; adjust FD thresholds upward161- Shorter usable data segments acceptable162- Age-appropriate templates critical for registration QC163- Sleep state affects data quality (deep sleep preferred)164165### Pediatric (3-12 years)166- Motion decreases with age; consider age as covariate167- Task compliance affects data quality168- Mock scanner training reduces motion169- Consider breaks during long protocols170171### Adolescents172- Motion intermediate between children and adults173- Developmental stage affects hemodynamics174- Consider puberty stage as potential confound175176### Clinical Populations177- Disease-specific considerations (lesions, atrophy)178- Medication effects on signal179- May need population-specific templates180- Balance data quality vs. already-reduced sample sizes181182## Paradigm-Specific Considerations183184### Resting-State185- Scrubbing viable (can remove timepoints)186- Need minimum continuous/total duration (≥5 min recommended)187- Strict motion thresholds (FD < 0.2-0.3 mm)188189### Task fMRI190- Cannot arbitrarily remove timepoints191- Consider motion relative to task timing192- More lenient thresholds acceptable (FD < 0.5-0.9 mm)193- Ensure sufficient trials survive exclusion194195### Naturalistic (movies, stories)196- Long durations increase motion likelihood197- Consider segment-wise QC198- Drift artifacts more relevant199200### Sleep Studies201- State-dependent QC (arousal events)202- EEG quality for sleep staging203- Movement during state transitions