tshape_histo2 ( Region, Image : : Feature, Row, Column : AbsoluteHisto, RelativeHisto )

Determine a histogram of features along all threshold values.

Like tshape_histo1 the operator tshape_histo2 carries out 255 threshold value operations within Region with the gray values of Image. Contrary to tshape_histo1 only the segmented region containing the pixel (Row, Column) is taken into account here. The entry i in the histogram then corresponds to the number of holes of this region segmented with the threshold i (Feature = 'holes') or the feature value of the region (Feature = 'convexity', 'compactness', 'ansisometry'), respectively.

The histogram can also be displayed directly as a graphic via the operators set_paint(::'component_histogram':) and disp_image.


Parameters

Region (input_object)
region -> object
Region in which the features are to be examined.

Image (input_object)
image -> object : byte
Gray value image.

Feature (input_control)
string -> string
Feature to be examined.
Default value: 'convexity'
List of values: 'convexity', 'compactness', 'anisometry', 'holes'

Row (input_control)
point.y -> integer
Row of the pixel which the region must contain.
Default value: 256
Suggested values: 10, 50, 100, 200, 300, 400

Column (input_control)
point.x -> integer
Column of the pixel which the region must contain.
Default value: 256
Suggested values: 10, 50, 100, 200, 300, 400

AbsoluteHisto (output_control)
histogram.values-array -> real / integer
Absolute distribution of the feature.

RelativeHisto (output_control)
histogram.values-array -> real
Relative distribution of the feature.


Result

The operator tshape_histo2 returns the value TRUE if an image with defined gray values is entered. The behavior in case of empty input (no input images available) is set via the operator set_system(::'no_object_result',<Result>:), the behavior in case of empty region is set via set_system(::'empty_region_result',<Result>:). If necessary an exception is raised.


Possible Predecessors

get_mbutton, area_center


Possible Successors

histo_to_thresh, threshold__, histo_to_region


Alternatives

tshape_histo1


See also

connection, connect_and_holes, convexity, compactness, set_paint



Copyright © 1996-1997 MVTec Software GmbH