HALCON 20.11.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 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>)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 20.11.0.0 Copyright © 1996-2020 MVTec Software GmbH