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) -> Hobject: HRegion(Array) |
| Regions to be processed. | |
|
StructElement (input_object) |
region -> Hobject: HRegion |
| Structuring element (position independent). | |
|
RegionTopHat (output_object) |
region(-array) -> Hobject * : HRegion(Array) |
| Result of the top hat operator. | |
::top_hat returns 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.
::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
