fast_threshold ( Image : Region : MinGray, MaxGray, MinSize : )

Fast thresholding of images using global thresholds.

fast_threshold selects the pixels from the input image whose gray values g fulfill the following condition:

             MinGray <= g <=  MaxGray .

To reduce procesing time, the selection is done in two steps: At first all pixels along rows and columns with distances MinSize are processed. In the next step the neighborhood (size MinSize x MinSize) of all previously selected points are processed.


Parameters

Image (input_object)
image(-array) -> object : byte / uint2 / direction / cyclic
Input image.

Region (output_object)
region(-array) -> object
Segmented regions.

MinGray (input_control)
number -> real / integer
Lower threshold for the gray values.
Default value: 128
Suggested values: 0.0, 10.0, 30.0, 64.0, 128.0, 200.0, 220.0, 255.0
Typical range of values: 0.0 <= MinGray <= 255.0 (lin)
Minimum increment: 1
Recommended increment: 5.0

MaxGray (input_control)
number -> real / integer
Upper threshold for the gray values.
Default value: 255.0
Suggested values: 0.0, 10.0, 30.0, 64.0, 128.0, 200.0, 220.0, 255.0
Typical range of values: 0.0 <= MaxGray <= 255.0 (lin)
Minimum increment: 1
Recommended increment: 5.0

MinSize (input_control)
number -> integer
Minimum size of objects to be extracted.
Default value: 20
Suggested values: 5, 10, 15, 20, 25, 30, 40, 50, 60, 70, 100
Typical range of values: 2 <= MinSize <= 200 (lin)
Minimum increment: 1
Recommended increment: 2


Complexity

Let A be the area of the ouput region and height the height of Image. Then the runtime complexity is O(A + height / MinSize).


Result

fast_threshold returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior with respect to the input images and output regions can be determined by setting the values of the flags 'no_object_result', 'empty_region_result', and 'store_empty_region' with set_system. If necessary, an exception is raised.


Parallelization Information

fast_threshold is reentrant and automatically parallelized (on tuple level).


Possible Predecessors

histo_to_thresh, min_max_gray, sobel_amp, gauss_image, reduce_domain, fill_interlace


Possible Successors

connection, dilation1, erosion1, opening, closing, rank_region, shape_trans, skeleton


Alternatives

threshold, gen_grid_region, dilation_rectangle1, dyn_threshold


See also

class_2dim_sup, hysteresis_threshold


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH