regionprops

度量属性的图像区域

所有的页面崩溃

语法

统计= regionprops (BW,属性)

统计= regionprops (CC、属性)

统计= regionprops (L,属性)

统计= regionprops(地区,属性)

统计= regionprops (outputFormat,___)

描述

的regionprops函数措施属性如面积、质心和边界框,每个对象(连接组件)在一个图像。regionprops金宝app同时支持连续的区域和不连续的区域。

请注意

测量三维容积图像中的对象的性质,考虑使用regionprops3代替。虽然regionprops可以接受三维图像,regionprops3金宝app支持三维图像的更多的统计数据。

当你打电话给regionprops功能,你可以省略属性参数,在这种情况下,函数返回“区域”,“重心”,“边界框(“大小)测量。

例子

统计数据= regionprops (BW,属性)措施二进制图像中的每个对象的属性BW。

regionprops发现独特的二进制图像使用8-connected社区进行二维图像中的对象和最大连接为更高维度图像。有关更多信息,请参见像素连接。使用其他类型的连接,找到对象使用bwconncomp创建连接组件,然后将结果传递给regionprops使用CC相反的论点。

统计数据= regionprops (CC,属性)措施为每个连接组件属性CC返回的,这是一个结构bwconncomp。

统计数据= regionprops (l,属性)标签属性对于每一个标记的地区形象的措施l。

统计数据= regionprops(地区,我,属性)像素值属性也措施对于每一个标记的区域灰度图像我。第一个输入参数,地区,必须是一个有效的值BW,CC,或l论点。

例子

统计数据= regionprops (outputFormat,___)还指定了返回的格式测量作为一个结构或一个表数组,使用outputFormat论点。

例子

全部折叠

计算质心图像重叠的位置

打开生活的脚本

一个二进制图像读入工作区。

BW = imread (“text.png”);

计算质心图像中连接组件使用regionprops。的regionprops函数返回一个结构数组的重心。

s = regionprops (BW,“重心”);

存储x- - -y质心的坐标为一个两列的矩阵。

质心=猫(1、s.Centroid);

显示二进制图像的质心位置叠加。

imshow (BW)在情节(质心(:1),重心(:,2)," b *’)举行从

图包含一个坐标轴对象。坐标轴对象包含2图像类型的对象,线。一个或多个行显示的值只使用标记

评估中心和半径的圆形物体和阴谋

打开生活的脚本

估计圆的中心和半径对象在一个图像和使用这些信息绘制圆的形象。在这个例子中,regionprops返回测量区域属性表中。

一个图像读入工作区。

一个= imread (“circlesBrightDark.png”);

把输入图像变成一个二进制图像。

bw = < 50;imshow (bw)标题(“和圆圈图像”)

图包含一个坐标轴对象。坐标轴对象与标题图片圈包含一个类型的对象的形象。

计算图像中区域的属性,并返回一个表中的数据。

统计= regionprops (“表”bw,“重心”,…“MajorAxisLength”,“MinorAxisLength”)

统计=3×3表重心MajorAxisLength MinorAxisLength ___________售予售予300 120 79.517 79.517 330.29 369.92 109.49 - 108.6 99.465 - 99.465 450 240

圆的中心和半径。

中心= stats.Centroid;直径=意味着([统计数据。MajorAxisLength stats.MinorAxisLength), 2);半径=直径/ 2;

画出圆圈。

持有在viscircles(中心、半径)

ans =组属性:孩子们:[2 x1线]可见:在HitTest:显示所有属性

持有从

图包含一个坐标轴对象。坐标轴对象与标题图片圈包含3线类型的对象,形象。

输入参数

全部折叠

`BW`- - - - - -二进制图像
逻辑阵列

二进制图像,指定为一个逻辑阵列的维度。

数据类型:逻辑

`CC`- - - - - -连接组件
结构

连接组件,指定为返回的结构bwconncomp。

数据类型:结构体

`l`- - - - - -标签图像
数字数组|分类数组

标签图像,指定为以下之一。

数值数组的维度。像素标记0是背景。像素标记1形成了一个对象;像素标记2构成第二个对象;等等。regionprops对待negative-valued像素作为背景和轮下来输入像素不是整数。你可以得到一个数字标签图像标记等功能分水岭或labelmatrix。
一个分类数组。每个类别对应一个不同的地区。

数据类型:单|双|int8|int16|int32|uint8|uint16|uint32|分类

`属性`- - - - - -类型的测量
`“基本”`(默认)|以逗号分隔的字符串标量或特征向量|一系列字符串标量|单元阵列的特征向量|`“所有”`

测量类型,指定为一个以逗号分隔的字符串标量或特征向量,字符串标量、数组的单元阵列特征向量,或“所有”或“基本”。

如果您指定“所有”,然后regionprops计算所有测量和形状,灰度图像,像素值测量。
如果您指定“基本”,然后regionprops只计算“区域”,“重心”,“边界框(“大小)测量。

下表中列出的所有属性,提供形状测量。中列出的属性像素值测量表是有效的只有当你指定一个灰度图像。

形状测量

属性名描述一天的支金宝app持 GPU的金宝app支持代码生成

“区域”

实际数量的像素区域,作为一个标量返回。这个值可以从返回的值略有不同bwarea像素不同,重量不同模式。

找到的面积相当于一个三维体积,使用“体积”的属性regionprops3。

是的

“边界框(“大小)

的位置和尺寸最小的盒子包含地区,作为1 -(2 *返回问)向量,问是图像维数。第一个问元素的坐标的最小的角落。第二个问元素框的大小以及每个维度。例如,一个二维边界框与价值(5.5 - 8.5 11 14)表明(x,y)框的左上角的坐标是(5.5,8.5),盒子的水平宽度是11像素,和盒子的垂直高度14像素。

是的

“重心”

质心的地区,作为1 -返回问向量,问是图像维数。的第一个元素重心水平坐标(或x质心的坐标)。第二个元素是垂直坐标(或y协调)。所有其他的元素重心维度的顺序。

这个数字说明了质心和边界框不接触的区域。该地区由白色像素。绿色盒子边界框,红点是重心。

重心在这个边界框包含一个地区。

是的

“循环”

圆度的对象,作为结构字段返回循环。结构包含循环输入图像中的每个对象的价值。循环值计算:

(4 *π*面积/周长^ 2)* (1 - 0.5 / r) ^ 2在哪里r =周长/(2 *π)+ 0.5

最大循环值是1。输入标签必须是一个矩阵与相邻地区或二进制图像。如果图像包含不接触的区域,regionprops返回意想不到的结果。

二只

没有

是的

“ConvexArea” 的像素数量ConvexImage,作为一个标量返回。二只没有没有

“ConvexHull” 可以包含的最小凸多边形的区域,作为一个返回p2矩阵。矩阵的每一行包含x- - -y多边形的一个顶点的坐标。二只没有没有

“ConvexImage” 形象,指定了凸包,船体内的所有像素填充(设置为在),返回为一个二进制图像。图像区域的边界框的大小。对船体穿过的边界像素,regionprops使用描述的算法分类像素部分封闭的ROI。二只没有没有

“偏心” 古怪的椭圆second-moments一样,作为一个标量返回。离心率的比率是椭圆的焦点之间的距离和其主要轴长度。的值在0和1之间。(0和1的退化情况。一个椭圆的离心率是0实际上是一个圆,而一个椭圆的离心率是1是一条线段)。二只是的是的

“EquivDiameter” 圆的直径与同一地区,作为一个标量返回。计算为√4 *区域/ pi)。二只是的是的

“EulerNumber” 在该地区的对象数量-洞这些对象的数量,作为一个标量返回。这个属性只对二维标签支持矩阵。金宝appregionprops使用8-connectivity计算欧拉数(也称为欧拉示性数)。学习更多的关于连接,看到的像素连接。二只没有是的

“程度” 的像素区域的像素比例总边界框,作为一个标量返回。计算的区域除以边界框的面积。二只是的是的

“极值”

极值点在该地区,作为一个8-by-2矩阵返回。矩阵的每一行包含x- - -y之一的坐标点。向量的格式左下(左上的右上的右上角right-bottom右下方left-bottom工具条)。对于一些形状,多个极值点可以有相同的坐标。

这个数字说明了两种不同的极值区域。在左边的区域,每一个极值点是不同的。为该地区在右边,(如某些极值点左上的和工具条)是相同的。

两个不同的地区,每个国家都有他们的八个极值点标记

二只

是的

“FilledArea” 的数量在像素FilledImage,作为一个标量返回。是的没有是的

“FilledImage”

图像大小相同的边界框区域,作为一个二进制数组返回。的在像素对应于该地区,洞填满,如这个图所示。

比较原始的地区组成的触摸圈填充区域的空隙填满。

是的

没有

是的

“图像” 图像大小相同的边界框区域,作为一个二进制数组返回。的在像素对应于该地区,和其他所有像素从。是的是的是的

“MajorAxisLength” 长度(以像素为单位)的主要轴的椭圆的规范化第二中央的时刻,作为一个标量返回。二只是的是的

