【一键下载】MATLAB 枝切法解包裹:三步跑通干涉图相位恢复
【一键下载】MATLAB 枝切法解包裹:三步跑通干涉图相位恢复
MATLAB枝切法解包裹程序是一个基于 MATLAB 的干涉图解包裹工具,用枝切法(Branch Cut)算法恢复连续相位,仓库自带一组干涉图测试数据,克隆下来就能跑。
为什么需要它
干涉图测出来的相位,天然被"卷"在 -π 到 π 之间。相邻像素真实相差 5 弧度时,记录值会从 +3 直接跳到 -3。你要恢复真实表面,就得把这些 2π 跳变逐一点出来补回去,这个过程叫相位解包裹。图大、跳变点密的时候,手工处理一张图要折腾半天,还容易漏点、补错。这个仓库把整套枝切法流程封装成了几个短文件,拿来就能用。
它解决了什么
- 输入:二维干涉相位图(wrapped phase)。解压 枝切法解包裹.zip 后,
ok/目录自带 9 张测试图,不用自己造数据。 - 输出:解包后的连续相位图,±2π 跳变消失,可直接用于表面形貌重建。
- 适用对象:光学干涉测量、相位成像里得到的相位分布。
判断标准很简单:你手上如果有带跳变的二维干涉相位图,就对得上;要解的不是干涉相位数据,就不必往下看了。
核心原理,一次讲清
枝切法的动作一句话就能说清:在相位图上画几条"切口",把 2π 跳变挡住,让相位只能沿连续路径走。就像在河面上立几块隔离墩,水流绕着走,不会突然瞬移。切口画好后,解包裹就退化成一次简单的连通区域填充。
算法分三步走
先检测相位不连续的残余点,也就是跳变集中的地方;再以这些点为端点生成枝切线;最后用洪泛填充把 2π 一段段补回来。代码里的 PhaseResidues.m、BranchCuts.m、FloodFill.m 正好对应这三步,一个文件管一件事。
技术栈与依赖
纯 MATLAB 脚本实现,要求 R2016b 或更高版本,不依赖额外工具箱,装好 MATLAB 就能跑。
一个设计取舍
枝切法比逐点迭代快得多,适合低噪声的常规干涉图;代价是对噪声敏感,图质量差时切口位置会不准。仓库里的 elliptical_crop.m 先帮你圈出有效区域,再进解包裹流程,就是在给这一步兜底。
三步上手 🚀
- 拿到代码:
git clone https://gitcode.com/open-source-toolkit/7eea3,目录下能看到枝切法解包裹.zip和README.md即成功。 - 准备数据:解压 zip,确认有
main.m和ok/测试图目录;有自己的干涉图,可以放进解压后的同一目录里加载。 - 跑通示例:MATLAB 切换到解压目录,运行
main.m。判断标准:输出的相位图连续平滑,看不到突然的 ±2π 跳变。
适合谁、能用到哪
科研
做光学干涉测量、相位成像的人,拿到条纹图后直接跑一遍,把"找跳变点"从手工降到一行命令,省下的时间留给后续的误差分析。
工程
表面形貌测量、无损检测里,干涉图是日常数据。自带测试图意味着你半小时就能验证自己的数据能不能走通,不用先花一周写算法。
教学
三个短文件对应"残余点—枝切线—填充"三步,给学生讲原理时,每个概念都能指着一段代码说,比只挂 PPT 直观。
项目速览(亮点与仓库信息)
- 许可证:MIT 协议,详见
LICENSE - 运行环境:MATLAB R2016b 或更高版本
- 仓库地址:
git clone https://gitcode.com/open-source-toolkit/7eea3 - 文档入口:README.md
- 社区渠道:问题提交 Issue,改进建议提 Pull Request
- 亮点:纯 MATLAB 实现、无额外依赖;自带 9 张干涉图测试数据,开箱即跑
写在最后:把仓库克隆下来,解压后直接运行 main.m,先看一遍自带测试图的解包裹效果。觉得流程顺手,再拿自己的一组干涉图试一次——能不能跑通,十分钟就有答案。