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

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix (Operator)

Name

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix — 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)

def cooc_feature_matrix(cooc_matrix: HObject) -> Tuple[float, float, float, float]

Description

The operator calculates from a co-occurrence matrix (CoocMatrixCoocMatrixCoocMatrixCoocMatrixcoocMatrixcooc_matrix) the energy (EnergyEnergyEnergyEnergyenergyenergy), correlation (CorrelationCorrelationCorrelationCorrelationcorrelationcorrelation), local homogeneity (HomogeneityHomogeneityHomogeneityHomogeneityhomogeneityhomogeneity) and contrast (ContrastContrastContrastContrastcontrastcontrast).

The operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix calculates the gray value features from the part of the input matrix generated by gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix 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

CoocMatrixCoocMatrixCoocMatrixCoocMatrixcoocMatrixcooc_matrix (input_object)  singlechannelimage(-array) → objectHImageHObjectHImageHobject (real)

Co-occurrence matrix.

EnergyEnergyEnergyEnergyenergyenergy (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Homogeneity of the gray values.

CorrelationCorrelationCorrelationCorrelationcorrelationcorrelation (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Correlation of gray values.

HomogeneityHomogeneityHomogeneityHomogeneityhomogeneityhomogeneity (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Local homogeneity of gray values.

ContrastContrastContrastContrastcontrastcontrast (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Gray value contrast.

Result

The operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix returns the value 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>)set_system("no_object_result",<Result>). If necessary an exception is raised.

Possible Predecessors

gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix

Alternatives

cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImagecooc_feature_image

See also

intensityintensityIntensityIntensityIntensityintensity, min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGraymin_max_gray, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGrayentropy_gray, select_grayselect_graySelectGraySelectGraySelectGrayselect_gray

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 21.05.0.0 Copyright © 1996-2021 MVTec Software GmbH
Follow us on