bwlabel

对二维二值图像中的连通分量进行标注

全页折叠

语法

L = bwlabel(BW)

L = bwlabel(BW,conn)

[L,n] = bwlabel(___)

说明

示例

L = bwlabel(BW) 返回标签矩阵 L，其中包含在 BW 中找到的 8 连通对象的标签。

L = bwlabel(BW,conn) 返回标签矩阵，其中 conn 指定连通性。

[L,n] = bwlabel(___) 还返回 n，即在 BW 中找到的连通对象的数量。

示例

全部折叠

使用 4 连通对象对分量进行标注

打开实时脚本

创建小二值图像。

BW = logical ([1     1     1     0     0     0     0     0
               1     1     1     0     1     1     0     0
               1     1     1     0     1     1     0     0
               1     1     1     0     0     0     1     0
               1     1     1     0     0     0     1     0
               1     1     1     0     0     0     1     0
               1     1     1     0     0     1     1     0
               1     1     1     0     0     0     0     0]);

使用 4 连通对象创建标签矩阵。

L = bwlabel(BW,4)

L = 8×8

     1     1     1     0     0     0     0     0
     1     1     1     0     2     2     0     0
     1     1     1     0     2     2     0     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     0     3     0
     1     1     1     0     0     3     3     0
     1     1     1     0     0     0     0     0

使用 find 命令获取标签为“2”的对象的行和列坐标。

[r, c] = find(L==2);
rc = [r c]

输入参数

全部折叠

`BW` — 二值图像
二维数值矩阵 | 二维逻辑矩阵

二值图像，指定为二维数值矩阵或二维逻辑矩阵。对于数值输入，任何非零像素都被视为 1 (true)。

`conn` — 像素连通性
`8` (默认) | `4`

像素连通性，指定为下列值之一。

值	意义
二维连通
`4`	如果像素的边缘相互接触，则这些像素具有连通性。如果两个相邻像素都为 on 并在水平或垂直方向上连通，则它们是同一对象的一部分。	当前像素以灰色显示。
`8`	如果像素的边缘或角相互接触，则这些像素具有连通性。如果两个相邻像素都为 on 并在水平、垂直或对角线方向上连通，则它们是同一对象的一部分。	当前像素以灰色显示。

值

意义

二维连通

4

如果像素的边缘相互接触，则这些像素具有连通性。如果两个相邻像素都为 on 并在水平或垂直方向上连通，则它们是同一对象的一部分。

Center pixel connected to four pixels

当前像素以灰色显示。

8

如果像素的边缘或角相互接触，则这些像素具有连通性。如果两个相邻像素都为 on 并在水平、垂直或对角线方向上连通，则它们是同一对象的一部分。

Center pixel connected to eight pixels

当前像素以灰色显示。

数据类型: double | logical

输出参量

全部折叠

`L` — 标签矩阵
由非负整数组成的矩阵

由连续区域组成的标签矩阵，以与 BW 大小相同的非负整数矩阵形式返回。标签为 0 的像素构成背景。标签为 1 的像素构成一个对象；标签为 2 的像素构成另一个对象；等等。

数据类型: double

`n` — 连通对象的数量
非负整数

BW 中连通对象的数量，以非负整数形式返回。

数据类型: double

提示

此函数根据每个分量的 top-left 极值从左到右对连通分量进行排序。当多个分量具有相同的水平位置时，该函数将从上到下对这些分量进行排序。下图显示了两个不同区域的极值。
函数 bwlabel、bwlabeln 和 bwconncomp 都计算二值图像的连通分量。bwconncomp 使用的内存少得多，有时运行速度比其他函数更快。
输入维度输出格式内存使用量连通性
bwlabel 二维双精度标签矩阵高 4 或 8
bwlabeln N 维双精度标签矩阵高任何
bwconncomp N 维 CC 结构体低任何
您可以结合 bwlabel 使用 MATLAB^® find 函数，返回构成特定对象的像素的索引向量。例如，要返回对象 2 中像素的坐标，请输入以下内容：
```
[r,c] = find(bwlabel(BW)==2)
```
您可以将输出矩阵显示为伪颜色索引图像。每个对象以不同颜色显示，因此这些对象比在原始图像中更容易区分。有关详细信息，请参阅 label2rgb。
要使用具有默认连通的 regionprops 从二值图像中提取特征，请使用命令 regionprops(BW) 将 BW 直接传入 regionprops。
bwlabel 函数可以对数据类型 logical、uint8 和 single 利用硬件优化来加快运行速度。硬件优化要求 marker 和 mask 为二维图像，conn 为 4 或 8。

	输入维度	输出格式	内存使用量	连通性
