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

cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImage (Operator)

Name

cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImage — Calculate a co-occurrence matrix and derive gray value features thereof.

Signature

cooc_feature_image(Regions, Image : : LdGray, Direction : Energy, Correlation, Homogeneity, Contrast)

Herror cooc_feature_image(const Hobject Regions, const Hobject Image, const Hlong LdGray, const Hlong Direction, double* Energy, double* Correlation, double* Homogeneity, double* Contrast)

Herror T_cooc_feature_image(const Hobject Regions, const Hobject Image, const Htuple LdGray, const Htuple Direction, Htuple* Energy, Htuple* Correlation, Htuple* Homogeneity, Htuple* Contrast)

void CoocFeatureImage(const HObject& Regions, const HObject& Image, const HTuple& LdGray, const HTuple& Direction, HTuple* Energy, HTuple* Correlation, HTuple* Homogeneity, HTuple* Contrast)

HTuple HImage::CoocFeatureImage(const HRegion& Regions, Hlong LdGray, const HTuple& Direction, HTuple* Correlation, HTuple* Homogeneity, HTuple* Contrast) const

double HImage::CoocFeatureImage(const HRegion& Regions, Hlong LdGray, Hlong Direction, double* Correlation, double* Homogeneity, double* Contrast) const

HTuple HRegion::CoocFeatureImage(const HImage& Image, Hlong LdGray, const HTuple& Direction, HTuple* Correlation, HTuple* Homogeneity, HTuple* Contrast) const

double HRegion::CoocFeatureImage(const HImage& Image, Hlong LdGray, Hlong Direction, double* Correlation, double* Homogeneity, double* Contrast) const

static void HOperatorSet.CoocFeatureImage(HObject regions, HObject image, HTuple ldGray, HTuple direction, out HTuple energy, out HTuple correlation, out HTuple homogeneity, out HTuple contrast)

HTuple HImage.CoocFeatureImage(HRegion regions, int ldGray, HTuple direction, out HTuple correlation, out HTuple homogeneity, out HTuple contrast)

double HImage.CoocFeatureImage(HRegion regions, int ldGray, int direction, out double correlation, out double homogeneity, out double contrast)

HTuple HRegion.CoocFeatureImage(HImage image, int ldGray, HTuple direction, out HTuple correlation, out HTuple homogeneity, out HTuple contrast)

double HRegion.CoocFeatureImage(HImage image, int ldGray, int direction, out double correlation, out double homogeneity, out double contrast)

Description

The call of cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImage corresponds to the consecutive execution of the operators gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrix and cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrix. If several direction matrices of the co-occurrence matrix are to be evaluated consecutively, it is more efficient to generate the matrix via gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrix and then call the operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrix for the resulting matrix. The parameter DirectionDirectionDirectionDirectiondirection transfers the direction of the neighborhood in angle or 'mean'"mean""mean""mean""mean". In the case of 'mean'"mean""mean""mean""mean" the mean value is calculated in all four directions.

Attention

Note that the operator cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImage only considers the given RegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input image ImageImageImageImageimage.

Execution Information

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHobject

Region to be examined.

ImageImageImageImageimage (input_object)  singlechannelimage → objectHImageHImageHobject (byte)

Corresponding gray values.

LdGrayLdGrayLdGrayLdGrayldGray (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of gray values to be distinguished ( ).

Default value: 6

List of values: 1, 2, 3, 4, 5, 6, 7, 8

DirectionDirectionDirectionDirectiondirection (input_control)  integer → HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Direction in which the matrix is to be calculated.

Default value: 0

List of values: 0, 45, 90, 135, 'mean'"mean""mean""mean""mean"

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

Gray value energy.

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

Correlation of gray values.

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

Local homogeneity of gray values.

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

Gray value contrast.

Result

The operator cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImage returns the value 2 (H_MSG_TRUE) if an image with defined gray values ('byte'"byte""byte""byte""byte") is entered 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>), the behavior in case of empty region is set via set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrix

Alternatives

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrix

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