select_grayselect_graySelectGraySelectGray (Operator)

Name

select_grayselect_graySelectGraySelectGray — Select regions based on gray value features.

Signature

Description

The operator select_grayselect_graySelectGraySelectGraySelectGray has a number of regions (RegionsRegionsRegionsRegionsregions) as input. For each of these regions the features (FeaturesFeaturesFeaturesFeaturesfeatures) are calculated. If each (OperationOperationOperationOperationoperation = 'and') or at least one (OperationOperationOperationOperationoperation = 'or') of the calculated features is within the limits determined by the parameter, the region is transferred (duplicated) into the output. The parameter ImageImageImageImageimage contains an image which returns the gray values for calculating the features. Condition:

  '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

Note that the operator select_grayselect_graySelectGraySelectGraySelectGray only considers the given RegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input image ImageImageImageImageimage. If only one feature is used the value of OperationOperationOperationOperationoperation is meaningless. Several features are processed in the order in which they are entered. The maximum number of features is limited to 100.

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

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 select_grayselect_graySelectGraySelectGraySelectGray 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>)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>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

connectionconnectionConnectionConnectionConnection, mean_imagemean_imageMeanImageMeanImageMeanImage, entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage, sobel_ampsobel_ampSobelAmpSobelAmpSobelAmp, median_separatemedian_separateMedianSeparateMedianSeparateMedianSeparate

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, shape_transshape_transShapeTransShapeTransShapeTrans, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, count_objcount_objCountObjCountObjCountObj

See also

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray, intensityintensityIntensityIntensityIntensity, mean_imagemean_imageMeanImageMeanImageMeanImage, min_max_graymin_max_grayMinMaxGrayMinMaxGrayMinMaxGray, select_objselect_objSelectObjSelectObjSelectObj

Module

Foundation