EagleEye入门必看:如何导出检测结果CSV/Excel用于后续BI分析与统计
1. 为什么你需要导出检测结果?
你刚在EagleEye里跑完一张工厂巡检图,屏幕上跳出了5个红色检测框,标注着“螺丝松动”“安全帽缺失”“设备过热”——很酷,但接下来呢?
如果只是看一眼就关掉页面,这些数据就永远留在了Streamlit界面上,没法进你的Power BI做趋势分析,没法和MES系统对接生成工单,更没法汇总成月度质量报告发给管理层。
EagleEye不是个“看完了就结束”的演示工具,而是一个可嵌入生产流程的数据节点。它的真正价值,藏在那些被框出来的目标背后:每个检测框对应一条结构化记录——类别、坐标、置信度、时间戳、图片ID。把这些记录导出来,你就能:
- 在Excel里用透视表统计“本周各产线缺陷类型TOP3”
- 把CSV导入Tableau,画出“误报率随灵敏度滑块变化的散点图”
- 用Python脚本自动清洗后,推送到企业微信机器人,每天早8点推送前日异常摘要
- 和历史数据库比对,识别某类缺陷是否在特定班次集中出现
本文不讲模型原理,不调超参,只聚焦一个工程师最常卡住的动作:怎么把屏幕上看到的检测结果,变成能放进BI工具里的干净表格?全程实操,零命令行恐惧,连Excel都不会用的新手也能照着点完。
2. 导出功能在哪?三步定位核心按钮
别翻菜单栏,也别找设置图标——EagleEye把导出入口设计得像开关一样直白。请按顺序操作:
2.1 确保你已完成一次有效检测
上传一张JPG或PNG图片(建议分辨率1920×1080以上),等待右侧面板出现带红框的结果图。如果右侧面板还是空白或显示“等待上传”,请先完成这一步。
2.2 找到右上角的「导出」图标
在结果图的右上角,紧挨着放大镜和下载箭头⬇的位置,你会看到一个带表格图标的蓝色按钮(图标为三列竖线+向下箭头)。它不会标“Export”,但视觉上非常突出——这是EagleEye唯一导出入口,没有二级菜单,没有隐藏选项。
注意:这个按钮是动态启用的。只有当检测完成且至少识别出1个目标时,按钮才从灰色变为可点击的蓝色。如果按钮不可点,请检查图片是否清晰、目标是否在画面中央区域。
2.3 点击后弹出格式选择面板
点击蓝色按钮,立刻弹出一个轻量级浮层,仅含两个选项:
- Download as CSV(默认选中)
- 📄Download as Excel (.xlsx)
无需填写路径,不用选择文件夹——点击任一选项,浏览器会直接触发下载,文件自动保存到你的默认下载目录(通常是“下载”文件夹)。
3. 导出的文件长什么样?字段详解与真实示例
下载完成后的文件,不是乱码,不是压缩包,而是开箱即用的标准表格。我们以一张检测出3个目标的工厂巡检图为例,展示CSV文件的实际内容(Excel文件结构完全一致,只是扩展名不同):
image_id,timestamp,category,x_min,y_min,x_max,y_max,confidence,area_px IMG_20240521_091522.jpg,2024-05-21 09:15:22.347,safety_helmet,124.8,89.2,215.6,187.4,0.92,9245.6 IMG_20240521_091522.jpg,2024-05-21 09:15:22.347,loose_bolt,412.3,305.1,458.7,332.9,0.87,1248.3 IMG_20240521_091522.jpg,2024-05-21 09:15:22.347,overheat_warning,876.5,521.8,942.1,589.3,0.79,4321.73.1 字段逐个说人话
| 字段名 | 实际含义 | 你能怎么用 |
|---|---|---|
image_id | 你上传的原始图片文件名 | 作为关联键,和你的资产管理系统照片ID匹配;批量处理时可按文件名分组统计 |
timestamp | 检测发生的精确时间(毫秒级) | 做时间序列分析,比如“每小时缺陷数折线图”;排查问题时快速定位事发时刻 |
category | 检测出的目标类别(如safety_helmet) | 分类汇总,生成饼图;设置规则引擎,如“连续3次safety_helmet=0则告警” |
x_min/y_min/x_max/y_max | 检测框左上角和右下角坐标(像素值) | 计算目标在画面中的位置占比(如x_min/width),判断是否偏离中心区;结合多张图做轨迹追踪 |
confidence | 置信度(0~1小数) | 设置过滤条件,如“只分析confidence>0.85的高可信结果”;分析模型在不同场景下的稳定性 |
area_px | 检测框面积(像素平方) | 判断目标大小,辅助分类(大区域过热 vs 小点状火花);排除因噪点产生的微小误报 |
3.2 一个真实工作流:10分钟做出缺陷日报
假设你是产线质量员,每天要交一份《A区装配线缺陷日报》:
- 早上8点,把昨天200张巡检图拖进EagleEye,批量检测(支持多图连续上传)
- 每张图点一下右上角导出按钮,全部保存为CSV(命名规则:
A区_20240520_001.csv…A区_20240520_200.csv) - 打开Excel → 数据 → 从文件夹获取数据 → 选择存放所有CSV的文件夹 → 自动生成合并查询
- 在Power Query编辑器里:筛选
category="loose_bolt"+confidence>0.7→ 按timestamp分组计数 → 导出到工作表 - 插入柱状图,标题自动变成:“A区5月20日松动螺栓分布(高置信度)”
整个过程,不需要写一行代码,不安装额外软件,全在Excel界面内完成。
4. 进阶技巧:让导出数据更好用
导出功能本身很简单,但搭配几个小操作,能让数据价值翻倍:
4.1 调整灵敏度后再导出,得到不同颗粒度的结果
你在侧边栏拖动“Confidence Threshold”滑块时,右侧面板的检测框会实时增减——导出的CSV内容也会同步变化。这意味着:
- 滑块拉到0.3:导出文件包含所有微弱信号,适合做模型效果诊断(查漏)
- 滑块拉到0.7:导出文件只保留强信号,适合做管理报表(防误报)
- 滑块拉到0.5:导出文件作为基准数据集,用于训练内部质检员
实操建议:同一张图,分别用0.3/0.5/0.7三个阈值导出三份CSV,用Excel的“条件格式→突出显示单元格规则→重复值”,一眼看出哪些目标在所有阈值下都稳定存在——这些就是最值得优先处理的真问题。
4.2 批量导出时的命名智慧
EagleEye默认导出文件名为detection_results.csv,如果你处理100张图,就会得到100个同名文件,覆盖风险极高。解决方法:
- 上传前重命名图片:把
IMG_1234.jpg改成A区_流水线1_20240521_0830.jpg,导出的CSV里image_id字段就自带业务上下文 - 用Excel快速重命名:导出后,在Excel里插入一列,用公式
=SUBSTITUTE(A2,"IMG","A区_流水线1")批量生成新文件名,再用Power Automate一键重命名
4.3 用Python三行代码自动合并(给想省事的工程师)
如果你习惯用代码处理,以下脚本可将当前文件夹下所有EagleEye导出的CSV合并为一个总表(已测试通过):
import pandas as pd import glob # 自动查找所有CSV文件 all_files = glob.glob("*.csv") # 逐个读取并合并 df_list = [pd.read_csv(f) for f in all_files] merged_df = pd.concat(df_list, ignore_index=True) # 保存为新文件 merged_df.to_excel("eagleeye_all_results.xlsx", index=False) print(f"已合并{len(all_files)}个文件,共{len(merged_df)}条检测记录")把这段代码存为merge_eagleeye.py,和CSV文件放在同一文件夹,双击运行即可。不需要安装任何库(pandas和glob是Python标准库)。
5. 常见问题与避坑指南
导出功能虽简单,但新手常因几个细节卡住。以下是高频问题的真实解法:
5.1 “导出按钮是灰色的,点不了!”
原因:检测未完成或未识别出目标。
验证方法:看右侧面板是否显示“Processing…”或“0 objects detected”。
解决:换一张更清晰的图(避免逆光、模糊),或把侧边栏灵敏度滑块往左拉(降低阈值),再试一次。
5.2 “导出的CSV打开是乱码,中文全变问号!”
原因:Excel默认用ANSI编码打开UTF-8文件。
解决:
- 方法1(推荐):用WPS或Google Sheets打开,自动识别UTF-8
- 方法2:在Excel里,“数据”→“从文本/CSV”→选择文件→在导入向导中,将“文件原始格式”改为“65001: Unicode (UTF-8)”
5.3 “坐标数值是小数,但Excel里显示成日期了!”
原因:Excel自动把类似124.8的数字识别为日期格式(如124年8月)。
解决:选中整列 → 右键“设置单元格格式” → 选择“数值” → 小数位数设为1。
5.4 “area_px字段数值很大,但和实际面积对不上?”
说明:area_px是像素面积((x_max-x_min)*(y_max-y_min)),不是物理面积。它用于相对比较(如“这张图里最大的目标是哪个”),而非绝对测量。如需物理尺寸,需在部署时标定相机参数,EagleEye暂不提供此功能。
6. 总结:导出不是终点,而是分析的起点
EagleEye的导出功能,本质是一个数据管道的出口阀门。它不炫技,不堆砌参数,就用一个蓝色按钮,把毫秒级检测产生的结构化数据,稳稳地交到你的手上。
你不需要理解TinyNAS如何搜索网络结构,也不用关心RTX 4090显存里发生了什么——只要记住三件事:
- 按钮位置:结果图右上角,带表格图标的蓝色按钮
- 文件内容:7个开箱即用的字段,每一列都对应一个可分析的业务维度
- 使用逻辑:导出 → 导入BI工具 → 设置筛选条件 → 生成图表 → 驱动决策
当你的第一份用EagleEye数据做的缺陷分布图出现在周会上,当生产主管指着图表问“为什么B区过热告警集中在下午2点?”,你就真正跨过了从“看到AI”到“用好AI”的那道门槛。
下一步,试试把导出的CSV拖进Power BI,用“地图视觉对象”把image_id里的产线编号映射到厂区平面图上——让缺陷在空间里动起来。
获取更多AI镜像
想探索更多AI镜像和应用场景?访问 CSDN星图镜像广场,提供丰富的预置镜像,覆盖大模型推理、图像生成、视频生成、模型微调等多个领域,支持一键部署。