golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements (Operator)

Name

golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements — Generate the structuring elements of the Golay alphabet.

Warning

golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements is obsolete and is only provided for reasons of backward compatibility.

Signature

Description

golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements generates the structuring elements from the Golay alphabet. The parameter GolayElementGolayElementGolayElementgolayElementgolay_element determines the name of the structuring element, while RotationRotationRotationrotationrotation determines its rotation. The structuring elements are intended for use in hit_or_misshit_or_missHitOrMissHitOrMisshit_or_miss: In StructElement1StructElement1StructElement1structElement1struct_element_1 the structuring element for the foreground is returned, while in StructElement2StructElement2StructElement2structElement2struct_element_2 the structuring element for the background is returned. RowRowRowrowrow and ColumnColumnColumncolumncolumn 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_elementsgolay_elementsGolayElementsGolayElementsgolay_elements only even values are accepted, and determine the Golay element for StructElement1StructElement1StructElement1structElement1struct_element_1. The next larger odd value is used for StructElement2StructElement2StructElement2structElement2struct_element_2. 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_elementsgolay_elementsGolayElementsGolayElementsgolay_elements). The element 'e' has only four possible rotations, and hence the rotation must be between 0 and 7 (for golay_elementsgolay_elementsGolayElementsGolayElementsgolay_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)

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

Result

golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements returns 2 ( H_MSG_TRUE) if all parameters are correct. Otherwise, an exception is raised.

Possible Successors

hit_or_misshit_or_missHitOrMissHitOrMisshit_or_miss

Alternatives

gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsgen_region_points, gen_struct_elementsgen_struct_elementsGenStructElementsGenStructElementsgen_struct_elements, gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledgen_region_polygon_filled

See also

dilation_golaydilation_golayDilationGolayDilationGolaydilation_golay, erosion_golayerosion_golayErosionGolayErosionGolayerosion_golay, opening_golayopening_golayOpeningGolayOpeningGolayopening_golay, closing_golayclosing_golayClosingGolayClosingGolayclosing_golay, hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay, thickening_golaythickening_golayThickeningGolayThickeningGolaythickening_golay

References

J. Serra: “Image Analysis and Mathematical Morphology”. Volume I. Academic Press, 1982

Module

Foundation