Files
nanocode/web-opencv/cpp/docs/沟通日志.md
T
Ubuntu 32b43f85bd a
2026-07-03 16:58:28 +08:00

7.9 KiB
Raw Blame History

鸿蒙算法改造 - 需求沟通日志

文档创建时间:2026-03-31 参与方:用户 & AI助手


一、项目背景

1.1 项目概述

  • 项目名称:鸿蒙尿检试纸识别算法改造
  • 改造范围:仅限于 E:\Qoder\urologist\entry\src\main\cpp 目录下的 C++ 代码
  • 技术栈:C++ + OpenCV,通过 N-API 与鸿蒙上层交互

1.2 核心功能

  1. 从上层 NAPI 接收图片
  2. 试纸定位:根据定位块特征找到定位块,匹配 PaperConfig 规格
  3. 获取反应色块的中心点位置列表
  4. 读取每个化学反应色块的颜色值(HSV、LAB)

二、第一轮需求澄清(2026-03-31)

Q1:定位块的识别特征

问题:

  • 定位块颜色范围(HSV边界值)是什么?
  • 定位块形状特征?最小/最大面积限制?
  • 如何区分定位块和反应色块?

用户答复:

  • 定位块颜色使用 RGB 分量比例判断,不用 HSV 边界值(效率考虑)
  • 定位块有两种:
    • 小定位块:3mm × 5mm(宽×高)
    • 大定位块:10mm × 5mm 或 15mm × 5mm
  • 定位块是矩形,反应色块是正方形(5mm × 5mm)
  • 关键点:反应色块可能是白色,通过 findContours 可能找不到轮廓
  • 定位块在试纸两端,中间是反应色块

Q2:定位失败的处理

问题:

  • 找不到两个定位块时返回什么错误码?
  • 找到多个候选定位块如何选择?

用户答复:

  • 反应色块和定位块是对齐在一条线上的
  • 找不到两个定位块 → 返回错误(参考现有 SayHello 代码)
  • 找到多于2个定位块 → 直接返回错误,不做进一步处理

Q3:试纸角度处理

问题:

  • 最大倾斜角度?
  • 是否需要图像旋转校正?

用户答复:

  • 不限制倾斜角度
  • 不做图像旋转处理,通过几何公式和斜率计算位置

三、第二轮需求澄清(2026-03-31)

Q4:slicesNum 计算方式

问题:

  • "2毫米"如何转换?是否用定位块高度作为基准?

用户答复:

  • 这是比例问题,生产单位(毫米)需转换为像素比例
  • 例如:10mm×5mm 的定位块在图像中可能是 100px×50px,则放大了10倍
  • PaperConfig 中的值需要乘以这个比例因子

Q5:firstPos 和 step 的单位

问题:

  • 这两个值是以"2毫米"还是"最小分割单位"为单位?

用户答复:

  • firstPos = 2.25 表示:(2 + 2.5) / 2 = 2.25
    • 2mm = 定位块边缘到第一个反应色块的距离
    • 2.5mm = 反应色块中心到边缘的距离(5mm色块的一半)
  • 本质上 firstPos 和 step 是倍数关系
  • 计算时基于像素,不是毫米

Q6:白平衡算法

问题:

  • 使用 Whitebalance 还是 WhitebalancePR?
  • 白平衡参考点如何选取?

用户答复:

  • 参考 reference 目录下的代码
  • 白平衡基于整个图片进行

Q7:颜色返回顺序

问题:

  • 小定位块在右边时,是否从右往左编号?

用户答复:

  • 颜色选取顺序始终从靠近小定位块的反应色块开始
  • 无论试纸怎么摆放

Q8:采样区域大小

问题:

  • 5毫米对应多少像素?
  • 是否需要动态计算采样半径?

用户答复:

  • 最少取 25 个像素的均值
  • 可以尝试动态计算半径

Q9:SayHello 返回值格式

问题:

  • 返回值是否完全保持一致?
  • strBuffer 格式?

用户答复:

  • 完全一致,上层代码不改
  • strBuffer 格式:{"id":0,"value":"h,s,v,l,a,b"}

Q10:测试代码运行环境

问题:

  • Windows 独立测试程序?
  • 是否支持命令行参数?

