标定链总览
七条链的顺序、依赖关系、各自的判据,以及「链」这个说法的含义。
为什么是「链」不是「一堆标定」
因为它们有依赖顺序,而且前一条做错时,后一条不会报错,只会给出一个看起来合理的错值。
⑦ camera_focus ① pixel_size
相机合焦 Z 像素当量 + 安装角 ← 两条链都没有前置
(排最前:后面每条链 │ │
拍照前都先回到这个 Z) ↓ ↓
② cam_actuator_offset ③ lens_distortion
相机—执行器偏移 镜头畸变
│ │ │
↓ └──────┬───────┤
⑥ laser_focus ↓ ↓
激光焦点 Z ⑤ field_correction ④ hand_eye
振镜场校正 九点 / 手眼
七条链
| id | 名称 | 解什么 | 前置 | 验收容差 |
|---|---|---|---|---|
pixel_size |
① 像素当量 | mm/px 与相机安装角(2×2 雅可比) | — | 0.002 µm/px;安装角 0.02° |
cam_actuator_offset |
② 相机—执行器偏移 | 相机光心到振镜场心的 XY 偏移 | ① | 0.01 mm |
lens_distortion |
③ 镜头畸变 | k₁、k₂ 两个径向系数 | ① | 残差 0.3 px RMS |
hand_eye |
④ 九点 / 手眼 | 像素 → 台面的仿射关系 | ①③ | 残差 0.005 mm |
field_correction |
⑤ 振镜场校正 | 场内网格校正表 | ①②③ | 去平移残差 0.010 mm |
laser_focus |
⑥ 激光焦点 Z | 光斑最小处的 Z | ①② | 0.02 mm |
camera_focus |
⑦ 相机合焦 Z | 清晰度峰位的 Z | — | 0.05 mm |
容差全部来自 core/src/PreciSim.Core/Constants.cs 的 CalibTolerance,不是散在各条链里的魔法数。
这些数字对应 demo-xy-galvo 这台虚拟机台;真机上按你的精度预算改。
⑦ 为什么排在最前:它产出的合焦 Z 是后面每一条链「拍照前先对焦」的前提。 它自己没有前置,所以不会把依赖图绑死——单独跑别的链时用标称合焦 Z 也能工作。
每条链都实现同一个接口
所以向导界面、进度、日志、中止、存档、重跑逻辑全部复用:
public interface ICalibrationProcedure
{
string Id { get; } // 如 "pixel_size"
string DisplayName { get; } // 如 "① 像素当量"
IReadOnlyList<CalibStep> Steps { get; } // 向导步骤条
IReadOnlyList<string> Prerequisites { get; } // 依赖的其他链 id
Task<CalibResult> RunAsync(
CalibContext ctx,
IProgress<CalibProgress> progress,
CancellationToken ct); // 必须能中途取消并安全复位
}CalibContext 里只有四样东西:设备集合、视觉服务、运行参数、真值来源(真机上为 null)。
标定链不许自己动世界——要换标定板就调 ctx.RequestBoardAsync,
由上层决定怎么换(真机上提示操作员换板,虚拟设备上直接切预设)。
链自己去切板子,就成了引擎自己验证自己:测试全绿,现场全错。
链与链之间怎么传结果
CalibrationRegistry.Apply 是唯一的耦合点:上一条链测出来的量回填进下一条的 CalibOptions。
case "pixel_size":
options.Jacobian = new Jacobian2x2(v["j00"], v["j01"], v["j10"], v["j11"]);
break;
case "cam_actuator_offset":
options.MeasuredOffsetMm = new Vec2(v["offsetXMm"], v["offsetYMm"]);
break;没有任何一条链去问引擎要真值。真值只用于事后对照,不参与求解—— 这一条是整套东西可信的前提。
结果长什么样
public sealed record CalibResult(
bool Success,
IReadOnlyDictionary<string, double> Values, // 测出来的量
IReadOnlyList<ResidualPoint> Residuals, // 残差点,画图用
string? FailReason,
IReadOnlyList<string> SavedFrames) // 失败帧存盘路径
{
public IReadOnlyList<TruthCompare> TruthCompares { get; init; } // 虚拟设备才有
public ResidualStats Stats { get; init; } // 三组残差统计
public IReadOnlyDictionary<string, double> TimingMs { get; init; }
}两个设计要点,都是吃过亏才有的:
- 误差必须三个一起报:原始最大 / 去平移残差 / 留一法。只报一个数没法判读—— 恒定平移可以靠工位补偿掉,随机散布不行,两者混在一个 RMS 里看不出区别。
- 失败帧必须存盘:视觉找不到目标时,帧 + 当时生效的参数一起落盘。 没有这个,「偶尔标不上」这种问题永远复现不了。
真值评分:虚拟设备独有
真机上你只有残差,没有真值。虚拟设备知道真值,所以能多给一行:
测出来: 像素当量 = 1.7251 µm/px
真值: 像素当量 = 1.7236 µm/px
对照: 偏差 0.0015 µm/px,容差 0.002 → PASS
这行的意义不是「让数字好看」,而是让你知道残差小到什么程度才算真的准。 很多人第一次发现「残差很小但偏差很大」时,才真正理解了标定。
结果存哪
上位机把每次标定写进本地 SQLite(data/precisim.db 的 CalibrationRecord 表):
| 列 | 内容 |
|---|---|
ProcedureId / DeviceId / Timestamp / Operator |
谁在哪台机上什么时候跑的 |
Passed |
是否通过 |
ValuesJson / ResidualsJson / TruthCompareJson |
测出来的量、残差点、真值对照 |
永远追加,不覆盖。 能查「这台设备三个月来所有标定记录」并画趋势图—— 出了问题要能回溯到「哪次标定开始不对的」,这份存档就是全部依据。