gray_featuresgray_featuresGrayFeaturesGrayFeatures (Operator)

Name

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

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)

Description

gray_featuresgray_featuresGrayFeaturesGrayFeaturesGrayFeatures has a set of regions (RegionsRegionsRegionsRegionsregions) as input. For each of these regions the features (FeaturesFeaturesFeaturesFeaturesfeatures) are calculated and returned in ValueValueValueValuevalue. Possble values for FeaturesFeaturesFeaturesFeaturesfeatures:

'area'

Gray value volume of region (see area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray)

'row'

Row index of the center of gravity (see area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray)

'column'

Column index of the center of gravity (see area_center_grayarea_center_grayAreaCenterGrayAreaCenterGrayAreaCenterGray)

'ra'

Major axis of equivallent ellipse (see elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayEllipticAxisGray)

'rb'

Minor axis of equivallent ellipse (see elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayEllipticAxisGray)

'phi'

Orientation of equivallent ellipse (see elliptic_axis_grayelliptic_axis_grayEllipticAxisGrayEllipticAxisGrayEllipticAxisGray)

'min'

Minimum gray value (see min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray)

'max'

Maximum gray value (see min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray)

'median'

Median gray value (see min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, with Percent=50)

'mean'

Mean gray value (see intensityintensityIntensityIntensityIntensity)

'deviation'

Deviation of gray values (see intensityintensityIntensityIntensityIntensity)

'plane_deviation'

Deviation from the approximating plane (see plane_deviationplane_deviationPlaneDeviationPlaneDeviationPlaneDeviation)

'anisotropy'

Anisotropy (see entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray)

'entropy'

Entropy (see entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray)

'fuzzy_entropy'

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

'fuzzy_perimeter'

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

'moments_row'

Mixed moments along a row (see moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

'moments_column'

Mixed moments along a column (see moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

'alpha'

Approximating plane, parameter Alpha (see moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

'beta'

Approximating plane, parameter Beta (see moments_gray_planemoments_gray_planeMomentsGrayPlaneMomentsGrayPlaneMomentsGrayPlane)

Attention

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

Note that the operator gray_featuresgray_featuresGrayFeaturesGrayFeaturesGrayFeatures only considers the given RegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input image ImageImageImageImageimage.

Execution Information

Parameters

RegionsRegionsRegionsRegionsregions (input_object)  region-array objectHRegionHRegionHobject

Regions to be examined.

ImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

Gray value image.

FeaturesFeaturesFeaturesFeaturesfeatures (input_control)  string(-array) HTupleHTupleHtuple (string) (string) (HString) (char*)

Names of the features.

Default value: '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) HTupleHTupleHtuple (real) (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_featuresGrayFeaturesGrayFeaturesGrayFeatures 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_imageMeanImageMeanImageMeanImage, entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage, sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparate

Possible Successors

select_grayselect_graySelectGraySelectGraySelectGray, shape_transshape_transShapeTransShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, count_objcount_objCountObjCountObjCountObj

See also

select_grayselect_graySelectGraySelectGraySelectGray, deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray, intensityintensityIntensityIntensityIntensity, mean_imagemean_imageMeanImageMeanImageMeanImage, min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, select_objselect_objSelectObjSelectObjSelectObj

Module

Foundation