302 lines
7.9 KiB
Markdown
302 lines
7.9 KiB
Markdown
# 鸿蒙算法改造 - 需求沟通日志
|
||
|
||
> 文档创建时间: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 全局误差参数
|
||
|
||
```cpp
|
||
// 颜色误差: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. 验证测试结果
|
||
|
||
---
|
||
|
||
*文档结束*
|