regionprops

度量属性的图像区域

所有的页面崩溃

语法

统计= regionprops (BW,属性)

统计= regionprops (CC、属性)

统计= regionprops (L,属性)

统计= regionprops (___,我,属性)

统计= regionprops(输出,___)

描述

例子

统计数据= regionprops (BW,属性)返回测量组属性的每个8-connected组件(对象)在二进制图像,BW。您可以使用regionprops在连续的区域和不连续的区域(见更多关于)。

请注意

返回的测量三维容积图像,可以考虑使用regionprops3。而regionprops可以接受三维图像,regionprops3计算三维图像的统计数据比regionprops。

对于所有的语法,如果你不指定属性参数,然后regionprops返回“区域”,“重心”,的边界框(“大小)测量。

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

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

统计数据= regionprops (___,我,属性)返回指定的属性集测量属性对于每一个标记的地区形象我。第一个输入regionprops(BW,CC,或l)确定的地区我。

例子

统计数据= regionprops (输出,___)返回一组属性测量,输出指定返回值的类型。regionprops可以返回测量的结构体数组或一个表。

例子

全部折叠

计算质心图像重叠的位置

打开生活的脚本

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

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 = < 100;imshow (bw)标题(“形象圈”)

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

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

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

统计=4×3表重心MajorAxisLength MinorAxisLength ___________售予售予256.5 256.5 834.46 834.46 300 120 81.759 101.72 81.759 330.47 369.83 111.78 110.36 450 240 101.72

圆的中心和半径。

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

画出圆圈。

持有在viscircles(中心、半径);持有从

图包含一个坐标轴对象。坐标轴对象与标题图片圈包含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 *区*π)/(周长²)。一个完美的圆,圆的值是1。输入标签必须是一个矩阵与相邻地区或二进制图像。如果图像包含不接触的区域,regionprops返回意想不到的结果。

请注意

循环不建议非常小的对象(如3 x3的广场。在这种情况下,结果可能超过循环值一个完美的圆。

二只

没有

是的

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

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

“ConvexImage” 形象,指定了凸包,船体内的所有像素填充(设置为在),返回为一个二进制图像(逻辑)。图像区域的边界框的大小。(船体穿过的边界像素,regionprops使用相同的逻辑roipoly来确定像素是否内部或外部船体)。二只没有没有

“偏心” 古怪的椭圆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。二只没有没有

“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

`输出`- - - - - -返回类型
`“结构”`(默认)|`“表”`

返回类型,指定为以下值中的任何一个。

价值	描述
`“结构”`	返回一个结构数组长度等于物体的数量`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);
```
的默认连接8-connected二维图像,为更高的维度和最大连接。指定默认的连接,使用bwconncomp创建连接,然后将结果传递给组件regionprops。
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

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

使用笔记和限制:

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

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

另请参阅

主题

之前介绍过的R2006a

regionprops

语法

描述

例子

计算质心图像重叠的位置

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

输入参数

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

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

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

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

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

输出- - - - - -返回类型“结构”(默认)|“表”

输出参数

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

更多关于

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

提示

扩展功能

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

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

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

另请参阅

主题

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

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

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

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

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

`输出`- - - - - -返回类型
`“结构”`(默认)|`“表”`

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

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

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

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