quickstart
第一个实验(30 分钟)
不接任何硬件,跑完一条像素尺寸标定链,并看到你的结果与真值差了多少。
这一篇的目标只有一个:让你在 30 分钟内看到一个偏差数字。 不是「软件能打开」,是「我标出来的像素当量和真值差了 0.0015 µm/px」。
为什么先做像素尺寸
像素当量(µm/px)是 2D 视觉里最基础的一条标定链: 它把图像上的像素距离换算成台面上的毫米。后面所有东西——定位、对位、测量——都压在它上面。 它也最容易被做错,而且错了不会报错,只会在产线上表现为「偶尔偏一点」。
步骤
1. 确认虚拟机台
软件启动时按 appsettings.json 的 Device 段装配设备,默认就是虚拟机台
demo-xy-galvo;状态栏能看到机台名和「已连接」。
X / Y / Z 行程 ±165 / ±120 / 80–140 mm,重复定位 0.2 µm,读数噪声 0.5 µm
相机 4096 × 3000,像素当量 1.7236 µm/px(★ 真值),安装角 −0.80°(★ 真值)
标定板 圆点阵列,圆直径 1.0 mm、间距 2.0 mm
★ 的两个量就是这条链要测出来的东西。先别去翻配置文件,一会儿用它对答案。
2. 起标定向导
菜单 标定(C) → 像素尺寸标定。向导三步:
| 步骤 | 做什么 | 看什么 |
|---|---|---|
| 拍照采集 | 台面按网格走 N 个位置,每个位置抓一张图、找圆心 | 采集进度、每点检出的圆心数;中途可以中止,台面会回到起点 |
| 计算 | 最小二乘解出 2×2 雅可比,再拆成像素当量 X/Y、两个方向角、非正交量 | 残差 |
| 应用 | 结果落库(SQLite,永不覆盖) | 记录写入提示 |
保持默认参数点「拍照采集」,跑完再点「计算」。
3. 读结果
像素当量 X 1.7251 µm/px θx −0.798°
像素当量 Y 1.7248 µm/px θy −0.801°
非正交量 0.003° 残差 0.31 µm
真值对照 像素当量 1.7236 µm/px 偏差 0.0015 容差 0.002 → PASS
最后一行是关键:虚拟设备知道真值,所以它能直接告诉你标得准不准。 真机上你拿不到这一行——这正是先在虚拟设备上练的意义。
4. 故意把它做错
这一步别跳过,它比前三步都值钱。把采集网格缩小(参数里的点间距改到很小), 再跑一遍「拍照采集 + 计算」。
你会看到:
- 残差几乎没变,甚至更小;
- 真值对照的偏差明显变大,可能直接 FAIL。
这就是残差 ≠ 偏差最直观的一次演示: 模型很好地解释了你采的这批数据,但这批数据本身跨度太小,撑不起一个准确的解。 新人几乎总是反着做——在视野中心密集采一堆点,然后奇怪为什么不准。
5. 再看一眼安装角
把机台文件里相机的 rotationDeg 从 −0.80 改成 −5.0,重启软件再跑一次。
θx / θy 应该跟着变成 −5° 左右;如果它变成了 +5°,那就是符号反了——
这正是坐标约定必须写进注释、并且用真值测试守住的原因。
做完之后
最后更新: 2026/9/22
这页有帮助吗?