golay_elements — Generate the structuring elements of the Golay alphabet.
golay_elements is obsolete and is only provided for
reasons of backward compatibility.
golay_elements( : StructElement1, StructElement2 : GolayElement, Rotation, Row, Column : )
golay_elements generates the structuring elements from
the Golay alphabet. The parameter GolayElement
determines the name of the structuring element, while
Rotation determines its rotation. The structuring
elements are intended for use in hit_or_miss: In
StructElement1 the structuring element for the foreground
is returned, while in StructElement2 the structuring
element for the background is returned. Row and
Column determine the reference point of the structuring
element.
The rotations are numbered from 0 to 15. This does not mean, however, that there are 16 different rotations: Even values denote rotations of the foreground elements, while odd values denote rotations of the background elements.
For golay_elements only even values are accepted, and
determine the Golay element for StructElement1. The next
larger odd value is used for StructElement2. There are
no rotations for the Golay elements 'h' and 'i'. Therefore, only
the values 0 and 1 are possible as “rotations” (and hence only 0
for golay_elements). The element 'e' has only four
possible rotations, and hence the rotation must be between 0 and 7
(for golay_elements the values 0, 2, 4, or 6 must be
used).
The tables below show the elements of the Golay alphabet with all possible rotations. The characters used have the following meaning: * Foreground pixel o Background pixel . Don't care pixel The names of the elements and their rotation numbers are displayed below the respective element. The elements with even number contain the foreground pixels, while the elements with odd numbers contain the background pixels. * * * * * * * * * h(0,1) o o o o o o o o o i(0,1) . . . o o . o o o . o o o * o o * . o * o . * o o o o o o . . . . . o o e(0,1) e(2,3) e(4,5) e(6,7) o * * o o o o . . o * . o * . . * * * . . * o . * o . . . * . * . * . o * * o * . * . o . * . o . * . * o * * o . * * * * * * . . * . o . . o o o o o . . o . * . . * * o o * l(0,1) l(2,3) l(4,5) l(6,7) l(8,9) l(10,11) l(12,13) l(14,15) * * . . * . . * . . * * * . . * . . * o . . . o . . . o * * o * . * . . . * . . . * . * o * * . . * . * . * . * . * . . * . . . . o . o . o . . . . * . . * * * * * . . . . * * m(0,1) m(2,3) m(4,5) m(6,7) m(8,9) m(10,11) m(12,13) m(14,15) o o . . o . . o . . o o o . . o . . o * . . . * . . . * o * * o . * . . . * . . . * . o * * o . . * . o . * . o . * . . o . . . . * . * . * . . . . o . . o o o o o . . . . o o d(0,1) d(2,3) d(4,5) d(6,7) d(8,9) d(10,11) d(12,13) d(14,15) * * o o * o o o * o * o * o * o o o * * . o o * o o . * o * * * * * . o o * o o . * * * * * o o . * * * o * o * * * . o * o o o . * o * o * . o o o * o * o * o * o * o o o * * f(0,1) f(2,3) f(4,5) f(6,7) f(8,9) f(10,11) f(12,13) f(14,15) * o o * * * * o . * o o * o . o o o o o . o * o o * . o o * o o . * . * o * * o . * . * o * o * . * . o * * o * . * . o o o o o . o o o * o . * * * * * . o * o o o . o o * * o f2(0,1) f2(2,3) f2(4,5) f2(6,7) f2(8,9) f2(10,11)f2(12,13) f2(14,15) * . . o * * o . . * . . * . . . . . . . . . o . . * . . . * . . . * . o . * * . . * . * . * . o . * . . * * . * . * . . . . . . . . . . o . . * o * * * . . * . . . . . . o * . k(0,1) k(2,3) k(4,5) k(6,7) k(8,9) k(10,11) k(12,13) k(14,15) * . . * * * * * . . * . . . . . * o . * . . . o . . . * . o * . . . . o . . . . * . . * . o . . . . . . . o . * . . * . . o * * * * * o . . . . . . . . . . * * . . . . * * c(0,1) c(2,3) c(4,5) c(6,7) c(8,9) c(10,11) c(12,13) c(14,15)
StructElement1 (output_object) region → object
Structuring element for the foreground.
StructElement2 (output_object) region → object
Structuring element for the background.
GolayElement (input_control) string → (string)
Name of the structuring element.
Default value: 'l'
List of values: 'c', 'd', 'e', 'f', 'f2', 'h', 'i', 'k', 'l', 'm'
Rotation (input_control) integer → (integer)
Rotation of the Golay element. Depending on the element, not all rotations are valid.
Default value: 0
List of values: 0, 2, 4, 6, 8, 10, 12, 14
Row (input_control) point.y → (integer)
Row coordinate of the reference point.
Default value: 16
Suggested values: 0, 16, 32, 128, 256
Typical range of values: 0
≤
Row
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
Column (input_control) point.x → (integer)
Column coordinate of the reference point.
Default value: 16
Suggested values: 0, 16, 32, 128, 256
Typical range of values: 0
≤
Column
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
golay_elements returns 2 (H_MSG_TRUE) if all parameters are
correct. Otherwise, an exception is raised.
gen_region_points,
gen_struct_elements,
gen_region_polygon_filled
dilation_golay,
erosion_golay,
opening_golay,
closing_golay,
hit_or_miss_golay,
thickening_golay
J. Serra: “Image Analysis and Mathematical Morphology”. Volume I. Academic Press, 1982
Foundation