Compute the top hat of regions.
top_hat computes the opening of Region with StructElement. The difference between the original region and the result of the opening is called the top hat. In contrast to opening, which splits regions under certain circumstances, top_hat computes the regions removed by such a splitting.
The position of StructElement is meaningless, since an opening operation is invariant with respect to the choice of the reference point.
Structuring elements (StructElement) can be generated with operators such as gen_circle, gen_rectangle1, gen_rectangle2, gen_ellipse, draw_region, gen_region_polygon, gen_region_points, etc.
|
Region (input_object) |
region(-array) -> object |
| Regions to be processed. | |
|
StructElement (input_object) |
region -> object |
| Structuring element (position independent). | |
|
RegionTopHat (output_object) |
region(-array) -> object |
| Result of the top hat operator. | |
top_hat returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via:
a) no region: set_system('no_object_result',<RegionResult>)
b) empty region: set_system('empty_region_result',<RegionResult>)
Otherwise, an exception is raised.
top_hat is reentrant and automatically parallelized (on tuple level).
threshold, regiongrowing, connection, union1, watersheds, class_ndim_norm, gen_circle, gen_ellipse, gen_rectangle1, gen_rectangle2, draw_region, gen_region_points, gen_struct_elements, gen_region_polygon_filled
reduce_domain, select_shape, area_center, connection
bottom_hat, morph_hat, gray_tophat, opening
Morphology
