gray_featuresGrayFeaturesGrayFeaturesgray_featuresgray_features

HALCON ScriptCpp++.NETPythonC

Short description

gray_featuresGrayFeaturesGrayFeaturesgray_featuresgray_features — Calculates gray value features for a set of regions.

Signature

gray_features( region Regions, image Image, string Features, out real Value )void GrayFeatures( const HObject& Regions, const HObject& Image, const HTuple& Features, HTuple* Value )static void HOperatorSet.GrayFeatures( HObject regions, HObject image, HTuple features, out HTuple value )def gray_features( regions: HObject, image: HObject, features: MaybeSequence[str] ) -> Sequence[float]

def gray_features_s( regions: HObject, image: HObject, features: MaybeSequence[str] ) -> floatHerror gray_features( const Hobject Regions, const Hobject Image, const char* Features, double* Value )

Herror T_gray_features( const Hobject Regions, const Hobject Image, const Htuple Features, Htuple* Value )

HTuple HRegion::GrayFeatures( const HImage& Image, const HTuple& Features ) const

double HRegion::GrayFeatures( const HImage& Image, const HString& Features ) const

double HRegion::GrayFeatures( const HImage& Image, const char* Features ) const

double HRegion::GrayFeatures( const HImage& Image, const wchar_t* Features ) const (Windows only)

HTuple HRegion.GrayFeatures( HImage image, HTuple features )

double HRegion.GrayFeatures( HImage image, string features )

Description

gray_featuresGrayFeatures has a set of regions (Regionsregionsregions) as input. For each of these regions the features (Featuresfeaturesfeatures) are calculated and returned in Valuevaluevalue.

Possible values for Featuresfeaturesfeatures:

• 'area'"area": Gray value volume of region (see area_center_grayAreaCenterGray)

• 'row'"row": Row index of the center of gravity (see area_center_grayAreaCenterGray)

• 'column'"column": Column index of the center of gravity (see area_center_grayAreaCenterGray)

• 'ra'"ra": Major axis of equivalent ellipse (see elliptic_axis_grayEllipticAxisGray)

• 'rb'"rb": Minor axis of equivalent ellipse (see elliptic_axis_grayEllipticAxisGray)

• 'phi'"phi": Orientation of equivalent ellipse (see elliptic_axis_grayEllipticAxisGray)

• 'min'"min": Minimum gray value (see min_max_grayMinMaxGray)

• 'max'"max": Maximum gray value (see min_max_grayMinMaxGray)

• 'median'"median": Median gray value (see min_max_grayMinMaxGray, with Percentpercentpercent=5050)

• 'mean'"mean":Mean gray value (see intensityIntensity)

• 'deviation'"deviation": Deviation of gray values (see intensityIntensity)

• 'plane_deviation'"plane_deviation": Deviation from the approximating plane (see plane_deviationPlaneDeviation)

• 'anisotropy'"anisotropy": Anisotropy (see entropy_grayEntropyGray)

• 'entropy'"entropy": Entropy (see entropy_grayEntropyGray)

• 'fuzzy_entropy'"fuzzy_entropy": Fuzzy entropy of region (see fuzzy_entropyFuzzyEntropy, with a fuzzy function from Aparaparapar=00 to Cparcparcpar=255255)

• 'fuzzy_perimeter'"fuzzy_perimeter": Fuzzy perimeter of region (see fuzzy_perimeterFuzzyPerimeter, with a fuzzy function from Aparaparapar=00 to Cparcparcpar=255255)

• 'moments_row'"moments_row": Mixed moments along a row (see moments_gray_planeMomentsGrayPlane)

• 'moments_column'"moments_column": Mixed moments along a column (see moments_gray_planeMomentsGrayPlane)

• 'alpha'"alpha": Approximating plane, parameter Alpha (see moments_gray_planeMomentsGrayPlane)

• 'beta'"beta": Approximating plane, parameter Beta (see moments_gray_planeMomentsGrayPlane)

Attention

Several features are processed in the order in which they are entered.

Note that the operator gray_featuresGrayFeatures only considers the given Regionsregionsregions and ignores any previously set domain of the input image Imageimageimage.

Execution information

Execution information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).

• Multithreading scope: global (may be called from any thread).

Parameters

Regionsregionsregions (input_object) region-array → objectHObjectHRegionHObjectHobject

Regions to be examined.

Imageimageimage (input_object) singlechannelimage → object (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)HImage (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)HObject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)Hobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Gray value image.

Featuresfeaturesfeatures (input_control) string(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Names of the features.

Default: 'mean'"mean"
List of values: 'alpha', 'anisotropy', 'area', 'beta', 'column', 'deviation', 'entropy', 'fuzzy_entropy', 'fuzzy_perimeter', 'max', 'mean', 'median', 'min', 'moments_column', 'moments_row', 'phi', 'plane_deviation', 'ra', 'rb', 'row'"alpha", "anisotropy", "area", "beta", "column", "deviation", "entropy", "fuzzy_entropy", "fuzzy_perimeter", "max", "mean", "median", "min", "moments_column", "moments_row", "phi", "plane_deviation", "ra", "rb", "row"

Valuevaluevalue (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Values of the features.

Complexity

If \(F\) is the area of the region and \(N\) the number of features the runtime complexity is \(O(F * N)\).

Result

The operator gray_featuresGrayFeatures returns the value 2 (H_MSG_TRUE) if the input image has the defined gray values and the parameters are correct. If necessary an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

connectionConnection, mean_imageMeanImage, entropy_imageEntropyImage, sobel_ampSobelAmp, median_separateMedianSeparate

Possible successors

select_graySelectGray, shape_transShapeTrans, reduce_domainReduceDomain, count_objCountObj

See also

select_graySelectGray, deviation_imageDeviationImage, entropy_grayEntropyGray, intensityIntensity, mean_imageMeanImage, min_max_grayMinMaxGray, select_objSelectObj

Module

Foundation