gray_featuresgray_featuresGrayFeaturesGrayFeatures (Operator)
Name
gray_featuresgray_featuresGrayFeaturesGrayFeatures
— Calculates gray value features for a set of regions.
Signature
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
- 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 →
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