VisionPro 中 直方图 CogHistogramTool
- 一、基本概念
- [二、CogHistogramTool 的核心作用](#二、CogHistogramTool 的核心作用)
- 三、特点
- 四、直方图的数据图像特征
- 五、如何使用CogHistogram工具
一、基本概念
CogHistogramTool 是康耐视 VisionPro 中用于分析图像灰度分布的工具。它统计图像区域内每个灰度级（0~255）的像素数量，生成直方图，并计算出平均值、标准差、中值、众数等关键统计量。通过分析这些数据，你可以判断图像的亮度、对比度、均匀性，并为二值化阈值选取、缺陷检测（如异物、划痕）、胶水有无判断等任务提供量化依据。简单说，它把图像的"明暗特征"转化成数据，让你用数值做决策。
简单来说 直方图工具可以 对整张图像或图像中的部分区域的像素分布情况进行统计分析。帮助用户快速了解图像亮度分布情况，进而进行图像增强，图像分割等操作。
直方图是一个统计图，统计图象中不同灰度级的像素个数（或该灰度级出现的频率）的统计图。横坐标是灰度值（灰阶）。纵坐标表示图像中该灰度出现的个数（频率）。
二、CogHistogramTool 的核心作用
统计图像灰度分布，输出量化特征。
输入： 图像 + 可选 ROI (感兴趣区域)
输出： 直方图 + 关键统计量（平均值、标准差、中值、众数、动态范围等）
用途： 为缺陷检测（亮度/均匀性异常）、二值化阈值寻优、胶水有无判断、光照稳定性监控等提供数据决策依据。
三、特点
-
专注统计分析: 不进行空间定位，只输出灰度分布的量化指标（平均值、标准差、中值、众数等）
-
支持 ROI（感兴趣区域）: 可限定矩形、圆、多边形或掩膜区域进行分析，默认全图。
-
直方图可视化: 直观显示 0--255 灰度级的像素分布，便于人工观察和调试。
-
原始数据可编程获取: 通过 GetHistogram() 可拿到 256 个灰度级的计数值，供二次计算使用。
-
轻量、高效: 计算简单，适合作为预处理或判定前的数据提取步骤。
-
易与其他工具协同: 为 CogBlobTool、CogThresholdTool 提供动态阈值；与 CogPMAlignTool 配合实现跟随 ROI 检测。
-
非定位工具: 不输出极值点的坐标，如需定位需配合 CogBlobTool 等。
四、直方图的数据图像特征
在此直方图中，每个峰值均清晰可见。两个主峰之间数量较少的像素值表示特征边缘，改边缘既不是全黑也不是全亮。左右尾巴包含离群点（孤立像素），可能由外部因素引起（如噪声等）。为了避免这种外部因素的影响，可以在图像中直接忽略掉不可靠的左右尾巴。
五、如何使用CogHistogram工具
创建工具
工具介绍
设置参数
显示结果
