Operator Reference

HALCON Operator Reference / Image / Features
ClassesClasses | | Operators

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix (Operator)

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 cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix calculates from a co-occurrence matrix (CoocMatrixCoocMatrixCoocMatrixcoocMatrixcooc_matrix) the energy (EnergyEnergyEnergyenergyenergy), correlation (CorrelationCorrelationCorrelationcorrelationcorrelation), local homogeneity (HomogeneityHomogeneityHomogeneityhomogeneityhomogeneity) and contrast (ContrastContrastContrastcontrastcontrast).

The operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix calculates the gray value features from the part of the input matrix generated by gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix corresponding to the direction matrix indicated by the parameters LdGrayLdGrayLdGrayldGrayld_gray and DirectionDirectionDirectiondirectiondirection according to the following formulae:

  • Energy (Measure for image homogeneity):

  • Correlation (Measure for gray value dependencies):

  • Local homogeneity:

  • Contrast (Measure for the size of the intensity differences):

where

Width of CoocMatrixCoocMatrixCoocMatrixcoocMatrixcooc_matrix,

Entry of co-occurrence matrix,

,

,

,

.

Attention

The region of the input image is disregarded.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Automatically parallelized on tuple level.

Parameters

CoocMatrixCoocMatrixCoocMatrixcoocMatrixcooc_matrix (input_object)  singlechannelimage(-array) → objectHImageHObjectHObjectHobject (real)

Co-occurrence matrix.

EnergyEnergyEnergyenergyenergy (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Homogeneity of the gray values.

CorrelationCorrelationCorrelationcorrelationcorrelation (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Correlation of gray values.

HomogeneityHomogeneityHomogeneityhomogeneityhomogeneity (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Local homogeneity of gray values.

ContrastContrastContrastcontrastcontrast (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Gray value contrast.

Result

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

Possible Predecessors

gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix

Alternatives

cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImagecooc_feature_image

See also

intensityintensityIntensityIntensityintensity, min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray, entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray, select_grayselect_graySelectGraySelectGrayselect_gray

Module

Foundation

ClassesClasses | | Operators