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

cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImagecooc_feature_image (Operator)

Name

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

def cooc_feature_image(regions: HObject, image: HObject, ld_gray: int, direction: Union[int, str]) -> Tuple[Sequence[float], Sequence[float], Sequence[float], Sequence[float]]

def cooc_feature_image_s(regions: HObject, image: HObject, ld_gray: int, direction: Union[int, str]) -> Tuple[float, float, float, float]

Description

The call of cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImagecooc_feature_image corresponds to the consecutive execution of the operators gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix and cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix. 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_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix and then call the operator cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix for the resulting matrix. The parameter DirectionDirectionDirectionDirectiondirectiondirection transfers the direction of the neighborhood in angle or 'mean'"mean""mean""mean""mean""mean". In the case of 'mean'"mean""mean""mean""mean""mean" the mean value is calculated in all four directions.

Attention

Note that the operator cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImagecooc_feature_image only considers the given RegionsRegionsRegionsRegionsregionsregions and ignores any previously set domain of the input image ImageImageImageImageimageimage.

Execution Information

Parameters

RegionsRegionsRegionsRegionsregionsregions (input_object)  region(-array) → objectHRegionHObjectHRegionHobject

Region to be examined.

ImageImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHImageHobject (byte)

Corresponding gray values.

LdGrayLdGrayLdGrayLdGrayldGrayld_gray (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of gray values to be distinguished ( ).

Default: 6

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

DirectionDirectionDirectionDirectiondirectiondirection (input_control)  integer → HTupleUnion[int, str]HTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)

Direction in which the matrix is to be calculated.

Default: 0

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

EnergyEnergyEnergyEnergyenergyenergy (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Gray value energy.

CorrelationCorrelationCorrelationCorrelationcorrelationcorrelation (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Correlation of gray values.

HomogeneityHomogeneityHomogeneityHomogeneityhomogeneityhomogeneity (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Local homogeneity of gray values.

ContrastContrastContrastContrastcontrastcontrast (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Gray value contrast.

Result

The operator cooc_feature_imagecooc_feature_imageCoocFeatureImageCoocFeatureImageCoocFeatureImagecooc_feature_image returns the value 2 ( H_MSG_TRUE) if an image with defined gray values ('byte'"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>)set_system("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>)set_system("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

gen_cooc_matrixgen_cooc_matrixGenCoocMatrixGenCoocMatrixGenCoocMatrixgen_cooc_matrix

Alternatives

cooc_feature_matrixcooc_feature_matrixCoocFeatureMatrixCoocFeatureMatrixCoocFeatureMatrixcooc_feature_matrix

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 23.05.0.0 Copyright © 1996-2023 MVTec Software GmbH