using System; using System.Collections.Generic; using System.Linq; using System.Threading; using AutoFocusTool.Serial; using AutoFocusTool.Imaging; using SerialCamera = AutoFocusTool.Camera.Camera; namespace AutoFocusTool.Calib { /// /// 自动标定引擎(可复用,GUI/命令行共用)。封装单well标定四步: /// ①粗对焦(中央40% ROI) → ②水平扫描找最居中位置 → ③曝光二分(well内ROI) → ④精对焦(0.95r ROI + 平滑插值) /// 通过回调上报进度(文字)与实时帧(byte[]),便于界面实时显示。 /// public class CalibrationEngine { readonly int W, H; // 取自相机实际分辨率,绝不能硬编码 readonly HouseMotor _motor; readonly SerialCamera _cam; public Action Log; public Action OnFrame; // 实时帧回调(原始BGR) public Action OnStep; // 步骤+当前圆/曝光 /// 居中容差(Y偏移百分比),落入即合格,避免来回震荡。 public double CenterTolPct = 12; /// 粗扫范围(脉冲,零点±range)与步数。 public int HScanRange = 4000; public int HScanSteps = 7; /// 细扫步数(在粗扫最佳点附近精调Y)。 public int FineScanSteps = 7; /// Z扫描半幅与层数。 public int ZHalf = 1500, ZLayers = 9; public int ExpLo = 10, ExpHi = 800; /// 扫描时电机稳定延时(ms)。小步移动无需1500ms,用短延时大幅提速。 public int ScanDelayMs = 350; /// 粗对焦层数(先让well清晰,再居中)。 public int CoarseFocusLayers = 7; /// 居中扫描用的固定曝光(well是暗背景上中灰盘,HScan实测~60可清晰检圆)。 public Action DebugSave; // 诊断存图(帧,文件名前缀),可选 public int CenterScanExposure = 60; // ── 行程限位(所有电机移动前钳到该区间)── /// 水平电机行程下/上限脉冲(实测16个well EEPROM位置达205800,留余量到220000)。 public int HMin = 0, HMax = 220000; /// 垂直电机行程下/上限脉冲(旧工程软上限 125000)。 public int ZMin = 0, ZMaxPulse = 125000; // ── 水平居中微调(以各well的EEPROM位置为中心做小范围Y居中)── // 实测well间距~9000、EEPROM位置已准(移到位即|偏移|<5%),故半幅须远小于间距一半(4500), // 只在小范围微调Y居中,绝不大范围扫描(否则会扫到相邻well)。 /// 水平微调半幅(脉冲,EEPROM位置±range)。 public int HFineRange = 2000; /// 水平微调步数(±2000内9步→步距500)。 public int HFineSteps = 9; // ── Z 全范围粗对焦(固定中心大窗口)── /// Z 粗对焦固定中心(实测焦面集中区间 60000~120000 的中点)。 public int ZCoarseCenter = 90000; /// Z 粗对焦半幅 → 区间 60000~120000。 public int ZCoarseHalf = 30000; /// Z 粗对焦步距 → 约 31 层。 public int ZCoarseStep = 2000; /// 粗对焦开扫前的额外停稳等待(ms)。复位后Z大行程冲到起点需充分停稳, /// 否则前几层抓到运动拖影帧形成伪峰。默认2000。 public int CoarseSettleMs = 2000; // ── Z 精对焦(围绕粗峰)── /// 精对焦半幅(覆盖粗扫 ±2000 峰定位误差并留余量)。 public int FineZHalf = 6000; /// 精对焦步距 → 约 24 层(精度优先)。 public int FineZStep = 500; public CalibrationEngine(HouseMotor motor, SerialCamera cam) { _motor = motor; _cam = cam; W = cam.Width; H = cam.Height; } /// 水平脉冲钳到 [HMin,HMax],越界写 Log。 int ClampH(int p) { int c = Math.Max(HMin, Math.Min(HMax, p)); if (c != p) Log?.Invoke($" ⚠ 水平脉冲 {p} 越界,钳到 {c} [{HMin},{HMax}]"); return c; } /// 垂直脉冲钳到 [ZMin,ZMaxPulse],越界写 Log。 int ClampZ(int p) { int c = Math.Max(ZMin, Math.Min(ZMaxPulse, p)); if (c != p) Log?.Invoke($" ⚠ 垂直脉冲 {p} 越界,钳到 {c} [{ZMin},{ZMaxPulse}]"); return c; } /// 中央40% ROI(精对焦/粗对焦圆未检出时的降级,避免背景边缘带偏)。 System.Drawing.Rectangle CenterRoi40() { int roiW = (int)(W * 0.4), roiH = (int)(H * 0.4); return new System.Drawing.Rectangle((W - roiW) / 2, (H - roiH) / 2, roiW, roiH); } /// /// P0-6: 关键定位移动带重试。下位机偶发不回复(串口噪声/忙)时直接放弃整个well过于脆弱, /// 重试最多 maxRetry 次,每次间隔后再试。 /// bool RetryMove(Func move, string what, int maxRetry = 3) { for (int i = 0; i < maxRetry; i++) { if (move()) return true; Log?.Invoke($" {what} 移动失败,重试 {i + 1}/{maxRetry}"); Thread.Sleep(400); } return false; } byte[] Grab() { int retry = 0; while (retry < 3) { try { _cam.GrabRgb(); var b = _cam.GetSourceBuffer(); if (b != null && b.Length > 0) { OnFrame?.Invoke(b); return b; } } catch (Exception ex) { Log?.Invoke($"抓帧失败(重试{retry + 1}/3): {ex.Message}"); } retry++; Thread.Sleep(50); } throw new Exception("抓帧失败,已重试3次"); } /// /// 绕 center±range 扫 steps 个水平位置,找 well 检出且 |Y偏移| 最小的位置。 /// 转动培养皿让 well 在画面上下(Y)移动,故按 Y 偏移评分;优先完整。 /// (int bestHPos, WellCircle bestCircle) ScanForCenter(int well, int center, int range, int steps, int delayMs = -1) { int bestHPos = center; double bestScore = double.MaxValue; WellCircle best = null; int step = steps > 1 ? 2 * range / (steps - 1) : 1; int actualDelay = delayMs > 0 ? delayMs : ScanDelayMs; // 使用传入延时或默认值 // 固定中低曝光设一次即可:well 是暗背景上的中灰盘,不能按全图均值自动曝光(会过曝well盘) _cam.SetExposure(CenterScanExposure); for (int i = 0; i < steps; i++) { int hp = ClampH(center - range + step * i); _motor.HorizontalMoveTo(hp, actualDelay); var b = Grab(); var c = WellDetector.Detect(b, W, H); DebugSave?.Invoke(b, $"center_w{well}_hp{hp}"); Log?.Invoke(c.Found ? $" 水平{hp}: Y偏移={c.OffsetYPct:F1}% X={c.OffsetXPct:F1}% 完整={c.Complete}" : $" 水平{hp}: 未检出圆"); OnStep?.Invoke($"居中扫描 hp={hp}", c, null); if (c.Found) { // 按 |Y偏移| 评分,不完整重罚 double score = Math.Abs(c.OffsetYPct) + (c.Complete ? 0 : 100); if (score < bestScore) { bestScore = score; bestHPos = hp; best = c; } } } return (bestHPos, best); } /// /// 标定单个 well。eepromHPos=该well的EEPROM水平位置(扫描中心),eepromZ=Z焦准零点。 /// 返回标定结果。 /// public WellCalib CalibrateWell(int well, int eepromHPos, int eepromZ) { var r = new WellCalib { Well = well }; // 先到 EEPROM 水平位置 + 中低曝光 if (!RetryMove(() => _motor.HorizontalMoveTo(ClampH(eepromHPos), ScanDelayMs), $"well{well}初始水平")) { Log?.Invoke($"[well{well}] ✗ 电机移动到初始位置失败(已重试),跳过该well"); return new WellCalib { Well = well, Note = "电机移动失败" }; } _cam.SetExposure(CenterScanExposure); // ── ① 粗对焦:先让 well 清晰,否则画面模糊根本找不到圆(采纳用户洞察: // 对焦与居中耦合,焦不对→画面糊→检不出圆→无法居中。故先粗对焦)── Log?.Invoke($"[well{well}] ①粗对焦(让well清晰可检)..."); int coarseZ = CoarseFocus(well); _motor.VerticalMoveTo(ClampZ(coarseZ), ScanDelayMs); Log?.Invoke($"[well{well}] → 粗对焦Z={coarseZ}"); // ── ② 旋转居中(此时画面清晰,圆可稳定检出;只优化Y偏移)── // 转动培养皿让well在画面里上下(Y)移动;X的~5%固定偏移是相机/转盘硬件偏移,旋转修不了。 // 实测EEPROM位置已准(移到位即|偏移|<5%),故以eepromHPos为中心做小范围微调(半幅 _motor.HorizontalMoveTo(ClampH(bestHPos), ScanDelayMs), $"well{well}居中水平")) { Log?.Invoke($"[well{well}] ✗ 电机移动到居中位置失败(已重试),跳过该well"); return new WellCalib { Well = well, Note = "居中后电机移动失败" }; } bool centered = bestCircle != null && Math.Abs(r.CenterOffsetPct) < CenterTolPct && bestCircle.Complete; Log?.Invoke($"[well{well}] → 居中水平={bestHPos} 残留Y偏移={r.CenterOffsetPct:F1}% " + $"(X={bestCircle?.OffsetXPct ?? 0:F1}%硬件偏移) {(centered ? "✓合格" : "(尽力而为)")}"); // ── ③ 曝光二分 (well内ROI) ── Log?.Invoke($"[well{well}] ③曝光二分..."); int exp = ExposureMeter.BinarySearch(ExpLo, ExpHi, e => { _cam.SetExposure(e); // 修复: 等待足够时间让新曝光生效,并丢弃旧帧 Thread.Sleep(Math.Max(200, e / 5)); // 至少2×曝光时间(单位100µs) Grab(); // 丢弃第一帧(可能是旧曝光) var b = Grab(); // 使用第二帧 var c = WellDetector.Detect(b, W, H); var info = ExposureMeter.Measure(b, W, H, c); OnStep?.Invoke($"曝光二分 e={e}", c, info); return info; }, m => Log?.Invoke(m)); r.Exposure = exp; _cam.SetExposure(exp); Log?.Invoke($"[well{well}] → 曝光={exp}"); // ── ④ 精对焦 (well圆内ROI, 围绕粗对焦Z小范围密扫) ── Log?.Invoke($"[well{well}] ④精对焦..."); // 修复P0-5: 丢弃旧帧,确保获取稳定画面 Grab(); // 丢弃第一帧 var b0 = Grab(); // 使用第二帧 var circle = WellDetector.Detect(b0, W, H); // P1-1: 统一对焦ROI策略 - 使用0.95r保留边缘特征,避免精对焦峰值过弱 // P0-4: 圆未检出时降级到中央40% ROI(与粗对焦一致),绝不用全图(背景/反光严重干扰对焦) System.Drawing.Rectangle roi = circle.Found ? new System.Drawing.Rectangle( Math.Max(0, (int)(circle.Cx - circle.Radius * 0.95)), Math.Max(0, (int)(circle.Cy - circle.Radius * 0.95)), (int)(circle.Radius * 1.9), (int)(circle.Radius * 1.9)) : CenterRoi40(); if (!circle.Found) Log?.Invoke($"[well{well}] ⚠ 精对焦未检出well圆,对焦ROI降级为中央40%(非全图)"); int zstep = FineZStep > 0 ? FineZStep : 500; int fineLayers = 2 * FineZHalf / zstep + 1; // 半幅6000步距500 → 25层 var curve = new List<(int z, double s)>(); for (int i = 0; i < fineLayers; i++) { int z = coarseZ - FineZHalf + zstep * i; _motor.VerticalMoveTo(ClampZ(z), ScanDelayMs); // P0-5: 每次移动后丢弃旧帧 Grab(); // 丢弃第一帧 var b = Grab(); // 使用第二帧 double sc = Sharpness.Compute(b, W, H, roi); curve.Add((z, sc)); OnStep?.Invoke($"精对焦 {i + 1}/{fineLayers} Z={z} 分={sc:F4}", circle, null); } // P1-3: 峰值平滑与插值 - 提升对焦精度 // 3点滑动平均平滑 var smoothed = new List(); for (int i = 0; i < curve.Count; i++) { double sum = curve[i].s; int cnt = 1; if (i > 0) { sum += curve[i - 1].s; cnt++; } if (i < curve.Count - 1) { sum += curve[i + 1].s; cnt++; } smoothed.Add(sum / cnt); } // 找平滑后的峰值 double max = smoothed.Max(); int pk = smoothed.IndexOf(max); double mean = smoothed.Average(); // 抛物线插值峰顶(如果峰值不在边界) int focusZ = curve[pk].z; if (pk > 0 && pk < curve.Count - 1) { double y0 = smoothed[pk - 1], y1 = smoothed[pk], y2 = smoothed[pk + 1]; double denominator = y0 - 2 * y1 + y2; if (Math.Abs(denominator) > 1e-9) { double delta = 0.5 * (y0 - y2) / denominator; // 抛物线顶点偏移 focusZ = curve[pk].z + (int)(delta * zstep); } } r.FocusZ = focusZ; r.PeakSharp = max; r.PeakRatio = mean > 1e-9 ? max / mean : 1; // 检查对焦质量:峰过弱可能是空well或对焦失败 if (r.PeakRatio < 1.2) { Log?.Invoke($"[well{well}] ⚠ 对焦峰过弱(ratio={r.PeakRatio:F2}),可能空well或对焦失败"); r.Note += "对焦峰弱;"; } _motor.VerticalMoveTo(ClampZ(r.FocusZ), ScanDelayMs); Log?.Invoke($"[well{well}] → 最清晰Z={r.FocusZ} 峰值={max:F4} max/mean={r.PeakRatio:F2} " + $"{(r.PeakRatio < 1.2 ? "(弱峰/可能空well)" : "✓有焦点")}"); r.Note = $"{(r.CircleFound ? "" : "未检到well圆;")}{(r.PeakRatio < 1.2 ? "对焦峰弱;" : "")}"; return r; } /// /// 粗对焦:固定中心 ZCoarseCenter±ZCoarseHalf 按 ZCoarseStep 扫描,中央40% ROI 找焦点。 /// 实测所有 well 焦面集中在 60000~120000,故用固定大窗口,不依赖 EEPROM 零点。 /// /// 【已知偶发问题 2026-06-16,待复现】偶发某个 well 粗对焦选中 ~74000 的伪峰(真实焦面应在 ~86000-92000), /// 导致精对焦被锁在 74000±FineZHalf 的小窗口、最终对焦模糊,该 well 输出弱峰(max/mean≈1.0)。 /// 现象特征: /// · 同一批标定里只有 1 个 well 坏,坏值固定在 ~74000,但坏的 well 编号在不同批次间变化 /// (曾出现 well1 坏、well8 坏,非固定孔位、非“第一个标定的 well”)。 /// · 人眼在对焦过程能看到清晰画面,但最终选出的不是它。 /// 已排除的假设(真机 WellSpacing zcurve/zcurvefar 多次实测均无法复现): /// · 串口大行程移动未到位(残留位+短延时复现 → 峰仍正确 92000) /// · 相机/光源冷启动预热(冷启动立即扫 → 峰仍正确 92000) /// · 清晰度算法(已修 ÷mean,其余 15 well 全部正确) /// · “第一个 well”时序(数据证明 well1 常常正常,坏的在序列中间) /// 当前最可疑但未坐实:偶发时序导致某层电机未真正到位/画面在运动中被采样,在 74000 形成伪高频峰; /// 或该次该孔在 74000 处恰有杂质/反光的真实但“错误”的清晰特征。 /// 复现率低,本轮多次测试未触发,留待下次现场捕获(建议届时开 DebugSave 存粗对焦每层图比对)。 /// int CoarseFocus(int well) { int lo = ZCoarseCenter - ZCoarseHalf; int hi = ZCoarseCenter + ZCoarseHalf; int bestZ = ZCoarseCenter; double bestS = -1; // P0-6: 粗对焦使用中央40%区域ROI,避免背景干扰 var centerROI = CenterRoi40(); // 【偶发伪峰修复 2026-06-16】先移到扫描起点并额外等待,确保大行程移动停稳后再开扫。 // 根因:手动复位会把 Z 打到远端(2000),正式标定时 Z 要大行程冲到 lo(60000); // 若直接逐层扫描,前几层在电机尚未停稳时抓到“运动拖影帧”,高频被放大成伪峰 // (实测 z=74000 拍到 5.30 伪峰,骗过粗对焦;精对焦回到同一 Z 仅 3.21 无峰)。 // 故开扫前先到位 + 额外停稳等待。(后续可改“轮询回读位置确认到位”更精准,暂用延时。) _motor.VerticalMoveTo(ClampZ(lo), ScanDelayMs); Thread.Sleep(CoarseSettleMs); Grab(); // 丢弃到位前的残留帧 int layers = 0; for (int z = lo; z <= hi; z += ZCoarseStep) { layers++; _motor.VerticalMoveTo(ClampZ(z), ScanDelayMs); // P0-5: 丢弃旧帧 Grab(); var b = Grab(); double sc = Sharpness.Compute(b, W, H, centerROI); // 中央ROI(避免背景带偏) if (sc > bestS) { bestS = sc; bestZ = z; } // 诊断:粗对焦逐层分数落盘(排查偶发伪峰,如74000打败真焦面90000)。格式同精对焦。 Log?.Invoke($" 粗对焦 {layers} Z={z} 分={sc:F4}"); OnStep?.Invoke($"粗对焦 Z={z} (区间{lo}~{hi})", null, null); } Log?.Invoke($"[well{well}] 粗对焦扫{layers}层 区间[{lo},{hi}] 步距{ZCoarseStep}"); // P1: 峰落在扫描区间边界 → 真实焦面很可能在窗口之外,警示(focusZ会偏,需调整ZCoarseCenter/Half)。 if (bestZ <= lo || bestZ >= hi) Log?.Invoke($"[well{well}] ⚠ 粗对焦峰落在区间边界(z={bestZ}, 区间[{lo},{hi}])," + $"真实焦面可能在窗口外,建议调整 ZCoarseCenter/ZCoarseHalf"); return bestZ; } } }