imhist

图像数据的直方图

语法

[counts,binLocations] = imhist(I)

[counts,binLocations] = imhist(I,n)

[counts,binLocations] = imhist(X,cmap)

imhist(___)

说明

[counts,binLocations] = imhist(I) 计算灰度图像 I 的直方图。imhist 函数在 counts 中返回直方图计数，在 binLocations 中返回 bin 位置。直方图中 bin 的数量由图像类型确定。

[counts,binLocations] = imhist(I,n) 指定用于计算直方图的 bin 的数量 n。

[counts,binLocations] = imhist(X,cmap) 计算具有颜色图 cmap 的索引图像 X 的直方图。对于颜色图中的每个条目，直方图中都有一个对应的 bin。

imhist(___) 显示绘制的直方图。如果输入图像是索引图像，则直方图在颜色图 cmap 的颜色条上方显示像素值分布。

示例

全部折叠

计算直方图

打开实时脚本

将灰度图像读入工作区。

I = imread('pout.tif');

显示图像的直方图。由于 I 是灰度图像，默认情况下直方图将有 256 个 bin。

imhist(I)

Figure contains 2 axes objects. Axes object 1 contains an object of type stem. Axes object 2 contains 2 objects of type image, line.

显示三维强度图像的直方图

打开实时脚本

加载三维数据集。

load mristack

显示数据的直方图。由于图像是灰度图像，imhist 默认使用 256 个 bin。

imhist(mristack)

Figure contains 2 axes objects. Axes object 1 contains an object of type stem. Axes object 2 contains 2 objects of type image, line.

输入参数

全部折叠

`I` — 灰度图像
数值数组

灰度图像，指定为任意维度的数值数组。imhist 需要数据类型为 double 和 single 的图像的值在 [0, 1] 的范围内。如果 I 的值超出范围 [0, 1]，则可以使用 rescale 函数将值重新缩放到需要的范围。

`n` — bin 的个数
正整数

bin 的个数，指定为正整数。如果 I 是灰度图像，则 imhist 使用默认值，即 256 个 bin。如果 I 是二值图像，则 imhist 使用两个 bin。

示例: 50

`X` — 索引图像
数值数组

索引图像，指定为任意维度的数值数组。

数据类型: single | double | uint8 | uint16 | logical

`cmap` — 颜色图
c×3 数值矩阵

与索引图像 X 相关联的颜色图，指定为由范围 [0, 1] 内的值组成的 c×3 数值矩阵。每行是一个三元素 RGB 三元组，指定颜色图的单个颜色的红、绿和蓝分量。颜色图的长度必须至少等于 X 中最大索引的长度。

数据类型: double

输出参量

全部折叠

`counts` — 直方图计数
数值数组

直方图计数，以数值数组形式返回。如果为索引图像 X 计算直方图，则 counts 的长度与颜色图 cmap 的长度相同。

`binLocations` — bin 位置
数值数组

bin 位置，以数值数组形式返回。

提示

对于灰度图像，直方图的 n 个 bin 中的每个都是宽度为 A/(n−1) 的半开区间。具体来说，pth（第 p 个）bin 是半开区间

$\frac{A (p - 1.5)}{(n - 1)} - B \leq x < \frac{A (p - 0.5)}{(n - 1)} - B,$
其中 x 是强度值。缩放因子 A 和偏移量 B 取决于图像的数据类型，如下所示：

数据类型 A B
double 1 0
single 1 0
int8 255 128
int16 65,535 32,768
int32 4,294,967,295 2,147,483,648
uint8 255 0
uint16 65,535 0
uint32 4,294,967,295 0
logical 1 0
要显示基于 counts 和 binLocations 的直方图，请使用命令 stem(binLocations,counts)。

数据类型	A	B
`double`	`1`	`0`
`single`	`1`	`0`
`int8`	`255`	`128`
`int16`	`65,535`	`32,768`
`int32`	`4,294,967,295`	`2,147,483,648`
`uint8`	`255`	`0`
`uint16`	`65,535`	`0`
`uint32`	`4,294,967,295`	`0`
`logical`	`1`	`0`

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

imhist 支持 C 代码生成（需要 MATLAB^® Coder™）。请注意，如果您选择通用的 MATLAB Host Computer 目标平台，imhist 生成的代码将使用平台特定的预编译共享库。使用共享库可保留性能上的优化，但适用范围仅限于生成的代码所适用的目标平台。有关详细信息，请参阅Image Processing Toolbox 中代码生成支持的类型。
如果第一个输入是二值图像，则 n 在编译时必须是值为 2 的标量常量。
不支持非编程式语法。例如，不支持语法 imhist(I)，其中 imhist 显示直方图。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

用法说明和限制：

如果第一个输入是二值图像，则 n 在编译时必须是值为 2 的标量常量。
不支持非编程式语法。例如，不支持语法 imhist(I)，其中 imhist 显示直方图。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

此函数完全支持基于线程的环境。有关详细信息，请参阅在基于线程的环境中运行 MATLAB 函数。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

用法说明和限制：

imhist 在 GPU 上不支持索引图像。
当在 GPU 上省略输出参量时，imhist 不会显示直方图。在这种情况下，此函数在变量 ans 中返回直方图计数，而不返回直方图 bin 的位置。

有关详细信息，请参阅GPU 上的图像处理。

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 支持基于线程的环境

imhist 现在支持基于线程的环境。

另请参阅

histeq | histogram | stem

imhist

语法

说明

示例

计算直方图

显示三维强度图像的直方图

输入参数

I — 灰度图像 数值数组

n — bin 的个数 正整数

X — 索引图像 数值数组

cmap — 颜色图 c×3 数值矩阵

输出参量

counts — 直方图计数 数值数组

binLocations — bin 位置 数值数组

提示

扩展功能

C/C++ 代码生成 使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成 使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境 使用 MATLAB® backgroundPool 在后台运行代码或使用 Parallel Computing Toolbox™ ThreadPool 加快代码运行速度。

GPU 数组 通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。

版本历史记录

R2022b: 支持基于线程的环境

另请参阅

`I` — 灰度图像
数值数组

`n` — bin 的个数
正整数

`X` — 索引图像
数值数组

`cmap` — 颜色图
c×3 数值矩阵

`counts` — 直方图计数
数值数组

`binLocations` — bin 位置
数值数组

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

GPU 代码生成
使用 GPU Coder™ 为 NVIDIA® GPU 生成 CUDA® 代码。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

GPU 数组
通过使用 Parallel Computing Toolbox™ 在图形处理单元 (GPU) 上运行来加快代码执行。