Skip to content

Commit feee107

Browse files
Docs: surgical updates for merged best-practice batch
Bring the prose docs in line with the 9 PRs merged on main: - Brainstem subdivision: Talairach removed -> FreeSurfer substructures (Iglesias 2015 segmentBS: midbrain/pons/medulla/SCP) via BRAINSTEM_SEGMENTATION_METHOD; Harvard-Oxford now gross-extent only (maxprob-thr25). - Brain extraction: BET/ANTs -> SynthStrip primary with SynthStrip -> ANTs(Otsu) -> BET fallback, robustfov neck removal, posterior-fossa QC gate (BRAIN_EXTRACTION_METHOD). - Denoising: Rician-only -> modality-aware dispatcher (NLM for T1/T2/FLAIR, MP-PCA dwidenoise for DWI, SWI/TOF skipped) + DWI path. - N4: field strength tunes b-spline (-b); gentler lesion-aware FLAIR. - Registration: MI for cross-modality SyN, winsorization, label-aware GenericLabel interpolation. - Detection: CSF/PV exclusion via FAST CSF PVE; single authoritative fallback SD multiplier (THRESHOLD_WM_SD_MULTIPLIER). - New optional supervised WMH modules: FSL BIANCA, LST-AI + SAMSEG. Files: README.md, docs/README.md, docs/TECHNICAL_OVERVIEW.md, docs/README_tests.md. Also tracks the two previously-untracked design docs: brainstem_freesurfer_segmentation_spec.md (now IMPLEMENTED banner, #119) and complete_pipeline_analysis_and_fix_plan.md (DONE markers on addressed items). Multi-atlas docs and CLAUDE.md are intentionally out of scope (handled separately). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent ca4329e commit feee107

6 files changed

Lines changed: 472 additions & 83 deletions

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ source ~/.bash_profile && src/pipeline.sh -i ../DiCOM -o ../mri_results -s patie
5555
The pipeline consists of 8 resumable stages:
5656

5757
1. **import** - DICOM import and conversion
58-
2. **preprocess** - Rician denoising + N4 bias correction
58+
2. **preprocess** - Modality-aware denoising (Rician NLM for T1/T2/FLAIR, MP-PCA for DWI) + N4 bias correction
5959
3. **brain_extraction** - Brain extraction and standardization
6060
4. **registration** - Multi-stage alignment to standard space
6161
5. **segmentation** - Brainstem and pons region extraction
@@ -81,8 +81,8 @@ Active development as of June 2026. While functional, improvements are ongoing.
8181
This pipeline leverages established neuroimaging tools:
8282
- **ANTs** - Advanced Normalizations Tools
8383
- **FSL** - FMRIB Software Library
84-
- **FreeSurfer** - 3D visualization
85-
- **Harvard-Oxford & Talairach Atlases** - Brainstem segmentation
84+
- **FreeSurfer** - Brainstem substructure segmentation (Iglesias 2015 `segmentBS`) + 3D visualization
85+
- **Harvard-Oxford Atlas** - Gross brainstem extent mask
8686
- **MNI152 Templates** - Registration targets
8787

8888
## License

0 commit comments

Comments
 (0)