FreeSurfer Surface Editing:5 天 Hands-on 学习指南
目标: 从 7T MP2RAGE 出发,完成 anatomical QC、mgz 文件手工修正、white/pial surface reconstruction、GM ribbon 生成,并接入后续 layer-fMRI 分析。
建议时间: 每天 4–5 小时。理论学习约 45–75 分钟,其余用于 Freeview 和 FreeSurfer hands-on。
核心原则: FreeSurfer 手工修正通常不是直接拖动 surface 顶点,而是修改上游 volume(例如
wm.mgz、brainmask.mgz)或 control points,再重运行对应的recon-all阶段。准确的 cortical anatomy 优先于视觉上的平滑。所有修改都应有 before/after QC,并且在 axial、coronal、sagittal 三个方向连续观察。
学习成果与验收标准
完成训练后,应能:
- 在 T1w/MP2RAGE 中辨认 GM、WM、CSF、dura、主要 venous sinuses,以及常见 cortical/bridging veins 的可疑影像表现。
- 判断 white surface 与 pial surface 何处偏离真实组织边界,区分 segmentation、normalization、skull stripping、topology 和 registration 问题。
- 使用 Freeview 编辑
wm.mgz、brainmask.mgz,理解何时使用 control points,并在需要时处理特殊 pial correction。 - 运行合适的 partial
recon-all、验证lh/rh.white与lh/rh.pial。 - 基于修正后的 surfaces 生成 GM ribbon,转换 surface 格式,并验证 anatomical-to-EPI alignment,为 layer-fMRI 准备输入。
五天目标是形成独立编辑与 QC 的工作能力,而不是保证每位受试者都达到专家级精度;具体结果取决于 MRI contrast、空间分辨率、配准质量和外部验证。
总览
| 天数 | 核心主题 | Anatomy / physiology | Hands-on | 当日成果 |
|---|---|---|---|---|
| Day 1 | MRI anatomy & surface QC | GM/WM/CSF、脑膜、脑沟脑回、dura、sinuses | Freeview 多平面检查、错误分类 | Surface QC log |
| Day 2 | White surface editing | GM–WM boundary、WM hypointensity、partial volume | 编辑 wm.mgz、control points、重建 | 改善 white surface |
| Day 3 | Pial surface editing | Pia、arachnoid、dura、cortical veins、sinuses | 编辑 brainmask.mgz、pial reconstruction | 改善 pial surface |
| Day 4 | Complete reconstruction & QC | Cortical ribbon、sulci、topology | 综合修正、partial recon-all、比较 | 可重复的 surface QC workflow |
| Day 5 | GM ribbon & layer-fMRI | Cortical depth、equidistant/equivolumetric、vascular bias | Ribbon generation、GIFTI、EPI registration | Layer-fMRI anatomical inputs |
Day 1 — Anatomical Recognition & Surface QC
目标:先学会识别错误,不急于编辑。 预计 4–5 小时。
1.1 Anatomy 学习(60 分钟)
| 结构 | 需要掌握 | Surface editing 的意义 |
|---|---|---|
| White matter | Myelination;WM/GM intensity contrast | white boundary |
| Cortical GM | Gyral crown、sulcal bank、ribbon thickness | 判断 ribbon 和边界 |
| CSF | Sulcal CSF、subarachnoid space | pial boundary |
| Pia | 紧贴 cortex 并进入 sulci | pial surface 的解剖近似 |
| Dura | Falx、tentorium | 避免 pial contamination |
| Dural venous sinuses | Superior sagittal、straight、transverse、sigmoid | 识别非皮层结构 |
| Cortical/bridging veins | 表面走行、与 sinus 的连接 | 判断可疑 pial errors |
视觉皮层优先地标: calcarine sulcus、cuneus、lingual gyrus、occipital pole、falx cerebri、superior sagittal sinus、tentorium cerebelli。
在常见 T1w 上,WM 通常比 GM 亮,而 CSF 较暗;但不能无条件将这条规则推广到所有 MP2RAGE contrasts(INV1/INV2/UNI/T1 map)。Dura 与血管也可能干扰边界判断。
1.2 Hands-on A:Freeview 多平面检查(90 分钟)
使用 FreeSurfer 官方训练 subject,然后检查自己的 7T MP2RAGE subject:
export SUBJECTS_DIR=/path/to/subjects
SUBJ=sub-01
freeview \
-v "$SUBJECTS_DIR/$SUBJ/mri/brainmask.mgz" \
"$SUBJECTS_DIR/$SUBJ/mri/wm.mgz:colormap=heat:opacity=0.3" \
-f "$SUBJECTS_DIR/$SUBJ/surf/lh.white:edgecolor=blue" \
"$SUBJECTS_DIR/$SUBJ/surf/lh.pial:edgecolor=red" \
"$SUBJECTS_DIR/$SUBJ/surf/rh.white:edgecolor=blue" \
"$SUBJECTS_DIR/$SUBJ/surf/rh.pial:edgecolor=red"
White surface 检查: 是否贴合 GM–WM transition?有没有异常凹陷、进入 GM、包裹 non-WM?
Pial surface 检查: 是否贴合 GM 外缘?有没有把 dura/血管包含进去、跨越 sulcal CSF、或异常接近/交叉 white surface?
对每个疑点,在三个平面和相邻多张 slices 中核实。
1.3 Hands-on B:Occipital cortex(60 分钟)
依次检查 occipital pole、calcarine sulcus、cuneus、lingual gyrus 和 medial occipital surface。
每个部位回答:
- White boundary 应在哪里?
- Pial boundary 应在哪里?
- 当前偏差的最可能原因是什么?
尤其小心深 sulci、partial-volume effect,以及两个 sulcal banks 贴得很近的情况。不要为了外观平滑而填补真实 sulcal CSF。
1.4 作业与验收(30–60 分钟)
建立 surface_qc_log.csv,至少记录 10 处可疑区域,包含若干最终判断“不需要修正”的结构。
| Region | Surface | Observation | Suspected cause | Confidence |
|---|---|---|---|---|
| LH calcarine | White | Boundary intrudes into GM | WM segmentation | High |
| RH occipital pole | Pial | Extends beyond cortex | Possible dura/vessel | Medium |
| LH cuneus | Pial | Sulcal boundary unclear | Partial volume | Low |
验收: 能独立加载四个 surfaces,熟练完成三视图检查与错误分类。
官方教程: Troubleshooting Recon-all Results
Day 2 — White Matter Surface Editing
目标:编辑 wm.mgz,并通过重新 reconstruction 改善 white surface。 预计 4–5 小时。
2.1 理论(45 分钟)
wm.mgz 是 volumetric WM segmentation/editing volume,不是 .white surface 本身。
T1w / MP2RAGE
↓
Intensity normalization
↓
WM segmentation → wm.mgz
↓
Topology correction
↓
Surface deformation
↓
lh.white / rh.white
需要理解: WM hypointensity、GM–WM partial volume、错误填充与错误连接、control-point intensity normalization。
2.2 Hands-on A:White Matter Edits(90 分钟)
必修教程: White Matter Edits
- Missing WM: 当确认为 WM 的区域被漏分时,在 Recon Edit 模式中做局部 fill。
- Non-WM classified as WM: 当 CSF/GM 被错误包括时,谨慎 erase。
操作顺序:打开 wm.mgz 和 anatomical image → 定位错误 → Recon Edit → 小笔刷局部编辑 → 三视图复核 → 保存。
不要把正常 sulcus 填成 WM,也不要只依赖单张 axial slice。官方教程中常使用指定的 fill/erase 值;以所用 FreeSurfer 版本的教程和 Recon Edit 界面为准。
2.3 Hands-on B:Control Points(60 分钟)
教程: Control Points
| 情况 | 通常处理 |
|---|---|
| WM intensity 正常,但漏分 | 编辑 wm.mgz |
| WM intensity normalization 明显异常 | Control points |
| Non-WM 被误判为 WM | wm.mgz erase |
| 真实病灶/不明异常信号 | 先评估病灶与其他 contrast,不能直接按普通 WM 处理 |
| 没有足够证据 | 暂不编辑 |
Control points 应当放在确信属于 WM 的位置,不能当成普通画笔。
2.4 Hands-on C:重建与比较(60–90 分钟)
先备份原始 subject,再对训练副本修改。
编辑 wm.mgz 后:
recon-all -s sub-01 -autorecon2-wm -autorecon3
添加 control points 后:
recon-all -s sub-01 -autorecon2-cp -autorecon3
对比前后 white surface;不仅核对修改位置,也检查周边 topology 和 sulci,因为局部 edit 可能影响较远处的 reconstruction。
2.5 作业与验收
完成一次 missing-WM edit、一次 non-WM removal、一次官方 control-point 练习、至少一次 partial recon-all,并保存 before/after screenshots。
验收: 能解释为何选择 wm.mgz 或 control points,且能重建并验证结果。
Day 3 — Pial Surface Editing & Cerebral Venous Anatomy
目标:识别 dura、主要 sinus 与 cortical veins,学习 pial surface corrections。 预计 4–5 小时。
3.1 Anatomy(75 分钟)
Skull
↓
Dura mater
↓
Arachnoid mater
↓
Subarachnoid space (CSF + superficial vessels)
↓
Pia mater
↓
Cortical gray matter
↓
White matter
Pia 紧贴 cortex 并进入 sulci;MRI 中的 pial surface 是皮层外缘的几何近似,而不是直接成像的 pia 膜。
| Venous structure | 常见位置 | 价值 |
|---|---|---|
| Superior sagittal sinus | 中线、falx 上缘 | Medial/superior surface QC |
| Straight sinus | Falx–tentorium 交界 | Medial posterior anatomy |
| Transverse/sigmoid sinus | Posterior cranial fossa | Occipital/inferior QC |
| Superficial cortical veins | 脑皮层表面 | Pial contamination |
| Bridging veins | Cortex 到 dural sinus | 区分血管与皮层边缘 |
疑似血管时,观察结构是否沿皮层延伸、跨越 gyri/sulci、最终朝 sinus 汇聚;必要时比对 SWI、T2*/T2 或 MRV。只凭单张 T1/UNI,通常不能可靠地区分所有 dura、静脉和皮层组织。
概念区分: surface contamination 是几何重建问题;GE-BOLD 的 pial/draining-vein bias 是功能信号来源问题。正确 editing 无法自动消除后者。
3.2 Hands-on A:Pial Editing(90 分钟)
官方 dura contamination 案例流程:
- 打开
brainmask.mgz,显示 white/pial surfaces。 - 在多视图定位被 pial 包含的非皮层组织。
- 进入 Recon Edit,局部移除确认不属于 cortex 的结构。
- 检查邻近切片、保存
brainmask.mgz。 - 重建 pial surfaces,查看修正前后差异。
如果 pial surface 错误进入 cerebellum,官方有单独的 brain.finalsurfs.manedit.mgz 处理方式,不应盲目擦除真实小脑。
3.3 Hands-on B:Pial 重建(60 分钟)
对一般 brainmask.mgz pial edits,在 white surface 已经正确的前提下,可从 pial 阶段重新运行:
recon-all -s sub-01 -autorecon-pial
核对 pial 是否贴近 GM 外缘、white 是否仍正确、sulcal GM 是否保留,以及 cortical thickness 是否合理。
3.4 Hands-on C:MP2RAGE 对比练习(60 分钟)
在确认空间对齐后,比较同一位置的 INV1、INV2、UNI、T1 map、brainmask.mgz 和 surfaces。
重点记录不同 contrast 对 cortex/CSF、dura、血管的可见性,以及背景噪声、B1+ variation 和 partial volume。不能默认 veins 在所有序列中都是同一亮度。
3.5 作业与验收
完成至少两处官方或真实数据 pial correction,输出 before/after 和判断依据。
验收: 能独立识别典型 dura-related pial errors,且对不确定的 veins 保持谨慎。
Day 4 — Complete Surface Reconstruction & Validation
目标:在一个真实的 7T subject 上独立进行系统性 QC、编辑和重建。 预计 4–5 小时。
4.1 选择 subject(30 分钟)
从现有的 7T 数据选一个质量较好、但具有有限明显错误的受试者。建议保留完整原始目录与独立编辑副本:
subjects/
├── sub-01_original/ # 完整 recon-all subject
└── sub-01_manual/ # 完整副本,执行 edits
不要只拷贝 mri/ 和 surf/,因为 recon-all 还会用到其他目录与元数据。
4.2 系统性检查(60 分钟)
按顺序:skull stripping → intensity normalization → WM segmentation / white surface → topology → pial surface → ribbon → registration。
先 white 后 pial。 如果 white surface 本身错误,单独修 pial 很可能是在掩盖上游问题。
4.3 Topology 练习(90 分钟)
识别 hole 和 handle/bridge,理解哪些异常连接是 segmentation artifact,哪些只是正常复杂 sulcal anatomy。
对于 layer-fMRI,错误地连接两个 sulcal banks 会破坏 cortical ribbon 和 depth estimation。
4.4 综合重建与 QC(90 分钟)
| 修正内容 | 常用重建入口 |
|---|---|
wm.mgz | -autorecon2-wm -autorecon3 |
| Control points | -autorecon2-cp -autorecon3 |
一般 brainmask.mgz pial edit | -autorecon-pial |
| 多种上游错误 | 从最早受影响阶段重新运行 |
命令与 stage 依赖可能因版本不同,核对本机 recon-all -help 和所用版本的官方文档。
在相同 anatomy slices 比较 before/after,评估修改点、邻近 sulci、拓扑连通、异常形变和 cortical thickness。不能仅凭表面更加平滑来评价成功。
4.5 作业与验收
独立输出经过 QC 的:
sub-01_manual/
├── mri/wm.mgz
├── mri/brainmask.mgz
└── surf/
├── lh.white
├── lh.pial
├── rh.white
└── rh.pial
surface_qc/
├── before/
├── after/
├── edit_log.csv
└── qc_summary.md
验收: 能在没有教程逐步提示时完成一个 subject 的 QC、合理 edits、partial reconstruction 和验证。不必修改本来正确的边界。
Day 5 — GM Ribbon Generation & Layer-fMRI Integration
目标:生成可靠的 cortical ribbon,并验证其与 functional EPI 的空间对应。 预计 4–5 小时。
5.1 Cortical ribbon 与 depth(45 分钟)
- White surface: GM–WM boundary。
- Pial surface: Cortex 外侧 boundary。
- Cortical ribbon: 两者之间的三维 cortical GM 区域。
概念上:
[ \mathrm{GM\ Ribbon}={\mathbf{x}\mid \mathbf{x}\text{ 位于 white 与 pial surfaces 之间}} ]
可以约定归一化 depth (d\in[0,1]),(d=0) 为 WM boundary,(d=1) 为 pial boundary。但它必须由明确的 depth 算法求解,不能简单把任意 voxel 的两个欧氏距离插值当成正确的 cortical depth。
Equidistant ≠ Equivolumetric:前者主要描述几何距离,后者考虑曲率影响下的相应体积分配。任何 depth 方法都不能修复错误的输入 white/pial surfaces。
5.2 生成 FreeSurfer ribbon(45 分钟)
完整 recon-all 通常已生成:
mri/ribbon.mgz
mri/lh.ribbon.mgz
mri/rh.ribbon.mgz
在确认 surfaces 已重建、符合当前 FreeSurfer 版本的前提下,必要时重新计算:
mris_volmask --save_ribbon sub-01_manual
标准 ribbon.mgz 主要 labels:
| Label | 意义 |
|---|---|
| 2 | Left WM |
| 3 | Left cortical GM |
| 41 | Right WM |
| 42 | Right cortical GM |
提取 GM mask 并转换格式:
mri_binarize \
--i "$SUBJECTS_DIR/sub-01_manual/mri/ribbon.mgz" \
--match 3 42 \
--o GM_ribbon.mgz
mri_convert GM_ribbon.mgz GM_ribbon.nii.gz
注意: 此时仍是 anatomical space,不是 EPI space。FreeSurfer label ID 也不是 cortical layer ID。
5.3 导出 GIFTI surfaces(45 分钟)
mris_convert "$SUBJECTS_DIR/sub-01_manual/surf/lh.white" lh.white.gii
mris_convert "$SUBJECTS_DIR/sub-01_manual/surf/lh.pial" lh.pial.gii
mris_convert "$SUBJECTS_DIR/sub-01_manual/surf/rh.white" rh.white.gii
mris_convert "$SUBJECTS_DIR/sub-01_manual/surf/rh.pial" rh.pial.gii
关键:格式转换 ≠ 坐标转换。 检查 FreeSurfer surface RAS、scanner/world RAS 和后续软件坐标约定,不能仅凭 .gii 扩展名就认为与 EPI 对齐。
5.4 GM ribbon → EPI space(60 分钟)
结合现有 SBRef-based bbregister 或 anatomical–functional 配准流水线:
MP2RAGE → FreeSurfer → Corrected white/pial
→ Anatomical GM ribbon
→ Anatomical-to-SBRef/EPI transformation
→ EPI-space GM ribbon
→ Cortical depth / laminar analysis
必须检查:
- Registration 方向、source/target geometry 是否正确。
- EPI susceptibility distortion、signal dropout、partial FOV。
- Calcarine sulcus 的定位、两个 sulcal banks 的分离。
- GM mask 是否偏入 CSF 或 WM。
离散 segmentation resampling 可以使用 nearest-neighbor 以保留标签,但 nearest-neighbor 不能修复错误配准或恢复分辨率。
这里不提供与特定软件无关的固定变换命令:实际操作必须基于当前 pipeline 的 bbregister .dat、LTA 或 AFNI affine 等变换文件,核对 transform direction 后执行。
5.5 两种 layer-fMRI 接入路线(60 分钟)
Route A — Surface-based:在经过 QC 的 white/pial surfaces 之间构造中间 depth surfaces,结合正确的坐标变换对 functional data 采样。
Route B — Volume-based:从 ribbon、WM mask 和 CSF/outside-cortex mask 构造工具所需的 rim/segmentation 输入,再运行适当的 depth 算法(如 LAYNII)。
FreeSurfer
ribbon.mgz的标签不能不经转换就作为 LAYNII 的 rim 文件。先确认所用 LAYNII 版本的 input-label conventions。
尽量避免在较粗的 EPI grid 中直接计算全部 cortical depths 而丢失 anatomical geometry;根据具体方法在合适的高分辨率网格计算并验证映射。
5.6 最终作业和验收
layerfmri_inputs/
├── anatomical/
│ ├── lh.white.gii
│ ├── lh.pial.gii
│ ├── rh.white.gii
│ ├── rh.pial.gii
│ ├── ribbon.mgz
│ └── GM_ribbon.nii.gz
├── functional/
│ ├── SBRef_reference.nii.gz
│ └── GM_ribbon_EPI.nii.gz
├── qc/
│ ├── anatomical_surface_qc/
│ ├── epi_registration_qc/
│ └── final_qc_summary.md
└── scripts/
├── surface_conversion.sh
├── ribbon_generation.sh
└── epi_registration.sh
验收: 独立从修正后的 surfaces 得到 GM ribbon,验证 anatomical-space QC,并验证到 EPI reference 的映射。
Surface Editing 决策速查
| 问题 | 首先检查 | 优先处理 |
|---|---|---|
| White surface 内陷 | WM intensity 与 segmentation | wm.mgz / control points |
| White surface 进入 GM | WM segmentation | wm.mgz erase |
| Pial 包含 dura | Brainmask / skull stripping | brainmask.mgz edit |
| Pial 包含疑似 vein | 多平面 anatomy / 其他 contrast | 确认原因后谨慎处理 |
| Pial 进入 cerebellum | 小脑与大脑邻接处 | 专门的 brain.finalsurfs.manedit.mgz 流程 |
| 相邻 gyri 错误连接 | Topology / WM segmentation | WM/topology correction |
| Ribbon 位置错误 | White/pial geometry | 修正 surfaces 后重新生成 |
| Ribbon 在 EPI 中错位 | Anatomical–EPI transform | 修改 registration,不能靠修改 anatomy 掩盖 |
最终实践考核:三名受试者
完成五天后,选择 3 名真实 7T 受试者进行 occipital-cortex QC:
- Subject A: 原始 reconstruction 质量较好,用于建立正常边界判断标准。
- Subject B: 有可确认的 WM segmentation errors。
- Subject C: 有可确认的 pial errors,最好位于 medial occipital cortex。
每位受试者检查:
| 维度 | 检查内容 |
|---|---|
| Anatomical accuracy | White/pial 是否沿 MRI 可见边界 |
| Surface geometry | 异常连接、交叉、形变 |
| Cortical thickness | 是否存在局部异常值 |
| EPI correspondence | Ribbon 是否与功能数据对齐 |
有条件时由另一位熟悉 MRI anatomy 的研究者交叉检查。不要因觉得原始 surface“不够平滑”就进行编辑。
7T 特别注意
- recon-all 的 reconstruction grid 可能与原始高分辨率 MP2RAGE 网格不同。
- 应检查 voxel size、affine、surface coordinate conventions。
- 若需要高分辨率 ribbon,考虑从经过验证的 surface geometry 在目标 grid 中重新 voxelize,而不是放大低分辨率
ribbon.mgz。 - Surface accuracy 与实际 layer-fMRI spatial specificity 是两回事;EPI distortion、PSF、registration error 与 GE-BOLD draining-vein bias 仍需独立处理。
官方参考资源
- Troubleshooting Recon-all Results
- White Matter Edits
- Control Points
- Pial Surface Edits
- Topological Defects
- FreeSurfer Tutorial Data
- mris_volmask
- GIFTI
- mri_vol2vol
- Freeview Recon Edit
最终工作流
7T MP2RAGE
↓
FreeSurfer recon-all
↓
Initial Surface QC
├── WM errors → Edit wm.mgz / Control points
├── Pial errors → Edit brainmask.mgz
└── Topology errors → Correct and reconstruct
↓
Partial recon-all
↓
Validated lh/rh.white + lh/rh.pial
↓
GM Ribbon Generation / GIFTI Export
↓
Anatomical-to-EPI Registration & QC
↓
GM Ribbon in Functional Space
↓
Cortical Depth Estimation
↓
Laminar BOLD Analysis
核心训练重点: Day 2、Day 3 的解剖判读与 mgz editing。Day 5 的终点是可靠的 white/pial surfaces、GM ribbon 和经过验证的 anatomical–functional alignment,而不是假定已经解决所有 layer-fMRI vascular bias 问题。