7.9 KiB
7.9 KiB
鸿蒙算法改造 - 需求沟通日志
文档创建时间:2026-03-31 参与方:用户 & AI助手
一、项目背景
1.1 项目概述
- 项目名称:鸿蒙尿检试纸识别算法改造
- 改造范围:仅限于
E:\Qoder\urologist\entry\src\main\cpp目录下的 C++ 代码 - 技术栈:C++ + OpenCV,通过 N-API 与鸿蒙上层交互
1.2 核心功能
- 从上层 NAPI 接收图片
- 试纸定位:根据定位块特征找到定位块,匹配 PaperConfig 规格
- 获取反应色块的中心点位置列表
- 读取每个化学反应色块的颜色值(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 文件 - 输出:
- 识别成功/失败状态
- 标注定位块和色块中心的红圈图片
- 颜色值文本文件(HSV、LAB、RGB)
- 还原生成的试纸模拟图片(JPG,200×1000像素)
六、沟通结论
需求已完全澄清,双方达成一致意见。
下一步:
- AI 编写技术方案文档
- 逐步实现代码
- 编写测试程序
- 验证测试结果
文档结束