“MaxFeretProperties”

Feret属性,包括最大Feret直径,其相对角度,和坐标值,作为结构返回字段:

场	描述
`MaxFeretDiameter`	最大Feret直径测量之间的最大距离上的任何两个边界点映的凸壳顶点将对象。
`MaxFeretAngle`	角的最大Feret直径对水平轴的形象。
`MaxFeretCoordinates`	最大Feret直径的端点坐标。

输入可以是一个二进制图像,连接组件,或一个标签矩阵。

二只

没有

“MinFeretProperties”

Feret属性,包括最低Feret直径,其相对角度,和坐标值,作为结构返回字段:

场	描述
`MinFeretDiameter`	最低Feret直径测量之间的最小距离上的任何两个边界点映的凸壳顶点将对象。
`MinFeretAngle`	角的最小Feret直径对水平轴的形象。
`MinFeretCoordinates`	端点的坐标的最小Feret直径。

输入可以是一个二进制图像,连接组件,或一个标签矩阵。

二只

没有

“MinorAxisLength” 长度(以像素为单位)的椭圆的短轴相同的归一化第二中央的时刻,作为一个标量返回。二只是的是的

“定位”

之间的角x设在和椭圆的长轴second-moments一样,作为一个标量返回。价值是在度,从-90度到90度。这个数字说明了轴和方向的椭圆。左边的图中显示一个图像区域及其对应的椭圆。右边显示了相同的椭圆与固体蓝线代表轴。红点是焦点。方向是水平虚线之间的角度和主轴。

轴和方向的椭圆图像周围地区

二只

是的

“周长”

距离的边界地区作为一个标量返回。regionprops计算周长计算每一对相邻的像素之间的距离的边境地区。如果图像包含不接触的区域,regionprops返回意想不到的结果。这幅图描绘了周长计算这个对象中包含的像素。

周边区域的像素

二只

没有

是的

“PixelIdxList” 该地区的像素的线性指标,作为一个返回p元向量。是的是的是的

“PixelList” 在该地区的像素的位置,作为一个返回p——- - - - - -问矩阵。矩阵的每一行的形式(x y z……)并指定一个像素的坐标。是的是的是的

“稳健”

像素的比例也在该地区的凸包,作为一个标量返回。计算体积区域/ ConvexArea。

regionprops只能计算可靠性的二维图像。计算的三维图像,使用regionprops3。

二只

没有

“SubarrayIdx” 的元素l在对象边界框,返回包含指标,这样作为一个单元阵列L (idx {:})提取元素。是的是的没有

在下表中像素值测量属性是有效的只有当你指定一个灰度图像,我。

像素值测量

属性名	描述	一天的支金宝app持	GPU的金宝app支持	代码生成
`“MaxIntensity”`	值最大的像素强度的区域,作为一个标量返回。	是的	是的	是的
`“MeanIntensity”`	意味着所有的强度值在该地区,作为一个标量返回。	是的	是的	是的
`“MinIntensity”`	价值最低的像素强度在该地区,作为一个标量返回。	是的	是的	是的
`“PixelValues”`	在该地区的像素数量,作为一个返回p1的向量,p该地区是像素的数量。向量中每个元素包含一个像素的值。	是的	是的	是的
`“WeightedCentroid”`	区域中心位置和强度值的基础上,作为一个返回p——- - - - - -`问`向量的坐标。的第一个元素`WeightedCentroid`水平坐标(或x加权质心的坐标)。第二个元素是垂直坐标(或y协调)。所有其他的元素`WeightedCentroid`维度的顺序。	是的	是的	是的

数据类型:字符|字符串|细胞

`我`- - - - - -图像测量
灰度图像

图像测量,指定为灰度图像。图像的大小必须匹配二进制映像的大小BW连接组件结构CC或标签图像l。

数据类型:单|双|int8|int16|int32|int64|uint8|uint16|uint32

`outputFormat`- - - - - -输出格式
`“结构”`(默认)|`“表”`

输出格式的测量值统计数据,指定为以下值中的任何一个。

价值	描述
`“结构”`	返回一个结构数组长度等于物体的数量`BW`,`CC.NumObjects`,或`max (l(:))`。结构数组表示的字段为每个地区不同的属性,指定的`属性`。
`“表”`	返回一个`表`随高度()的行数等于物体的数量`BW`,`CC.NumObjects`,或`max (l(:))`。变量(列)表示为每个地区不同的属性,指定的`属性`。

数据类型:字符|字符串

输出参数

全部折叠

`统计数据`——测量值
`结构体`数组(默认)|表

