entropy_imageentropy_imageEntropyImageEntropyImage (Operator)

Name

entropy_imageentropy_imageEntropyImageEntropyImage — Calculate the entropy of gray values within a rectangular window.

entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage calculates the entropy of gray values in the image ImageImageImageImageimage within a rectangular mask of size (HeightHeightHeightHeightheight, WidthWidthWidthWidthwidth). The resulting image is returned in ImageEntropyImageEntropyImageEntropyImageEntropyimageEntropy, in which the entropy is multiplied by 32. If the parameters HeightHeightHeightHeightheight and WidthWidthWidthWidthwidth are even, they are changed to the next larger odd value. At the image borders the gray values are mirrored.

Note that filter operators may return unexpected results if an image with a reduced domain is used as input. Please refer to the chapter Filters.

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte)

Image for which the entropy is to be calculated.

ImageEntropyImageEntropyImageEntropyImageEntropyimageEntropy (output_object) (multichannel-)image(-array) → object (byte)

Entropy image.

WidthWidthWidthWidthwidth (input_control) extent.x → (integer)

Width of the mask in which the entropy is calculated.

Default value: 9

Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriction: 3 <= Width && odd(Width)

HeightHeightHeightHeightheight (input_control) extent.y → (integer)

Height of the mask in which the entropy is calculated.

Default value: 9

Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriction: 3 <= Height && odd(Height)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
entropy_image(Image,&Entropy,9,9);
disp_image(Entropy,WindowHandle);

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

read_image(Image,'fabrik')
dev_display(Image)
entropy_image(Image,Entropy,9,9)
dev_display(Entropy)

entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage returns 2 (H_MSG_TRUE) if all parameters are correct. If the input is empty the behaviour can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If necessary, an exception is raised.

Foundation