gray_bothatgray_bothatGrayBothatGrayBothat (Operator)

Name

gray_bothatgray_bothatGrayBothatGrayBothat — Perform a gray value bottom hat transformation on an image.

Signature

gray_bothat(Image, SE : ImageBotHat : : )

gray_bothatgray_bothatGrayBothatGrayBothatGrayBothat applies a gray value bottom hat transformation to the input image ImageImageImageImageimage with the structuring element SESESESESE. The image type of the structuring element SESESESESE must match the image type of the input image ImageImageImageImageimage. The gray value bottom hat transformation of an image i with a structuring element s is defined as

i.e., the difference of the closing of the image with s and the image (see gray_closinggray_closingGrayClosingGrayClosingGrayClosing). For the generation of structuring elements, see read_gray_seread_gray_seReadGraySeReadGraySeReadGraySe.

The gray value erosion is particularly fast for flat structuring elements, i.e. structuring elements with a constant gray level within their domain.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.
Automatically parallelized on channel level.
Automatically parallelized on internal data level.

Parameters

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte / uint2 / real)

Input image.

SESESESESE (input_object) singlechannelimage → object (byte / uint2 / real)

Structuring element.

ImageBotHatImageBotHatImageBotHatImageBotHatimageBotHat (output_object) (multichannel-)image(-array) → object (byte / uint2 / real)

Bottom hat image.

Result

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