OpenCV-Python直方图计算calcHist函数详解

关注

原创最新推荐文章于 2026-09-06 18:51:28 发布 3.3k 阅读 AI 写同款· GEO 优化 ›

OpenCV之直方图绘制（calcHist函数详解）目录1.直方图的定义2.calcHist()函数说明3.绘制直方图3.1 读取原图像并检查图像是否读取成功3.2 定义直方图参数并计算直方图3.3 绘制直方图4.关于BGR直方图的绘制4.1 读取原图像并检查图像是否读取成功4.2 分通道显示4.3 分B，G，R计算直方图4.4 绘制直方图 1.直方图的定义要理解直方图，绕不开“亮度”这个概念。人们把亮度分为0到255共256个数值，数值越大，代表的亮度越高。其中0代表纯黑色的最暗区域，255表示最亮的纯白色，而中间的数字就是不同亮度的灰色。人们还进一步把阅读详情

☞ ░ 前往老猿Python博文目录 https://blog.youkuaiyun.com/LaoYuanPython ░

一、引言

在《《数字图像处理》第三章学习总结感悟2：直方图处理： https://blog.youkuaiyun.com/LaoYuanPython/article/details/119856466》相关的文章中介绍了直方图均衡、直方图匹配、局部直方图处理、基于直方图统计信息进行图像增强处理等图像处理与直方图相关的内容，由此可见直方图在OpenCV中大有用途，因此OpenCV中也提供了直方图计算的函数calcHist，这个函数在网上介绍的很多，不过都是基于C语言的，对OpenCV-Python版本介绍得不多，本文就该函数OpenCV-Python版本详细说明一下。

二、OpenCV图像直方图的计算

在OpenCV中，图像的直方图计算使用函数calcHist，在C语言中，该函数有多种重载形式，参数也比较多，而在Python中则不一样。

下面是C++版本的calcHist一个重载函数：

void cv::calcHist	(	const Mat * 	images,
int 	nimages,
const int * 	channels,
InputArray 	mask,
OutputArray 	hist,
int 	dims,
const int * 	histSize,
const float ** 	ranges,
bool 	uniform = true,
bool 	accumulate = false 
)

相关介绍网上到处都是，在此就不展开说，而OpenCV-Python关于该函数的资料却很少见，有的也基本是官方文档的简单翻译，下面就calcHist的Python版本介绍一下。

Python中因为不支持函数的多态形式，因此只有一个函数，其定义如下：

hist	=	cv2.calcHist(images, channels, mask, histSize, ranges[, hist[, accumulate]])

这些参数说明如下：

images：输入图像的列表，如果有多幅图像，则是列表的多个元素，但根据老猿测试，4.3的版本虽然允许输入多个图像，但处理时只处理一幅图像才能正常处理
channels：需要处理通道的列表，需要统计的通道索引：维度通道序列，第一幅图像的通道标号从0~image[0].channels( )-1。Image[0]表示图像数组中的第一幅图像，channels()表示该图像的通道数量。同理，图像阵列中的第二幅图像，通道标号从image[0].channerls( )开始，到image[0].channerls+image[1].channels( )-1为止；第三、四幅图像的通道标号顺序依此类推；也就是说图像阵列中的所有图像的通道根据图像排列顺序，排成一个通道队列，根据老猿测试，这个多通道支持也基本不可用
mask：图像掩膜，是和图像大小相同的8bit灰度图像矩阵，如果只计算输入图像部分区域的直方图时，可通过掩膜来设置参与计算的有效区域（掩膜有效区域的像素值非0）
histSize：每个图像维度参与直方图计算的直方图组数
ranges：为一个列表，表示参与直方图计算的每个维度的数值范围，即横坐标的最小值和最大值，注意最小值是参与计算的最小值，最大值本身不参与计算，即这个最小值和最大值构成的区间是个半闭半开区间，如要求灰度图的所有像素值都参与计算，则值为[0,256]，如果要求计算灰度值在100-250的像素值，则应该设置为[100,251]，如果是多个维度，则每个维度的计算范围最小、最大值分别追加到列表中，如有2个维度，都是0到256，则表示为：[0,256,0,256]
hist：可选输出结果直方图阵列
accumulate：是否累积计算标记，如果设置为True，则直方图在计算时不会将结果清除，此功能能够从多组图像中叠加计算出一个直方图，经老猿验证，OpenCV4.3-Python中好像不起作用

