Operator Reference

HALCON Operator Reference / Image / Features

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

gray_featuresgray_featuresGrayFeaturesGrayFeaturesgray_features (Operator)

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

Signature

gray_features(Regions, Image : : Features : Value)

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

void GrayFeatures(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)

static void HOperatorSet.GrayFeatures(HObject regions, HObject image, HTuple features, out HTuple value)

HTuple HRegion.GrayFeatures(HImage image, HTuple features)

double HRegion.GrayFeatures(HImage image, string features)

def gray_features(regions: HObject, image: HObject, features: MaybeSequence[str]) -> Sequence[float]

def gray_features_s(regions: HObject, image: HObject, features: MaybeSequence[str]) -> float

Description

gray_featuresgray_featuresGrayFeaturesGrayFeaturesgray_features has a set of regions (RegionsRegionsRegionsregionsregions) as input. For each of these regions the features (FeaturesFeaturesFeaturesfeaturesfeatures) are calculated and returned in ValueValueValuevaluevalue.

Possible values for FeaturesFeaturesFeaturesfeaturesfeatures:

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

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

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

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

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

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

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

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

• 'median'"median""median""median""median": Median gray value (see min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray, with PercentPercentPercentpercentpercent=50)

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

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

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

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

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

• 'fuzzy_entropy'"fuzzy_entropy""fuzzy_entropy""fuzzy_entropy""fuzzy_entropy": Fuzzy entropy of region (see fuzzy_entropyfuzzy_entropyFuzzyEntropyFuzzyEntropyfuzzy_entropy, with a fuzzy function from AparAparAparaparapar=0 to CparCparCparcparcpar=255)

• 'fuzzy_perimeter'"fuzzy_perimeter""fuzzy_perimeter""fuzzy_perimeter""fuzzy_perimeter": Fuzzy perimeter of region (see fuzzy_perimeterfuzzy_perimeterFuzzyPerimeterFuzzyPerimeterfuzzy_perimeter, with a fuzzy function from AparAparAparaparapar=0 to CparCparCparcparcpar=255)

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

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

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

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

Attention

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

Note that the operator gray_featuresgray_featuresGrayFeaturesGrayFeaturesgray_features only considers the given RegionsRegionsRegionsregionsregions and ignores any previously set domain of the input image ImageImageImageimageimage.

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

RegionsRegionsRegionsregionsregions (input_object)  region-array → objectHRegionHObjectHObjectHobject

Regions to be examined.

ImageImageImageimageimage (input_object)  singlechannelimage → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Gray value image.

FeaturesFeaturesFeaturesfeaturesfeatures (input_control)  string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Names of the features.

Default: 'mean' "mean" "mean" "mean" "mean"

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

ValueValueValuevaluevalue (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (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_featuresgray_featuresGrayFeaturesGrayFeaturesgray_features 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.

Possible Predecessors

connectionconnectionConnectionConnectionconnection, mean_imagemean_imageMeanImageMeanImagemean_image, entropy_imageentropy_imageEntropyImageEntropyImageentropy_image, sobel_ampsobel_ampSobelAmpSobelAmpsobel_amp, median_separatemedian_separateMedianSeparateMedianSeparatemedian_separate

Possible Successors

select_grayselect_graySelectGraySelectGrayselect_gray, shape_transshape_transShapeTransShapeTransshape_trans, reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, count_objcount_objCountObjCountObjcount_obj

See also

select_grayselect_graySelectGraySelectGrayselect_gray, deviation_imagedeviation_imageDeviationImageDeviationImagedeviation_image, entropy_grayentropy_grayEntropyGrayEntropyGrayentropy_gray, intensityintensityIntensityIntensityintensity, mean_imagemean_imageMeanImageMeanImagemean_image, min_max_graymin_max_grayMinMaxGrayMinMaxGraymin_max_gray, select_objselect_objSelectObjSelectObjselect_obj

Module

Foundation

---

ClassesClasses | | Operators