测量值,作为一个数组返回的结构或一个表。的数量结构数组或表的行数等于物体的数量BW,CC.NumObjects,或马克斯(L (:))。每个领域的结构或计算变量的每一行表示属性为每个区域,规定属性。如果输入图像分类标签图像l,然后统计数据包括一个额外的字段或变量的属性“LabelName”。

提示

的ismember函数是用于创建一个二进制图像仅包含对象或满足特定条件的地区。例如,这些命令创建一个二进制图像仅包含的区域的面积大于80和离心率小于0.8。
```
cc = bwconncomp (BW);统计= regionprops (cc,“区域”,“偏心”);idx =找到([统计数据。区域] > 80 & [stats.Eccentricity] < 0.8); BW2 = ismember(labelmatrix(cc),idx);
```
regionprops利用中间结果的计算相关测量。因此,最快来计算所有所需的测量在单个调用regionprops。
大多数测量花很少时间来计算。然而,这些测量可以花费更长的时间,这取决于地区的数量l:
- “ConvexHull”
- “ConvexImage”
- “ConvexArea”
- “FilledImage”

扩展功能

C / c++代码生成
生成C和c++代码使用MATLAB®编码器™。

使用笔记和限制:

regionprops金宝app支持C代码的生成(需要MATLAB^®编码器™)。注意,如果您选择通用MATLAB主机目标平台,regionprops生成的代码使用了一个预编译的,特定于平台的共享库。使用一个共享库保存性能优化,但限制的目标平台可以生成代码。有关更多信息,请参见类型的代码生成图像处理工具箱的支持金宝app。
金宝app只支持二进制图像或数字标签图片。输入标签图片不支持的数据类型分类。金宝app
指定输出类型“表”不支持。金宝app
不支持通过单元阵列的属性。金宝app使用逗号分隔列表。
除了支持所有属性金宝app“ConvexArea”,“ConvexHull”,“ConvexImage”,“MaxFeretProperties”,“MinFeretProperties”,“稳健”,“SubarrayIdx”。

GPU的代码生成
生成NVIDIA的CUDA®代码®GPU使用GPU编码器™。

使用笔记和限制:

GPU编码器™生成优化的CUDA^®代码只有二进制图像。代码生成的输入标签图片不优化。输入标签图片不支持的数据类型分类。金宝app
指定输出类型“表”不支持。金宝app
不支持通过单元阵列的属性。金宝app使用逗号分隔列表。
只有“区域”,“边界框(“大小),“重心”,“偏心”,“EquivDiameter”,“程度”,“MajorAxisLength”,“MinorAxisLength”,“定位”,“PixelIdxList”“PixelList”,“MaxIntensity”,“MeanIntensity”,“MinIntensity”,“PixelValues”,“WeightedCentroid”属性的支持。金宝app

线程环境
在后台运行代码使用MATLAB®`backgroundPool`与并行计算工具箱™或加速代码`ThreadPool`。

这个函数完全支持线程的环境。金宝app有关更多信息,请参见MATLAB函数线程环境中运行。

GPU数组
加速代码运行在一个图形处理单元(GPU)使用并行计算工具箱™。

使用笔记和限制:

gpuArray输入逻辑矩阵必须是一个二维或二维标签矩阵。
连接组件结构(CC输入不支持)。金宝app
不支持以下特性:金宝app“ConvexArea”,“ConvexHull”,“ConvexImage”,“循环”,“EulerNumber”,“FilledArea”,“FilledImage”,“MaxFeretProperties”,“MinFeretProperties”,“稳健”。
“结构”是唯一的返回类型的支持。金宝app

有关更多信息,请参见图像处理在GPU上。

版本历史

之前介绍过的R2006a

全部展开

R2023a:新的圆方程

的regionprops函数使用一个新的方程来计算循环。新方程消除偏见,导致过高的计算循环相对较小的对象。

如果你想复制循环测量使用旧的方程,然后您可以使用这些命令:

道具= regionprops(我,“区域”“周长”]);oldCircularity = 4 *π*道具。区域。/ props.Perimeter。^ 2;

R2022b:金宝app支持线程的环境

regionprops现在支持金宝app线程的环境。

R2022a:`regionprops`存储`图像`,`ConvexImage`,`FilledImage`属性作为所有输入输出表中单元格数组

从R2022a开始,当一个表指定输出格式,regionprops存储函数图像,ConvexImage,FilledImage属性值作为细胞阵列,无论大小的图像对象。在以前的版本中,如果一个物体的边界框的大小是1×1或1 -n,这些属性都存储在输出表数值标量或行向量。