可以看到相比C++版本，python版本变化如下：

参数少了nimages，因为images就是一个列表，无需再传图像数量
参数少了dims，因为数字图像一般就一个物理量-灰度，因此在Python中dims默认为1，不能传值
参数少了uniform，这表示是否为均匀直方图，Python中强制为均匀直方图
range参数比C++用法中少了非均匀直方图的表示法

三、直方图计算简单案例

下面构造一个简单的图像数组，来进行直方图的计算，看看计算出来的直方图数据：

import cv2
def test():
    img = np.array([[[1,2,3],[1,2,3],[1,2,3]],[[4,5,6],[4,5,6],[4,5,6]],[[7,8,9],[7,8,9],[7,8,9]]],dtype=np.uint8)
    B, G, R = cv2.split(img)
    hb = cv2.calcHist([B], [0], None, [9], [1,10],accumulate=True)
    hg = cv2.calcHist([G], [0], None, [9], [3, 8],accumulate=True)
    hr = cv2.calcHist([R], [0], None, [9], [1, 5], accumulate=True)
    print("蓝色通道的直方图矩阵如下：")
    print(hb.shape,hb.reshape(hb.shape[0]))
    print("绿色通道的直方图矩阵如下：")
    print(hg.shape, hg.reshape(hg.shape[0]))
    print("红色通道的直方图矩阵如下：")
    print(hr.shape, hr.reshape(hr.shape[0]))
    
test()

上段程序首先构建了3*3的BGR格式的图像矩阵，像素值每个通道由1-9中的数字构成。使用cv2.split做了各像素的三通道拆分，拆分后三通道的像素值如下：
B通道：
在这里插入图片描述
G通道：

R通道：

然后分别计算三个通道的直方图数据，注意B通道指定的范围是[1,10]，G是[3,8]，R是[1,5]，三者中绿色通道指定组数是6，其他2个通道指定的组数是9。我们来看看最终输出结果：

蓝色通道的直方图矩阵如下：
(9, 1) [3. 0. 0. 3. 0. 0. 3. 0. 0.]
绿色通道的直方图矩阵如下：
(6, 1) [0. 0. 3. 0. 0. 0.]
红色通道的直方图矩阵如下：
(9, 1) [0. 0. 0. 0. 3. 0. 0. 0. 0.]

可以看到直方图的矩阵是一个组数×1的二阶数组。

蓝色通道中1、 4、 7三个数字各自出现了三次，组设设置ranges设置为【1-10】，组数设置为9，由于上限10不参与计算，因此一个数字就是一个组，1、 4、 7三个数字分别在0组、3组和6组，因此直方图数组展开后的最终结果是[3. 0. 0. 3. 0. 0. 3. 0. 0.]。

绿色通道中2、 5、 8三个数字各自出现了三次，组设设置ranges设置为【3-8】，组数设置为6，由于上限8不参与计算，实际参与直方图计算的数字是3、4、5、6、7共5个，因此2、 5、 8三个数字实际上只有5能纳入直方图统计中，分为6组后，每组的宽度为(8-3)/6=0.833，5在第3组（组号2），因此数组展开后的最终结果是[0. 0. 3. 0. 0. 0.]。

类似地，红色通道中3、 6、 9三个数字各自出现了三次，组设设置ranges设置为【1-5】，组数设置为9，由于上限5不参与计算，实际参与直方图计算的数字是1、2、3、4共5个，因此3、 6、 9三个数字实际上只有3能纳入直方图统计中，分为9组后，每组的宽度为(5-1)/9=0.444，3在第5组（组号4），因此数组展开后的最终结果是[0. 0. 0. 0. 3. 0. 0. 0. 0.]。

**从上面的结果可以看到，参数accumulate=True没有起到作用。**不知道老猿的测试方法是否存在问题。