entropy_image — Calculate the entropy of gray values within a rectangular window.
entropy_image(Image : ImageEntropy : Width, Height : )
entropy_image calculates the entropy of gray values in the
image Image within a rectangular mask of size
(Height, Width). The resulting image is
returned in ImageEntropy, in which the entropy is
multiplied by 32. If the parameters Height and
Width 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.
Image (input_object) (multichannel-)image(-array) → object (byte)
Image for which the entropy is to be calculated.
ImageEntropy (output_object) (multichannel-)image(-array) → object (byte)
Entropy image.
Width (input_control) extent.x → (integer)
Width of the mask in which the entropy is calculated.
Default: 9
Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25
Restriction:
3 <= Width && odd(Width)
Height (input_control) extent.y → (integer)
Height of the mask in which the entropy is calculated.
Default: 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)
entropy_image returns 2 (
H_MSG_TRUE)
if all parameters are correct.
If the input is empty the behavior can be set via
set_system('no_object_result',<Result>). If
necessary, an exception is raised.
Foundation