更新你的代码,访问的值图像,ConvexImage,FilledImage属性用花括号使用点符号,{}。例如,使用下面的代码来访问图像属性第一对象的输入图像BW。在以前的版本中,花括号不需要访问值存储为数字标量或行向量。

统计= regionprops (“表”BW,“图像”);imdata = stats.Image {1};

R2020a:金宝app支持分类数据

regionprops现在支持金宝app分类图像数据。

R2019a:新的循环和Feret属性

regionprops现在测量区域的循环和Feret属性在一个二进制图像。测量循环、最小Feret属性,或最大Feret属性,包括“循环”,“MinFeretProperties”,或“MaxFeretProperties”分别指定属性论点。

另请参阅

regionprops

语法

描述

例子

计算质心图像重叠的位置

评估中心和半径的圆形物体和阴谋

输入参数

`BW`- - - - - -二进制图像
逻辑阵列

`CC`- - - - - -连接组件
结构

`l`- - - - - -标签图像
数字数组|分类数组

`属性`- - - - - -类型的测量
`“基本”`(默认)|以逗号分隔的字符串标量或特征向量|一系列字符串标量|单元阵列的特征向量|`“所有”`

`我`- - - - - -图像测量
灰度图像

`outputFormat`- - - - - -输出格式
`“结构”`(默认)|`“表”`

输出参数

`统计数据`——测量值
`结构体`数组(默认)|表

更多关于

连续的区域和不连续的区域

提示

扩展功能

C / c++代码生成
生成C和c++代码使用MATLAB®编码器™。

GPU的代码生成
生成NVIDIA的CUDA®代码®GPU使用GPU编码器™。

线程环境
在后台运行代码使用MATLAB®`backgroundPool`与并行计算工具箱™或加速代码`ThreadPool`。

GPU数组
加速代码运行在一个图形处理单元(GPU)使用并行计算工具箱™。

版本历史

R2023a:新的圆方程

R2022b:金宝app支持线程的环境

R2022a:`regionprops`存储`图像`,`ConvexImage`,`FilledImage`属性作为所有输入输出表中单元格数组

R2020a:金宝app支持分类数据

R2019a:新的循环和Feret属性

另请参阅

主题

regionprops

语法

描述

例子

计算质心图像重叠的位置

评估中心和半径的圆形物体和阴谋

输入参数

BW- - - - - -二进制图像逻辑阵列

CC- - - - - -连接组件结构

l- - - - - -标签图像数字数组|分类数组

属性- - - - - -类型的测量“基本”(默认)|以逗号分隔的字符串标量或特征向量|一系列字符串标量|单元阵列的特征向量|“所有”

我- - - - - -图像测量灰度图像

outputFormat- - - - - -输出格式“结构”(默认)|“表”

输出参数

统计数据——测量值结构体数组(默认)|表

更多关于

连续的区域和不连续的区域

提示

扩展功能

C / c++代码生成生成C和c++代码使用MATLAB®编码器™。

GPU的代码生成生成NVIDIA的CUDA®代码®GPU使用GPU编码器™。

线程环境在后台运行代码使用MATLAB®backgroundPool与并行计算工具箱™或加速代码ThreadPool。

GPU数组加速代码运行在一个图形处理单元(GPU)使用并行计算工具箱™。

版本历史

R2023a:新的圆方程

R2022b:金宝app支持线程的环境

R2022a:regionprops存储图像,ConvexImage,FilledImage属性作为所有输入输出表中单元格数组

R2020a:金宝app支持分类数据

R2019a:新的循环和Feret属性

另请参阅

主题

`BW`- - - - - -二进制图像
逻辑阵列

`CC`- - - - - -连接组件
结构

`l`- - - - - -标签图像
数字数组|分类数组

`属性`- - - - - -类型的测量
`“基本”`(默认)|以逗号分隔的字符串标量或特征向量|一系列字符串标量|单元阵列的特征向量|`“所有”`

`我`- - - - - -图像测量
灰度图像

`outputFormat`- - - - - -输出格式
`“结构”`(默认)|`“表”`

`统计数据`——测量值
`结构体`数组(默认)|表

C / c++代码生成
生成C和c++代码使用MATLAB®编码器™。

GPU的代码生成
生成NVIDIA的CUDA®代码®GPU使用GPU编码器™。

线程环境
在后台运行代码使用MATLAB®`backgroundPool`与并行计算工具箱™或加速代码`ThreadPool`。

GPU数组
加速代码运行在一个图形处理单元(GPU)使用并行计算工具箱™。

R2022a:`regionprops`存储`图像`,`ConvexImage`,`FilledImage`属性作为所有输入输出表中单元格数组