graycoprops
Properties of gray-level co-occurrence matrix
Syntax
stats = graycoprops(glcm,properties)
Description
calculates the statistics specified instats
= graycoprops(glcm
,properties
)properties
from the gray-level co-occurrence matrixglcm
.glcm
is anm-by-n-by-parray of valid gray-level co-occurrence matrices. Ifglcm
is an array of GLCMs,stats
is an array of statistics for eachglcm
.
graycoprops
normalizes the gray-level co-occurrence matrix (GLCM) so that the sum of its elements is equal to1
. Each element (r,c)应用灰度共生矩阵建立规范化的联合概率occurrence of pixel pairs with a defined spatial relationship having gray level valuesrandcin the image.graycoprops
uses the normalized GLCM to calculateproperties
.
Examples
Calculate Statistics from Gray-level Co-occurrence Matrix
Create simple sample GLCM.
glcm = [0 1 2 3;1 1 2 3;1 0 2 0;0 0 0 3]
glcm =4×40 1 2 3 1 1 2 3 1 0 2 0 0 0 0 3
Calculate statistical properties of the GLCM.
stats = graycoprops(glcm)
stats =struct with fields:Contrast: 2.8947 Correlation: 0.0783 Energy: 0.1191 Homogeneity: 0.5658
Calculate Contrast and Homogeneity from Multiple GLCMs
Read grayscale image into the workspace.
I = imread('circuit.tif');
Create two gray-level co-occurrence matrices (GLCM) from the image, specifying different offsets.
glcm = graycomatrix(I,'Offset',[2 0;0 2])
glcm = glcm(:,:,1) = Columns 1 through 6 14205 2107 126 0 0 0 2242 14052 3555 400 0 0 191 3579 7341 1505 37 0 0 683 1446 7184 1368 0 0 7 116 1502 10256 1124 0 0 0 2 1153 1435 0 0 0 0 0 0 0 0 0 0 0 0 Columns 7 through 8 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 glcm(:,:,2) = Columns 1 through 6 13938 2615 204 4 0 0 2406 14062 3311 630 23 0 145 3184 7371 1650 133 0 2 371 1621 6905 1706 0 0 0 116 1477 9974 1173 0 0 0 1 1161 1417 0 0 0 0 0 0 0 0 0 0 0 0 Columns 7 through 8 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Get statistics on contrast and homogeneity of the image from the GLCMs.
stats = graycoprops(glcm,{'contrast','homogeneity'})
stats =struct with fields:Contrast: [0.3420 0.3567] Homogeneity: [0.8567 0.8513]
Input Arguments
glcm
—Gray-level Co-occurrence Matrix
real, non-negative array of finite logical or numeric integers
Gray-level Co-occurrence Matrix, specified as a real, non-negative array of finite logical or numeric integers. Use the graycomatrix function to create a GLCM.
Data Types:single
|double
|int8
|int16
|int32
|int64
|uint8
|uint16
|uint32
|uint64
|logical
properties
—Statistical properties of the image derived from GLCM
'all'
(default) |comma-separated list|cell array|space-separated string scalar or character vector
Statistical properties of the image derived from GLCM, specified as a comma-separated list string scalars or character vectors, space-separated string scalar or character vector, cell array of string scalars or character vectors, or'all'
. You can specify any of the property names listed in this table. Property names can be abbreviated and are not case sensitive.
Property |
Description |
Formula |
---|---|---|
|
Returns a measure of the intensity contrast between a pixel and its neighbor over the whole image. Range = [0 (size(GLCM,1)-1)^2] Contrast is 0 for a constant image. The property Contrast is also known asvarianceandinertia. |
|
|
Returns a measure of how correlated a pixel is to its neighbor over the whole image.
Correlation is 1 or -1 for a perfectly positively or negatively correlated image. Correlation is |
|
|
Returns the sum of squared elements in the GLCM. Range = [0 1] Energy is The property Energy is also known asuniformity,uniformity of energy, andangular second moment. |
|
|
Returns a value that measures the closeness of the distribution of elements in the GLCM to the GLCM diagonal. Range = [0 1] Homogeneity is 1 for a diagonal GLCM. |
|
Data Types:char
|string
|cell
Output Arguments
stats
— Statistics derived from the GLCM
structure
Statistics derived from the GLCM, returned as a structure with fields that are specified byproperties
. Each field contains a 1-by-parray, wherepis the number of gray-level co-occurrence matrices in GLCM. For example, if GLCM is an 8-by-8-by-3 array and properties is'Energy'
,stats
is a structure containing the fieldEnergy
, which contains a 1-by-3 array.
See Also
Introduced before R2006a
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select:.
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina(Español)
- Canada(English)
- United States(English)
Europe
- Belgium(English)
- Denmark(English)
- Deutschland(Deutsch)
- España(Español)
- Finland(English)
- France(Français)
- Ireland(English)
- Italia(Italiano)
- Luxembourg(English)
- Netherlands(English)
- Norway(English)
- Österreich(Deutsch)
- Portugal(English)
- Sweden(English)
- Switzerland
- United Kingdom(English)