用户答复:

  • Windows 独立命令行程序
  • 告知如何运行测试程序

Q11:误差范围参数

问题:

  • 具体有哪些误差参数?

用户答复:

参数 范围 说明
颜色误差 RGB欧式距离 ≤ 20 判断两个定位块颜色是否相同
面积误差 10% 上下限范围
距离误差 10% 上下限范围
角度误差 15° 倾斜判断
  • 这些参数用全局变量定义,方便调节

Q12:需要支持的试纸规格

问题:

  • 支持哪些规格?

用户答复:

  • 只支持 14联、11联、8联
  • 每种联数支持两种大定位块(10mm 和 15mm)
  • 共 6 种 PaperConfig

Q13:PaperConfig 参数

问题:

  • 其他规格参数如何计算?

用户答复:

  • 参考现有 initPaperConfig 函数
  • 只实现 14、11、8 联的支持代码

四、第三轮需求澄清(2026-03-31)

Q14:图片格式和来源

问题:

  • 是否支持 NV21/YUV 格式?
  • 测试程序是否需要支持 NV21?

用户答复:

  • 不需要支持其他格式
  • 测试只用 PNG/JPG
  • 没有 NV21 测试数据

Q15:ROI 区域

问题:

  • 是否需要从大图自动搜索试纸位置?

用户答复:

  • 输入已经是裁剪好的 ROI
  • 11green_1.png 等文件大小与实际传递的图片差不多
  • 裁剪来源:savePaperImg 函数产生的外包矩形

Q16:白色反应色块的处理

问题:

  • 白平衡后白色色块的 RGB 如何解释?

用户答复:

  • 澄清:反应色块可能颜色很浅,findContours 可能找不到轮廓
  • 核心原则:化学反应色块的位置通过两个定位块计算得出,与反应色块本身的位置无关
  • 计算的位置可能与实际中心点有偏差

Q17:定位块的亮度变化

问题:

  • 深红 vs 浅红如何判断?

用户答复:

  • 深红、浅红都是红色 → R分量 > G、B分量
  • 增加欧式距离判断:
    • 如果两个定位块一个是"深红"、一个是"浅红"
    • 欧式距离可能超过20 → 判定为不符合要求

Q18:颜色输出格式确认

问题:

  • HSV 和 LAB 精度?

用户答复:

  • 保留2位小数点

Q19:还原图片的格式

问题:

  • 图片格式?分辨率?

用户答复:

  • 格式:JPG
  • 分辨率示例(14项红色试纸):
    • 试纸高度:50像素
    • 小定位块:30px宽 × 50px高
    • 反应色块:50px × 50px
    • 大定位块:100px宽
    • 间隔:20像素
    • 总图:200px高 × 1000px宽,试纸居中

五、最终需求确认

5.1 核心业务规则

规则 内容
定位块识别 RGB分量比例判断 + 欧式距离验证(≤20)
试纸规格 仅支持 14联、11联、8联,各有大小定位块两种
颜色顺序 始终从靠近小定位块的色块开始编号
采样方式 以计算的中心点取至少25像素均值
白平衡 基于整图进行

5.2 全局误差参数

// 颜色误差:RGB欧式距离阈值
const double COLOR_DISTANCE_THRESHOLD = 20.0;

// 面积误差:10%
const double AREA_ERROR_RATIO = 0.10;

// 距离误差:10%
const double DISTANCE_ERROR_RATIO = 0.10;

// 角度误差:15度
const double ANGLE_ERROR_DEGREE = 15.0;

5.3 返回值格式

  • 保持与现有 SayHello 完全一致
  • strBuffer JSON格式:{"id":0,"value":"h,s,v,l,a,b"}
  • 颜色值保留2位小数

5.4 测试要求

  • Windows 独立命令行程序
  • 测试图片:images/ 目录下的 PNG/JPG 文件
  • 输出:
    1. 识别成功/失败状态
    2. 标注定位块和色块中心的红圈图片
    3. 颜色值文本文件(HSV、LAB、RGB)
    4. 还原生成的试纸模拟图片(JPG,200×1000像素)

六、沟通结论

需求已完全澄清,双方达成一致意见。

下一步:

  1. AI 编写技术方案文档
  2. 逐步实现代码
  3. 编写测试程序
  4. 验证测试结果

文档结束