跳到正文
PreciSim
concepts

标定链总览

七条链的顺序、依赖关系、各自的判据,以及「链」这个说法的含义。

为什么是「链」不是「一堆标定」

因为它们有依赖顺序,而且前一条做错时,后一条不会报错,只会给出一个看起来合理的错值。

  ⑦ 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 测出来的量、残差点、真值对照

永远追加,不覆盖。 能查「这台设备三个月来所有标定记录」并画趋势图—— 出了问题要能回溯到「哪次标定开始不对的」,这份存档就是全部依据。

最后更新: 2026/9/23
这页有帮助吗?