bwconncomp

查找二值图像中的连通分量并对其计数

语法

CC = bwconncomp(BW)

CC = bwconncomp(BW,conn)

说明

CC = bwconncomp(BW) 查找二值图像 BW 中的连通分量 CC 并对其计数。CC 输出结构体包含图像中连通分量（如感兴趣区域 (ROI)）的总数，以及分配给每个分量的像素索引。bwconncomp 对二维图像使用默认 8 连通，对三维图像使用默认 26 连通。

示例

CC = bwconncomp(BW,conn) 为连通分量指定所需的 conn 连通。

示例

全部折叠

计算三维对象的质心

打开实时脚本

创建小型三维数组示例。

BW = cat(3, [1 1 0; 0 0 0; 1 0 0],...
            [0 1 0; 0 0 0; 0 1 0],...
            [0 1 1; 0 0 0; 0 0 1]);

查找数组中的连通分量。

CC = bwconncomp(BW)

CC = struct with fields:
    Connectivity: 26
       ImageSize: [3 3 3]
      NumObjects: 2
    PixelIdxList: {[5x1 double]  [3x1 double]}

计算数组中对象的质心。

S = regionprops(CC,'Centroid')

S=2×1 struct array with fields:
    Centroid

从图像中擦除最大分量

打开实时脚本

将图像读入工作区并显示它。

BW = imread('text.png');
imshow(BW)

Figure contains an axes object. The axes object contains an object of type image.

查找图像中连通分量的数量。

CC = bwconncomp(BW)

CC = struct with fields:
    Connectivity: 8
       ImageSize: [256 256]
      NumObjects: 88
    PixelIdxList: {1x88 cell}

确定图像中的最大分量并将其擦除（将所有像素设置为 0）。

numPixels = cellfun(@numel,CC.PixelIdxList);
[biggest,idx] = max(numPixels);
BW(CC.PixelIdxList{idx}) = 0;

显示图像，注意最大分量正好是单词 differen 中两个连续的 f。

figure
imshow(BW)

Figure contains an axes object. The axes object contains an object of type image.

输入参数

全部折叠

`BW` — 二值图像
数值数组 | 逻辑数组

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

示例： BW = imread("text.png");

`conn` — 像素连通性
`4` | `8` | `6` | `18` | `26` | 由 `0` 和 `1` 组成的 3×3×...×3 数组

像素连通性，指定为下表中的值之一。对于二维图像，默认连通性是 8，对于三维图像，默认连通性是 26。

值	意义
二维连通
`4`	如果像素的边缘相互接触，则这些像素具有连通性。如果两个相邻像素都为 on 并在水平或垂直方向上连通，则它们是同一对象的一部分。	当前像素以灰色显示。
`8`	如果像素的边缘或角相互接触，则这些像素具有连通性。如果两个相邻像素都为 on 并在水平、垂直或对角线方向上连通，则它们是同一对象的一部分。	当前像素以灰色显示。
三维连通
`6`	如果像素的面接触，则这些像素具有连通性。如果两个相邻像素都为 on 并以如下方式连通，则它们是同一对象的一部分：在所列方向之一上连通：内、外、左、右、上、下	当前像素是立方体的中心。
`18`	如果像素的面或边缘接触，则这些像素具有连通性。如果两个相邻像素都为 on 并以如下方式连通，则它们是同一对象的一部分：在所列方向之一上连通：内、外、左、右、上、下在两个方向的组合上连通，如右下或内上	当前像素是立方体的中心。
`26`	如果像素的面、边缘或角接触，则这些像素具有连通性。如果两个相邻像素都为 on 并以如下方式连通，则它们是同一对象的一部分：在所列方向之一上连通：内、外、左、右、上、下在两个方向的组合上连通，如右下或内上在三个方向的组合上连通，如内右上或内左下	当前像素是立方体的中心。

对于更高的维度，bwconncomp 使用默认值 conndef(ndims(BW),"maximal")。

也可以通过指定由 0 和 1 组成的 3×3×...×3 矩阵，以更通用的方式来定义任意维度的连通性。值为 1 的元素定义相对于 conn 的中心元素的邻域位置。请注意，conn 必须关于其中心元素对称。有关详细信息，请参阅指定自定义连通性。

数据类型： double | logical

输出参数

全部折叠

`CC` — 连通分量
结构体

连通分量，以具有四个字段的结构体形式返回。

字段	描述
`Connectivity`	连通分量（对象）的连通性
`ImageSize`	`BW` 的大小
`NumObjects`	`BW` 中连通分量（对象）的数量
`PixelIdxList`	1×`NumObjects` 元胞数组，其中，元胞数组中的第 k 个元素是包含第 k 个对象中像素的线性索引的向量。

提示

函数 bwlabel、bwlabeln 和 bwconncomp 都可以计算二值图像的连通分量。bwconncomp 取代了 bwlabel 和 bwlabeln。它使用的内存少得多，有时运行速度比其他函数更快。
函数输入维度输出格式内存使用量连通性
bwlabel 二维双精度标签矩阵高 4 或 8
bwlabeln N 维双精度标签矩阵高任何
bwconncomp N 维 CC 结构体低任何
要使用具有默认连通的 regionprops 从二值图像中提取特征，只需使用命令 regionprops(BW) 将 BW 直接传入 regionprops。
要计算具有更高内存效率的数据类型的标签矩阵（例如，uint8 对比 double），请对 bwconncomp 的输出使用 labelmatrix 函数。

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

扩展功能

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

用法说明和限制：

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

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

用法说明和限制：

bwconncomp 仅支持二维输入。
conn 参数必须为编译时常量，并且只支持 4 连通或 8 连通。您也可以将连通性指定为 3×3 矩阵，但它只能是 [0 1 0;1 1 1;0 1 0] 或 ones(3)
不支持 CC 结构返回值中的 PixelIdxList 字段。