entropy1__ ( Image : ImageEntropy : Width, Height : )

Calculate the entropy of gray values within a rectangular window.

entropy1__ 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.


Parameters

Image (input_object)
image(-array) -> object : byte
Image for which the entropy is to be calculated.

ImageEntropy (output_object)
image(-array) -> object : byte
Entropy image.

Width (input_control)
extent.x -> integer
Width of the mask in which the entropy is calculated.
Default value: 9
List of values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25
Suggested values: 3, 5, 7, 9, 11, 13, 15
Restriction: (3 <= Width) && odd(Width)

Height (input_control)
extent.y -> integer
Height of the mask in which the entropy is calculated.
Default value: 9
List of values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25
Suggested values: 3, 5, 7, 9, 11, 13, 15
Restriction: (3 <= Height) && odd(Height)


Example
read_image(:Image:'fabrik':) >
disp_image(Image:::)
entropy1__(Image:Entropy1:9,9:) >
disp_image(Entropy1:::).

Result

entropy1__ returns TRUE if all parameters are correct. If the input is empty the behaviour can be set via set_system(::'no_object_result',<Result>:). If necessary, an exception is raised.


Possible Successors

disp_image


Alternatives

entropy2__


See also

energy__, entropy2__



Copyright © 1996-1997 MVTec Software GmbH