HALCON Reference Manual 10.0.2
Table of Contents / Image / Features ClassesClassesClasses | | | Operators

cooc_feature_imagecooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImage (Operator)

Name

cooc_feature_imagecooc_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)

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

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

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

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

void HOperatorSetX.CoocFeatureImage(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [in] VARIANT LdGray, [in] VARIANT Direction, [out] VARIANT* Energy, [out] VARIANT* Correlation, [out] VARIANT* Homogeneity, [out] VARIANT* Contrast)

VARIANT HImageX.CoocFeatureImage(
[in] IHRegionX* Regions, [in] Hlong LdGray, [in] VARIANT Direction, [out] VARIANT* Correlation, [out] VARIANT* Homogeneity, [out] VARIANT* Contrast)

VARIANT HRegionX.CoocFeatureImage(
[in] IHImageX* Image, [in] Hlong LdGray, [in] VARIANT Direction, [out] VARIANT* Correlation, [out] VARIANT* Homogeneity, [out] VARIANT* Contrast)

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_imagecooc_feature_imageCoocFeatureImageCoocFeatureImage corresponds to the consecutive execution of the operators gen_cooc_matrixgen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrix and cooc_feature_matrixcooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrix. 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_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrix and then call the operator cooc_feature_matrixcooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrix 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.

Parallelization

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHRegionXHobject

Region to be examined.

ImageImageImageImageimage (input_object)  image → objectHImageHImageHImageXHobject (byte)

Corresponding gray values.

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

Number of gray values to be distinguished (2^LdGray).

Default value: 6

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

DirectionDirectionDirectionDirectiondirection (input_control)  integer → HTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / char*) (Hlong / BSTR) (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) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Gray value energy.

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

Correlation of gray values.

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

Local homogeneity of gray values.

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

Gray value contrast.

Result

The operator cooc_feature_imagecooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImage 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>)set_system("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>)set_system("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_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrix

Alternatives

cooc_feature_matrixcooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrix

See also

intensityintensityintensityIntensityIntensity, min_max_graymin_max_graymin_max_grayMinMaxGrayMinMaxGray, entropy_grayentropy_grayentropy_grayEntropyGrayEntropyGray, select_grayselect_grayselect_graySelectGraySelectGray

Module

Foundation

Table of Contents / Image / Features ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH