ClassesClassesClassesClasses | | | | Operators

gray_featuresgray_featuresGrayFeaturesgray_featuresGrayFeaturesGrayFeatures (Operator)

Name

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

Herror gray_features(Hobject Regions, Hobject Image, const HTuple& Features, double* Value)

Herror gray_features(Hobject Regions, Hobject Image, const HTuple& Features, HTuple* Value)

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

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

void HOperatorSetX.GrayFeatures(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [in] VARIANT Features, [out] VARIANT* Value)

VARIANT HRegionX.GrayFeatures(
[in] IHImageX* Image, [in] VARIANT Features)

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)

Description

gray_featuresgray_featuresGrayFeaturesgray_featuresGrayFeaturesGrayFeatures has a set of regions (RegionsRegionsRegionsRegionsRegionsregions) as input. For each of these regions the features (FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) are calculated and returned in ValueValueValueValueValuevalue. Possble values for FeaturesFeaturesFeaturesFeaturesFeaturesfeatures:

'area'

Gray value volume of region (see area_center_grayarea_center_grayAreaCenterGrayarea_center_grayAreaCenterGrayAreaCenterGray)

'row'

Row index of the center of gravity (see area_center_grayarea_center_grayAreaCenterGrayarea_center_grayAreaCenterGrayAreaCenterGray)

'column'

Column index of the center of gravity (see area_center_grayarea_center_grayAreaCenterGrayarea_center_grayAreaCenterGrayAreaCenterGray)

'ra'

Major axis of equivallent ellipse (see elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray)

'rb'

Minor axis of equivallent ellipse (see elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray)

'phi'

Orientation of equivallent ellipse (see elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayelliptic_axis_grayEllipticAxisGrayEllipticAxisGray)

'min'

Minimum gray value (see min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray)

'max'

Maximum gray value (see min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray)

'mean'

Mean gray value (see intensityintensityIntensityintensityIntensityIntensity)

'deviation'

Deviation of gray values (see intensityintensityIntensityintensityIntensityIntensity)

'plane_deviation'

Deviation from the approximating plane (see plane_deviationplane_deviationPlaneDeviationplane_deviationPlaneDeviationPlaneDeviation)

'anisotropy'

Anisotropy (see entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray)

'entropy'

Entropy (see entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray)

'fuzzy_entropy'

Fuzzy entropie of region (see fuzzy_entropyfuzzy_entropyFuzzyEntropyfuzzy_entropyFuzzyEntropyFuzzyEntropy, with a fuzzy function from Apar=0 to Cpar=255)

'fuzzy_perimeter'

Fuzzy perimeter of region (see fuzzy_perimeterfuzzy_perimeterFuzzyPerimeterfuzzy_perimeterFuzzyPerimeterFuzzyPerimeter, with a fuzzy function from Apar=0 to Cpar=255)

'moments_row'

Mixed moments along a row (see moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

'moments_column'

Mixed moments along a column (see moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

'alpha'

Approximating plane, parameter Alpha (see moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

'beta'

Approximating plane, parameter Beta (see moments_gray_planemoments_gray_planeMomentsGrayPlanemoments_gray_planeMomentsGrayPlaneMomentsGrayPlane)

Attention

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

Note that the operator gray_featuresgray_featuresGrayFeaturesgray_featuresGrayFeaturesGrayFeatures only considers the given RegionsRegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input image ImageImageImageImageImageimage.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject

Regions to be examined.

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Gray value image.

FeaturesFeaturesFeaturesFeaturesFeaturesfeatures (input_control)  string(-array) HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Names of the features.

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

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

ValueValueValueValueValuevalue (output_control)  real(-array) HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Value sof 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_featuresGrayFeaturesgray_featuresGrayFeaturesGrayFeatures 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

connectionconnectionConnectionconnectionConnectionConnection, mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage, entropy_imageentropy_imageEntropyImageentropy_imageEntropyImageEntropyImage, sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp, median_separatemedian_separateMedianSeparatemedian_separateMedianSeparateMedianSeparate

Possible Successors

select_grayselect_graySelectGrayselect_graySelectGraySelectGray, shape_transshape_transShapeTransshape_transShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, count_objcount_objCountObjcount_objCountObjCountObj

See also

select_grayselect_graySelectGrayselect_graySelectGraySelectGray, deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage, entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray, intensityintensityIntensityintensityIntensityIntensity, mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage, min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray, select_objselect_objSelectObjselect_objSelectObjSelectObj

Module

Foundation


ClassesClassesClassesClasses | | | | Operators