【保姆级打包】MATLAB枝切法解包裹:干涉图相位解包裹三步跑通

原创2026-11-12 11:53:431,461 阅读

【保姆级打包】MATLAB枝切法解包裹:干涉图相位解包裹三步跑通

拿到一组干涉图,相位全被卷在 -π~π 之间来回跳,直接画形貌就是断层。MATLAB枝切法解包裹这个仓库用枝切法把跳变挡掉,还自带 9 张现成干涉图,打开 MATLAB 就能跑。

相位跳变为什么难处理:问题出在哪 🔍

相位解包裹要解决的是一个很具体的麻烦:真实相位可以超过 ±π,但干涉图里存下的相位被"卷绕"回了 [-π, π] 区间,相邻像素之间动辄跳变 2π。你看到的条纹是连续的,数据却是一跳一跳的。

两个典型卡点:

  • 手里有九帧相移干涉图,想提取连续相位再算形貌,却要在网上东拼西凑三套代码:提相位的、找奇异点的、区域填平面的,接口还对不上。
  • 只看算法论文能看懂公式,动手时连"残差在哪里标、枝切往哪边连"都没有参考实现可抄。

这个仓库把整条链路打包好了:解压 枝切法解包裹.zip 后,里面是一个 枝切法解包裹/ 目录,main.m 是入口,PhaseResidues.m、BranchCuts.m、FloodFill.m 三个文件分别负责残差检测、枝切布置和洪泛解包裹,ok/ 目录下躺着 0.bmp 到 8.bmp 共 9 张测试干涉图。

快速上手:MATLAB 环境要求与三步跑通

依赖只有一条:MATLAB R2016b 或更高版本(见 README.md)。步骤如下:

  1. 拉取代码:git clone https://gitcode.com/open-source-toolkit/7eea3,然后把仓库根目录的 枝切法解包裹.zip 解压出来。
  2. 打开 MATLAB,把工作目录切换到解压后的 枝切法解包裹/ 文件夹。
  3. 直接运行 main.m。它会依次读取 ok/0.bmp~ok/8.bmp,用相移公式 atan2(I2-I4, I3-I1) 算出卷绕相位,再调 PhaseResidues → BranchCuts(搜索半径参数 max_box_radius=5)→ FloodFill 完成解包裹,最后弹出三个窗口:卷绕相位、解包相位、加圆形掩膜后的解包结果。

有一个交互点要留意:FloodFill.m 会弹出一个对话框,要求你手动点选一个"已知真实相位"的参考点;如果点落在枝切上会直接报错,所以选点时避开图中被切开的地方。

原理白话版:先找缝,再展开

把卷绕相位想象成一张绕在圆筒上、被卷到只剩一圈高度的等高线图。解包裹就是把圆筒展开回平面,关键是那条 2π 跳变的"接缝"不能从中间硬剪。枝切法的做法分三步:

  1. 找奇点:PhaseResidues.m 对每个 2×2 像素块绕一圈把四段相位增量加起来,若总和是 ±2π,就把该块标为 +1 或 -1 的"残差",相当于在图上标出了所有接缝端点。
  2. 连枝切:BranchCuts.m 按 Goldstein 方法把正、负残差两两配对连成枝切,让接缝避开条纹密集区,且 max_box_radius 控制搜索范围,防止把有效区域切碎。
  3. 绕开切线填平面:FloodFill.m 从你点选的参考点出发逐像素洪泛,凡是越过卷绕点就补 ±2π,但永远不跨过枝切,最后得到一张连续的相位面。

适用场景:输入什么、输出什么、省了什么

  • 相移干涉测量:输入九帧相移图(仓库 ok/ 里的 9 张 bmp 就是这个套路),输出以弧度为单位的连续相位曲面,省去自己搭提相位+解包裹流水线的搭建时间。
  • 算法学习与教学:三个核心 .m 文件各只干一件事,注释里画了残差编号示意图,可以逐行对照着学 Goldstein 枝切法的实现。
  • 验证自己的数据:把 main.m 开头的 imread 路径换成自己的 bmp 文件即可,拿仓库自带的 9 帧标准数据当对照基线,确认流程没跑歪。

值不值得用:4 条具体证据

  • 环境门槛低:仅要求 MATLAB R2016b 及以上,无需编译、无第三方工具箱依赖,imread 和 atan2 都是基础函数。
  • 流程是闭环的:5 个 .m 文件(含辅助的 elliptical_crop.m)加 9 张测试图,一次 main.m 就出三张对比图,不用自己串接口。
  • 实现有出处:BranchCuts.m 文件头写明按 Ghiglia 和 Pritt 文献中的 Goldstein 方法实现,PhaseResidues.m 的残差定义与教科书一致,方便回溯核对。
  • 授权是 MIT(见 LICENSE),可自由修改、并入自己的测量项目。

想抠算法细节,建议从 PhaseResidues.m 和 BranchCuts.m 的文件头注释读起;使用中遇到问题,可以直接向仓库提 Issue 反馈。

登录后查看全文
MATLAB枝切法解包裹程序