golay_elements🔗
Short description🔗
golay_elements — Generate the structuring elements of the Golay alphabet.
Warning🔗
golay_elements is obsolete and is only provided for
reasons of backward compatibility.
Signature🔗
golay_elements( out region StructElement1, out region StructElement2, string GolayElement, integer Rotation, point.y Row, point.x Column )
Description🔗
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
[\(\bullet\)] Foreground pixel
[\(\circ\)] Background pixel
[\(\cdot\)] 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)
Execution information🔗
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Processed without parallelization.
Parameters🔗
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: '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: 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: 16
Suggested values: 0, 16, 32, 128, 256
Value range: 0 ≤ Row ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1
Column (input_control) point.x → (integer)
Column coordinate of the reference point.
Default: 16
Suggested values: 0, 16, 32, 128, 256
Value range: 0 ≤ Column ≤ 511 (lin)
Minimum increment: 1
Recommended increment: 1
Result🔗
golay_elements returns 2 (H_MSG_TRUE) if all parameters are
correct. Otherwise, an exception is raised.
Combinations with other operators🔗
Combinations
Possible successors
Alternatives
gen_region_points, gen_struct_elements, gen_region_polygon_filled
See also
dilation_golay, erosion_golay, opening_golay, closing_golay, hit_or_miss_golay, thickening_golay
References🔗
J. Serra: “Image Analysis and Mathematical Morphology”. Volume I. Academic Press, 1982
Module🔗
Foundation