← 笔记 Notes

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 三个方向连续观察。

学习成果与验收标准

完成训练后,应能:

  1. 在 T1w/MP2RAGE 中辨认 GM、WM、CSF、dura、主要 venous sinuses,以及常见 cortical/bridging veins 的可疑影像表现。
  2. 判断 white surface 与 pial surface 何处偏离真实组织边界,区分 segmentation、normalization、skull stripping、topology 和 registration 问题。
  3. 使用 Freeview 编辑 wm.mgz、brainmask.mgz,理解何时使用 control points,并在需要时处理特殊 pial correction。
  4. 运行合适的 partial recon-all、验证 lh/rh.white 与 lh/rh.pial。
  5. 基于修正后的 surfaces 生成 GM ribbon,转换 surface 格式,并验证 anatomical-to-EPI alignment,为 layer-fMRI 准备输入。

五天目标是形成独立编辑与 QC 的工作能力,而不是保证每位受试者都达到专家级精度;具体结果取决于 MRI contrast、空间分辨率、配准质量和外部验证。

总览

天数核心主题Anatomy / physiologyHands-on当日成果
Day 1MRI anatomy & surface QCGM/WM/CSF、脑膜、脑沟脑回、dura、sinusesFreeview 多平面检查、错误分类Surface QC log
Day 2White surface editingGM–WM boundary、WM hypointensity、partial volume编辑 wm.mgz、control points、重建改善 white surface
Day 3Pial surface editingPia、arachnoid、dura、cortical veins、sinuses编辑 brainmask.mgz、pial reconstruction改善 pial surface
Day 4Complete reconstruction & QCCortical ribbon、sulci、topology综合修正、partial recon-all、比较可重复的 surface QC workflow
Day 5GM ribbon & layer-fMRICortical depth、equidistant/equivolumetric、vascular biasRibbon generation、GIFTI、EPI registrationLayer-fMRI anatomical inputs

Day 1 — Anatomical Recognition & Surface QC

目标:先学会识别错误,不急于编辑。 预计 4–5 小时。

1.1 Anatomy 学习(60 分钟)

结构需要掌握Surface editing 的意义
White matterMyelination;WM/GM intensity contrastwhite boundary
Cortical GMGyral crown、sulcal bank、ribbon thickness判断 ribbon 和边界
CSFSulcal CSF、subarachnoid spacepial boundary
Pia紧贴 cortex 并进入 sulcipial surface 的解剖近似
DuraFalx、tentorium避免 pial contamination
Dural venous sinusesSuperior 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 处可疑区域,包含若干最终判断“不需要修正”的结构。

RegionSurfaceObservationSuspected causeConfidence
LH calcarineWhiteBoundary intrudes into GMWM segmentationHigh
RH occipital polePialExtends beyond cortexPossible dura/vesselMedium
LH cuneusPialSulcal boundary unclearPartial volumeLow

验收: 能独立加载四个 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 被误判为 WMwm.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 sinusFalx–tentorium 交界Medial posterior anatomy
Transverse/sigmoid sinusPosterior cranial fossaOccipital/inferior QC
Superficial cortical veins脑皮层表面Pial contamination
Bridging veinsCortex 到 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 分钟)

必修: Pial Surface Edits

官方 dura contamination 案例流程:

  1. 打开 brainmask.mgz,显示 white/pial surfaces。
  2. 在多视图定位被 pial 包含的非皮层组织。
  3. 进入 Recon Edit,局部移除确认不属于 cortex 的结构。
  4. 检查邻近切片、保存 brainmask.mgz。
  5. 重建 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 分钟)

教程: Topological Defects

识别 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意义
2Left WM
3Left cortical GM
41Right WM
42Right 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 与 segmentationwm.mgz / control points
White surface 进入 GMWM segmentationwm.mgz erase
Pial 包含 duraBrainmask / skull strippingbrainmask.mgz edit
Pial 包含疑似 vein多平面 anatomy / 其他 contrast确认原因后谨慎处理
Pial 进入 cerebellum小脑与大脑邻接处专门的 brain.finalsurfs.manedit.mgz 流程
相邻 gyri 错误连接Topology / WM segmentationWM/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 accuracyWhite/pial 是否沿 MRI 可见边界
Surface geometry异常连接、交叉、形变
Cortical thickness是否存在局部异常值
EPI correspondenceRibbon 是否与功能数据对齐

有条件时由另一位熟悉 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 仍需独立处理。

官方参考资源

  1. Troubleshooting Recon-all Results
  2. White Matter Edits
  3. Control Points
  4. Pial Surface Edits
  5. Topological Defects
  6. FreeSurfer Tutorial Data
  7. mris_volmask
  8. GIFTI
  9. mri_vol2vol
  10. 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 问题。