`bwlabel`	二维	双精度标签矩阵	高	4 或 8
`bwlabeln`	N 维	双精度标签矩阵	高	任何
`bwconncomp`	N 维	CC 结构体	低	任何

算法

bwlabel 使用参考文献 [1]（第 40-48 页）中概述的通用过程：

对输入图像进行行程长度编码。
扫描各次运行，从而分配初步标签并在本地等效表中记录标签等效性。
解析等效类。
基于解析的等效类重新对各次运行进行标注。

参考

[1] Haralick, Robert M., and Linda G. Shapiro, Computer and Robot Vision, Volume I, Addison-Wesley, 1992, pp. 28-48.

扩展功能

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

用法说明和限制：

bwlabel 支持 C 代码生成（需要 MATLAB Coder™）。有关详细信息，请参阅图像处理的代码生成。
生成代码时，参数 n 必须为编译时常量。

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

用法说明和限制：

生成代码时，参数 n 必须为编译时常量。

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

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

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

此函数完全支持 GPU 数组。有关详细信息，请参阅GPU 上的图像处理。

版本历史记录

在 R2006a 之前推出

全部展开

R2022b: 支持基于线程的环境

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

R2006a: 不推荐

从 R2022b 开始，大多数 Image Processing Toolbox™ 函数都使用前乘约定来创建和执行几何变换。因此，不推荐使用 affine2d 对象，因为它使用后乘约定。虽然当前没有删除 affine2d 对象的计划，但您可以通过切换到支持前乘约定的 affinetform2d 对象来简化几何变换工作流。有关详细信息，请参阅Migrate Geometric Transformations to Premultiply Convention。

要更新您的代码，请执行以下操作：

将函数名称 affine2d 的实例更改为 affinetform2d。
将变换矩阵指定为矩阵 T 的转置矩阵，其中 T 是 affine2d 对象的 T 属性的值，或用于创建 affine2d 对象的变换矩阵。

不推荐使用推荐的替代项

不推荐使用	推荐的替代项
此示例基于后乘约定中的变换矩阵 `T` 创建一个 `affine2d` 对象。 T = [2 0.33 0; 0 1 0; 0 0 1]; tformPost = affine2d(T);	此示例基于变换矩阵 `T` 的转置创建一个 `affinetform2d` 对象。 T = [2 0.33 0; 0 1 0; 0 0 1]; tform = affinetform2d(T'); 此示例从名为 `tformPost` 的 `affine2d` 对象开始，并基于 `tformPost` 的 `T` 属性的转置创建一个 `affinetform2d` 对象。 T = tformPost.T; tform = affinetform2d(T');

此示例基于后乘约定中的变换矩阵 T 创建一个 affine2d 对象。

T = [2 0.33 0; 0 1 0; 0 0 1];
tformPost = affine2d(T);

此示例基于变换矩阵 T 的转置创建一个 affinetform2d 对象。

T = [2 0.33 0; 0 1 0; 0 0 1];
tform = affinetform2d(T');

此示例从名为 tformPost 的 affine2d 对象开始，并基于 tformPost 的 T 属性的转置创建一个 affinetform2d 对象。

T = tformPost.T;
tform = affinetform2d(T');

另请参阅

bwlabel

语法

说明

示例

使用 4 连通对象对分量进行标注

输入参数

BW — 二值图像 二维数值矩阵 | 二维逻辑矩阵

conn — 像素连通性 8 (默认) | 4

输出参量

L — 标签矩阵 由非负整数组成的矩阵

n — 连通对象的数量 非负整数

提示

算法

参考

扩展功能

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

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

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

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

版本历史记录

R2022b: 支持基于线程的环境

R2006a: 不推荐

另请参阅

WeChat

`BW` — 二值图像
二维数值矩阵 | 二维逻辑矩阵

`conn` — 像素连通性
`8` (默认) | `4`

`L` — 标签矩阵
由非负整数组成的矩阵

`n` — 连通对象的数量
非负整数

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

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

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

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