Name
select_grayselect_graySelectGrayselect_graySelectGraySelectGray — Select regions based on gray value features.
Herror select_gray(const Hobject Regions, const Hobject Image, Hobject* SelectedRegions, const char* Features, const char* Operation, double Min, double Max)
Herror T_select_gray(const Hobject Regions, const Hobject Image, Hobject* SelectedRegions, const Htuple Features, const Htuple Operation, const Htuple Min, const Htuple Max)
Herror select_gray(Hobject Regions, Hobject Image, Hobject* SelectedRegions, const HTuple& Features, const HTuple& Operation, const HTuple& Min, const HTuple& Max)
HRegionArray HRegionArray::SelectGray(const HImage& Image, const HTuple& Features, const HTuple& Operation, const HTuple& Min, const HTuple& Max) const
void SelectGray(const HObject& Regions, const HObject& Image, HObject* SelectedRegions, const HTuple& Features, const HTuple& Operation, const HTuple& Min, const HTuple& Max)
HRegion HRegion::SelectGray(const HImage& Image, const HTuple& Features, const HString& Operation, const HTuple& Min, const HTuple& Max) const
HRegion HRegion::SelectGray(const HImage& Image, const HString& Features, const HString& Operation, double Min, double Max) const
HRegion HRegion::SelectGray(const HImage& Image, const char* Features, const char* Operation, double Min, double Max) const
void HOperatorSetX.SelectGray(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [out] IHUntypedObjectX** SelectedRegions, [in] VARIANT Features, [in] VARIANT Operation, [in] VARIANT Min, [in] VARIANT Max)
IHRegionX* HRegionX.SelectGray(
[in] IHImageX* Image, [in] VARIANT Features, [in] BSTR Operation, [in] VARIANT Min, [in] VARIANT Max)
static void HOperatorSet.SelectGray(HObject regions, HObject image, out HObject selectedRegions, HTuple features, HTuple operation, HTuple min, HTuple max)
HRegion HRegion.SelectGray(HImage image, HTuple features, string operation, HTuple min, HTuple max)
HRegion HRegion.SelectGray(HImage image, string features, string operation, double min, double max)
The operator select_grayselect_graySelectGrayselect_graySelectGraySelectGray has a number of regions
(RegionsRegionsRegionsRegionsRegionsregions) as input. For each of these regions the
(FeaturesFeaturesFeaturesFeaturesFeaturesfeatures) are calculated. The region is transferred (duplicated)
into the output SelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsSelectedRegionsselectedRegions, if each
(OperationOperationOperationOperationOperationoperation = 'and') or at least one (OperationOperationOperationOperationOperationoperation
= 'or') of the calculated features is within the limits.
The limits are defined by the parameters MinMinMinMinMinmin and MaxMaxMaxMaxMaxmax.
Thereby, MinMinMinMinMinmin and MaxMaxMaxMaxMaxmax can also be set to 'min'"min""min""min""min""min"
or 'max'"max""max""max""max""max", respectively, corresponding to setting the smallest
or largest value possible for this feature.
The parameter ImageImageImageImageImageimage contains an image which returns the gray
values for calculating the features.
Condition:
- '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)
- 'median'
Median gray value (see min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray,
with Percent=50)
- '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)
Note that the operator select_grayselect_graySelectGrayselect_graySelectGraySelectGray only considers
the given RegionsRegionsRegionsRegionsRegionsregions and ignores any previously set domain
of the input image ImageImageImageImageImageimage.
If only one feature is used the value of OperationOperationOperationOperationOperationoperation is
meaningless. Several features are processed in the order in which
they are entered. The maximum number of features is limited to 100.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Regions having features within the limits.
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", 'median'"median""median""median""median""median", '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"
Logical connection of features.
Default value:
'and'
"and"
"and"
"and"
"and"
"and"
List of values: 'and'"and""and""and""and""and", 'or'"or""or""or""or""or"
MinMinMinMinMinmin (input_control) number(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Lower limit(s) of features or 'min'.
Default value: 128.0
Suggested values: 0.5, 1.0, 10.0, 20.0, 50.0, 128.0, 255.0, 1000.0
MaxMaxMaxMaxMaxmax (input_control) number(-array) → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)
Upper limit(s) of features or 'max'.
Default value: 255.0
Suggested values: 0.5, 1.0, 10.0, 20.0, 50.0, 128.0, 255.0, 1000.0
If F is the area of the region and N the number of features
the runtime complexity is O(F * N).
The operator select_grayselect_graySelectGrayselect_graySelectGraySelectGray returns the value 2 (H_MSG_TRUE) if the
input image has the defined gray values and the parameters are
correct. The behavior in case of empty input (no input images
available) is set via the operator
set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>),
the behavior in case of empty region is set via
set_system(::'empty_region_result',<Result>:)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>).
If necessary an exception is raised.
connectionconnectionConnectionconnectionConnectionConnection,
mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage,
entropy_imageentropy_imageEntropyImageentropy_imageEntropyImageEntropyImage,
sobel_ampsobel_ampSobelAmpsobel_ampSobelAmpSobelAmp,
median_separatemedian_separateMedianSeparatemedian_separateMedianSeparateMedianSeparate
select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape,
shape_transshape_transShapeTransshape_transShapeTransShapeTrans,
reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain,
count_objcount_objCountObjcount_objCountObjCountObj
deviation_imagedeviation_imageDeviationImagedeviation_imageDeviationImageDeviationImage,
entropy_grayentropy_grayEntropyGrayentropy_grayEntropyGrayEntropyGray,
intensityintensityIntensityintensityIntensityIntensity,
mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage,
min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray,
select_objselect_objSelectObjselect_objSelectObjSelectObj
Foundation