【保姆级打包】MATLAB枝切法解包裹:干涉图相位解包裹三步跑通
【保姆级打包】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)。步骤如下:
- 拉取代码:
git clone https://gitcode.com/open-source-toolkit/7eea3,然后把仓库根目录的枝切法解包裹.zip解压出来。 - 打开 MATLAB,把工作目录切换到解压后的
枝切法解包裹/文件夹。 - 直接运行
main.m。它会依次读取ok/0.bmp~ok/8.bmp,用相移公式atan2(I2-I4, I3-I1)算出卷绕相位,再调PhaseResidues→BranchCuts(搜索半径参数max_box_radius=5)→FloodFill完成解包裹,最后弹出三个窗口:卷绕相位、解包相位、加圆形掩膜后的解包结果。
有一个交互点要留意:FloodFill.m 会弹出一个对话框,要求你手动点选一个"已知真实相位"的参考点;如果点落在枝切上会直接报错,所以选点时避开图中被切开的地方。
原理白话版:先找缝,再展开
把卷绕相位想象成一张绕在圆筒上、被卷到只剩一圈高度的等高线图。解包裹就是把圆筒展开回平面,关键是那条 2π 跳变的"接缝"不能从中间硬剪。枝切法的做法分三步:
- 找奇点:PhaseResidues.m 对每个 2×2 像素块绕一圈把四段相位增量加起来,若总和是 ±2π,就把该块标为 +1 或 -1 的"残差",相当于在图上标出了所有接缝端点。
- 连枝切:
BranchCuts.m按 Goldstein 方法把正、负残差两两配对连成枝切,让接缝避开条纹密集区,且max_box_radius控制搜索范围,防止把有效区域切碎。 - 绕开切线填平面:
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 反馈。
登录后查看全文