HALCON 17.12 / HALCON Operator Reference / Legacy / Morphology
ClassesClasses | | Operators

golay_elementsgolay_elementsGolayElementsGolayElements (Operator)

Name

golay_elementsgolay_elementsGolayElementsGolayElements — Generate the structuring elements of the Golay alphabet.

Warning

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

Signature

golay_elements( : StructElement1, StructElement2 : GolayElement, Rotation, Row, Column : )

Herror golay_elements(Hobject* StructElement1, Hobject* StructElement2, const char* GolayElement, const Hlong Rotation, const Hlong Row, const Hlong Column)

Herror T_golay_elements(Hobject* StructElement1, Hobject* StructElement2, const Htuple GolayElement, const Htuple Rotation, const Htuple Row, const Htuple Column)

void GolayElements(HObject* StructElement1, HObject* StructElement2, const HTuple& GolayElement, const HTuple& Rotation, const HTuple& Row, const HTuple& Column)

HRegion HRegion::GolayElements(const HString& GolayElement, Hlong Rotation, Hlong Row, Hlong Column)

HRegion HRegion::GolayElements(const char* GolayElement, Hlong Rotation, Hlong Row, Hlong Column)

static void HOperatorSet.GolayElements(out HObject structElement1, out HObject structElement2, HTuple golayElement, HTuple rotation, HTuple row, HTuple column)

HRegion HRegion.GolayElements(string golayElement, int rotation, int row, int column)

Description

golay_elementsgolay_elementsGolayElementsGolayElementsGolayElements generates the structuring elements from the Golay alphabet. The parameter GolayElementGolayElementGolayElementGolayElementgolayElement determines the name of the structuring element, while RotationRotationRotationRotationrotation determines its rotation. The structuring elements are intended for use in hit_or_misshit_or_missHitOrMissHitOrMissHitOrMiss: In StructElement1StructElement1StructElement1StructElement1structElement1 the structuring element for the foreground is returned, while in StructElement2StructElement2StructElement2StructElement2structElement2 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_elementsGolayElementsGolayElementsGolayElements only even values are accepted, and determine the Golay element for StructElement1StructElement1StructElement1StructElement1structElement1. The next larger odd value is used for StructElement2StructElement2StructElement2StructElement2structElement2. 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_elementsGolayElementsGolayElementsGolayElements). The element 'e' has only four possible rotations, and hence the rotation must be between 0 and 7 (for golay_elementsgolay_elementsGolayElementsGolayElementsGolayElements 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

Parameters

StructElement1StructElement1StructElement1StructElement1structElement1 (output_object)  region → objectHRegionHRegionHobject *

Structuring element for the foreground.

StructElement2StructElement2StructElement2StructElement2structElement2 (output_object)  region → objectHRegionHRegionHobject *

Structuring element for the background.

GolayElementGolayElementGolayElementGolayElementgolayElement (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Name of the structuring element.

Default value: 'l' "l" "l" "l" "l"

List of values: 'c'"c""c""c""c", 'd'"d""d""d""d", 'e'"e""e""e""e", 'f'"f""f""f""f", 'f2'"f2""f2""f2""f2", 'h'"h""h""h""h", 'i'"i""i""i""i", 'k'"k""k""k""k", 'l'"l""l""l""l", 'm'"m""m""m""m"

RotationRotationRotationRotationrotation (input_control)  integer → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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

RowRowRowRowrow (input_control)  point.y → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinate of the reference point.

Default value: 16

Suggested values: 0, 16, 32, 128, 256

Typical range of values: 0 ≤ Row Row Row Row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumn (input_control)  point.x → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinate of the reference point.

Default value: 16

Suggested values: 0, 16, 32, 128, 256

Typical range of values: 0 ≤ Column Column Column Column column ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Result

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

Possible Successors

hit_or_misshit_or_missHitOrMissHitOrMissHitOrMiss

Alternatives

gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, gen_struct_elementsgen_struct_elementsGenStructElementsGenStructElementsGenStructElements, gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled

See also

dilation_golaydilation_golayDilationGolayDilationGolayDilationGolay, erosion_golayerosion_golayErosionGolayErosionGolayErosionGolay, opening_golayopening_golayOpeningGolayOpeningGolayOpeningGolay, closing_golayclosing_golayClosingGolayClosingGolayClosingGolay, hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayHitOrMissGolay, thickening_golaythickening_golayThickeningGolayThickeningGolayThickeningGolay

References

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

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH