gray_tophat ( Image, SE : ImageTopHat : : )

Perform a gray value top hat transformation on an image.

gray_tophat applies a gray value top hat transformation to the input image Image with the structuring element SE. The gray value top hat transformation of an image i with a structuring element s is defined as

  tophat(i,s) = i - (i -+ s) ,
i.e., the difference of the image and its opening with s (see gray_opening). For the generation of structuring elements, see read_gray_se.


Parameters

Image (input_object)
image(-array) -> object : byte / real
Input image.

SE (input_object)
image -> object : byte
Structuring element.

ImageTopHat (output_object)
image(-array) -> object : byte / real
Top hat image.


Result

gray_tophat returns 2 (H_MSG_TRUE) if the structuring element is not the empty region. Otherwise, an exception is raised.


Parallelization Information

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


Possible Predecessors

read_gray_se, gen_disc_se


Possible Successors

threshold


Alternatives

gray_opening


See also

gray_bothat, top_hat, gray_erosion_rect, sub_image


Module

Foundation



Copyright © 1996-2008 MVTec Software GmbH