常见需求与故障排查
约 2456 字大约 8 分钟
7. 常见需求与故障排查
先使用运行与验收中的固定样本建立可复现结果,再按本章处理顺序、节拍或异常问题。每次修改后既要复测问题样本,也要回归正常样本。
7.1 调整有序抓取顺序
7.1.1 按行列或指定顺序处理
- 先确定气缸排列方向与排序坐标轴的对应关系。
- 规则行列可使用通用抓取策略分组和排序;检查分组步长是否把相邻行混为一组,或将同一行拆开。
- 固定来料需要指定位置顺序,且通用策略难以稳定实现时,可评估自定义抓取策略。
- 使用缺料、边缘偏移和不同排列样本验证,不只检查满料状态。
- 检查抓取点阶段是否又配置了排序,避免最终输出顺序与实例顺序不一致。
自定义策略的坐标系和组合限制参见实例排序配置指南,输出点排序参见抓取点排序配置指南。
7.1.2 不允许跳过失败位置
工艺要求严格按顺序处理时,可评估 位姿计算异常报警。开启后,按实例排序顺序计算姿态,3D 姿态估计失败时报警;关闭时可能跳过当前实例并继续计算后续实例。
该选项针对姿态计算失败,不能替代对“模型完全没有识别到某个位置”的检查。若工艺要求每个位置都必须存在并处理,应结合实际任务逻辑验证缺料和漏识别时的响应。
配置参见视觉计算配置功能使用指南。
7.2 使用拍一抓多
气缸位置在连续取料期间保持不变、前一次抓取不会扰动剩余工件时,可评估拍一抓多:
- 先完成拍一抓一的识别和联动验收。
- 在视觉计算配置中设置需要的 位姿计算个数 和 发送实例个数,再启用拍一抓多。
- 核对机器人后续请求与视觉缓存结果的交互逻辑。
- 连续取料时确认剩余气缸没有位移、倾斜或被夹具带动。
- 补料、换盘、人工干预或工件移动后,按通信协议清除旧结果并重新采集。
缓存结果适用条件
缓存中的抓取坐标对应拍照时的场景。若取走一个气缸会导致相邻气缸移动,不能未经验证直接连续使用旧坐标。拍一抓多也不等于每次发送全部实例。
配置与缓存交互分别参见视觉计算配置功能使用指南和机器人配置指南。
7.3 优化视觉节拍
以实际日志耗时定位瓶颈,不预设所有场景都由同一个阶段主导。
| 耗时位置 | 优先检查 | 同时验证 |
|---|---|---|
| 图像与实例识别 | ROI 是否过大,自动增强是否包含无效组合 | 边缘和允许来料变化不漏检 |
| 点云与姿态计算 | 是否处理过多无效实例,模板点数及精匹配模式是否合适 | 有效特征、匹配精度和方向不退化 |
| 抓取点处理 | 候选抓取点数量,碰撞模型复杂度 | 可用抓取方式和碰撞判断不缺失 |
| 数据保存 | 是否一直保存全部调试数据 | 异常追溯所需信息仍能获得 |
基础流程通过验收后,可评估 只保存原始图像(极速模式) 或按需保存,减少数据写入开销。不能为了节拍直接关闭必要的角度、区域或碰撞过滤。
模板降采样参见点云模板制作指南,数据保存与计算数量参见视觉计算配置功能使用指南。
7.4 按处理阶段排查异常
7.4.1 未检测到实例或漏识别
- 确认当前工件、视觉模型和来料形式正确。
- 查看原始图像,检查成像、反光和目标是否位于 ROI 2D/3D 内。
- 比较预处理前后图像,确认没有裁掉气缸边缘或方向特征。
- 在固定样本上逐步调整缩放比例及置信度下限阈值,同时统计误识别。
- 单一参数不能覆盖正常变化时,再评估自动增强。
- 仍不稳定时整理获准的代表性样本,评估模型迭代,不长期依赖过低阈值。
7.4.2 检测到实例但没有姿态
- 检查实例是否合并、截断或误包含背景。
- 检查生成的点云是否完整,3D 预处理是否过滤过度。
- 核对网格、关键点、视觉模型和模板是否配套。
- 查看日志,区分关键点粗匹配失败和点云精匹配失败。
- 粗匹配失败先检查关键点和模型;精匹配失败先检查模板可见面、对齐关系及有效点对,再调整相关参数。
7.4.3 姿态有结果但偏移、翻转或抖动
- 固定偏移:先检查尺寸单位、模板坐标基准与抓取点位置,再区分视觉侧和机器人侧问题。
- 正反面或端部翻转:检查关键点、模板对应面及有效方向特征,不能只根据匹配分数判定正确。
- 重复采集抖动:比较原始点云质量、反光和遮挡变化,以及精匹配是否被邻件或背景吸引。
- 只有机器人位置异常:检查标定、TCP、坐标系、单位和旋转表达,不先用视觉抓取点偏移补偿。
旋转对称工件确有轴向歧义时,可按通用姿态估计配置指南评估轴旋转姿态调整,并遵守其功能组合限制;不是所有气缸都需要启用。
7.4.4 姿态正确但没有抓取点输出
- 确认工件中已手动添加抓取点,并保存到当前所选工件。
- 查看各项过滤前后的结果数量,定位首先排除抓取点的函数。
- 分别检查匹配分数、角度轴向与正负方向、ROI 工作区或抓取区边界。
- 有碰撞过滤时检查夹具模型坐标与尺寸,不以关闭检测代替原因分析。
- 检查位姿计算数量、发送数量及抓取逻辑是否限制了本次输出。
参见抓取点过滤函数配置指南。
7.4.5 下层或受遮挡气缸被优先输出
- 先确认上层目标是否漏识别,不能只改排序。
- 核对高度排序所用坐标系、轴向和分组步长。
- 检查上层是否姿态计算失败后被跳过。
- 结合工艺配置遮挡过滤及异常报警,用上层未移除的样本验证。
- 只有可抓取目标被保留,且失败响应符合要求后,再恢复机器人联动。
不将其他工件案例中针对隔层纸压痕或中心孔的专用过滤方法直接套用到气缸。应依据实际几何特征和已支持的函数判断。
7.5 问题复现与资料检查
需要进一步分析时,整理软件版本、问题描述、通用样本编号、配置版本、对应历史数据及运行日志,并说明期望结果和实际结果。
分享前检查正文、文件名、压缩包目录和截图:去除或替换客户名称、项目代号、人员及联系方式、内部地址、账号凭据、设备标识和二维码等敏感信息。包含真实工件模型或现场图像的附件,还应确认其分享范围和用途;不作为本公开案例的默认下载资料。