HALCON Reference Manual 10.0.2
Table of Contents / Morphology / Region ClassesClassesClasses | | | Operators

erosion_golayerosion_golayerosion_golayErosionGolayErosionGolay (Operator)

Name

erosion_golayerosion_golayerosion_golayErosionGolayErosionGolay — Erode a region with an element from the Golay alphabet.

Signature

erosion_golay(Region : RegionErosion : GolayElement, Iterations, Rotation : )

Herror erosion_golay(const Hobject Region, Hobject* RegionErosion, const char* GolayElement, const Hlong Iterations, const Hlong Rotation)

Herror T_erosion_golay(const Hobject Region, Hobject* RegionErosion, const Htuple GolayElement, const Htuple Iterations, const Htuple Rotation)

Herror erosion_golay(Hobject Region, Hobject* RegionErosion, const HTuple& GolayElement, const HTuple& Iterations, const HTuple& Rotation)

HRegion HRegion::ErosionGolay(const HTuple& GolayElement, const HTuple& Iterations, const HTuple& Rotation) const

HRegionArray HRegionArray::ErosionGolay(const HTuple& GolayElement, const HTuple& Iterations, const HTuple& Rotation) const

void HOperatorSetX.ErosionGolay(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX*RegionErosion, [in] VARIANT GolayElement, [in] VARIANT Iterations, [in] VARIANT Rotation)

IHRegionX* HRegionX.ErosionGolay(
[in] BSTR GolayElement, [in] Hlong Iterations, [in] Hlong Rotation)

static void HOperatorSet.ErosionGolay(HObject region, out HObject regionErosion, HTuple golayElement, HTuple iterations, HTuple rotation)

HRegion HRegion.ErosionGolay(string golayElement, int iterations, int rotation)

Description

erosion_golayerosion_golayerosion_golayErosionGolayErosionGolay erodes a region with the selected element GolayElementGolayElementGolayElementGolayElementgolayElement from the Golay alphabet. The following structuring elements are available:

'l', 'm', 'd', 'c', 'e', 'i', 'f', 'f2', 'h', 'k'.

The rotation number RotationRotationRotationRotationrotation determines which rotation of the element should be used, and whether the foreground (even) or background version (odd) of the selected element should be used. The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsgolay_elementsGolayElementsGolayElements. The operator works by shifting the structuring element over the region to be processed (RegionRegionRegionRegionregion). For all positions of the structuring element fully contained in the region, the corresponding reference point (relative to the structuring element) is added to the output region. This means that the intersection of all translations of the structuring element within the region is computed.

The parameter IterationsIterationsIterationsIterationsiterations determines the number of iterations which are to be performed with the structuring element. The result of iteration n-1 is used as input for iteration n.

Attention

Not all values of RotationRotationRotationRotationrotation are valid for any Golay element. For some of the values of RotationRotationRotationRotationrotation, the resulting regions are identical to the input regions.

Parallelization

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHRegionXHobject

Regions to be eroded.

RegionErosionRegionErosionRegionErosionRegionErosionregionErosion (output_object)  region(-array) objectHRegionHRegionHRegionXHobject *

Eroded regions.

GolayElementGolayElementGolayElementGolayElementgolayElement (input_control)  string HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Structuring element from the Golay alphabet.

Default value: 'h' "h" "h" "h" "h"

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

IterationsIterationsIterationsIterationsiterations (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Number of iterations.

Default value: 1

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 15, 17, 20, 30, 40, 50

Typical range of values: 1 ≤ Iterations Iterations Iterations Iterations iterations (lin)

Minimum increment: 1

Recommended increment: 1

RotationRotationRotationRotationrotation (input_control)  integer HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (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, 1, 3, 5, 7, 9, 11, 13, 15

Complexity

Let F be the area of an input region. Then the runtime complexity for one region is:

       O(3 * sqrt(F)) .

Result

erosion_golayerosion_golayerosion_golayErosionGolayErosionGolay returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via:

Otherwise, an exception is raised.

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, watershedswatershedswatershedsWatershedsWatersheds, class_ndim_normclass_ndim_normclass_ndim_normClassNdimNormClassNdimNorm

Possible Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeselect_shapeSelectShapeSelectShape, area_centerarea_centerarea_centerAreaCenterAreaCenter, connectionconnectionconnectionConnectionConnection

Alternatives

erosion_seqerosion_seqerosion_seqErosionSeqErosionSeq, erosion1erosion1erosion1Erosion1Erosion1, erosion2erosion2erosion2Erosion2Erosion2

See also

dilation_golaydilation_golaydilation_golayDilationGolayDilationGolay, opening_golayopening_golayopening_golayOpeningGolayOpeningGolay, closing_golayclosing_golayclosing_golayClosingGolayClosingGolay, hit_or_miss_golayhit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolay, thinning_golaythinning_golaythinning_golayThinningGolayThinningGolay, thickening_golaythickening_golaythickening_golayThickeningGolayThickeningGolay, golay_elementsgolay_elementsgolay_elementsGolayElementsGolayElements

Module

Foundation


Table of Contents / Morphology / Region ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH