HALCON Website / HALCON Operator Reference / Image / Features
ClassesClasses | | Operators

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrix (Operator)

Name

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrix — Calculate gray value features from a co-occurrence matrix.

Signature

cooc_feature_matrix(CoocMatrix : : : Energy, Correlation, Homogeneity, Contrast)

Herror cooc_feature_matrix(const Hobject CoocMatrix, double* Energy, double* Correlation, double* Homogeneity, double* Contrast)

Herror T_cooc_feature_matrix(const Hobject CoocMatrix, Htuple* Energy, Htuple* Correlation, Htuple* Homogeneity, Htuple* Contrast)

void CoocFeatureMatrix(const HObject& CoocMatrix, HTuple* Energy, HTuple* Correlation, HTuple* Homogeneity, HTuple* Contrast)

double HImage::CoocFeatureMatrix(double* Correlation, double* Homogeneity, double* Contrast) const

static void HOperatorSet.CoocFeatureMatrix(HObject coocMatrix, out HTuple energy, out HTuple correlation, out HTuple homogeneity, out HTuple contrast)

double HImage.CoocFeatureMatrix(out double correlation, out double homogeneity, out double contrast)

Description

The operator calculates from a co-occurence matrix (CoocMatrixCoocMatrixCoocMatrixCoocMatrixcoocMatrix) the energy (EnergyEnergyEnergyEnergyenergy), correlation (CorrelationCorrelationCorrelationCorrelationcorrelation), local homogeneity (HomogeneityHomogeneityHomogeneityHomogeneityhomogeneity) and contrast (ContrastContrastContrastContrastcontrast).

The operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrix calculates the gray value features from the part of the input matrix generated by gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrix corresponding to the direction matrix indicated by the parameters LdGray and Direction according to the following formulae:

Energy:

Correlation:
Local homogeneity:
Contrast:
where

Attention

The region of the input image is disregarded.

Execution Information

Parameters

CoocMatrixCoocMatrixCoocMatrixCoocMatrixcoocMatrix (input_object)  singlechannelimage(-array) → objectHImageHImageHobject (real)

Co-occurrence matrix.

EnergyEnergyEnergyEnergyenergy (output_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Homogeneity of the gray values.

CorrelationCorrelationCorrelationCorrelationcorrelation (output_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Correlation of gray values.

HomogeneityHomogeneityHomogeneityHomogeneityhomogeneity (output_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Local homogeneity of gray values.

ContrastContrastContrastContrastcontrast (output_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Gray value contrast.

Result

The operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrix returns the value 2 (H_MSG_TRUE) if an image with defined gray values is passed and the parameters are correct. The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrix

Alternatives

cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImage

See also

intensityintensityIntensityIntensityIntensity, min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray, select_grayselect_graySelectGraySelectGraySelectGray

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH