Operator Reference

HALCON Operator Reference / Legacy / Morphology

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

thinning_golaythinning_golayThinningGolayThinningGolaythinning_golay (Operator)

thinning_golaythinning_golayThinningGolayThinningGolaythinning_golay — Remove the result of a hit-or-miss operation from a region (using a Golay structuring element).

Warning

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

Signature

thinning_golay(Region : RegionThin : GolayElement, Rotation : )

Herror thinning_golay(const Hobject Region, Hobject* RegionThin, const char* GolayElement, const Hlong Rotation)

Herror T_thinning_golay(const Hobject Region, Hobject* RegionThin, const Htuple GolayElement, const Htuple Rotation)

void ThinningGolay(const HObject& Region, HObject* RegionThin, const HTuple& GolayElement, const HTuple& Rotation)

HRegion HRegion::ThinningGolay(const HString& GolayElement, Hlong Rotation) const

HRegion HRegion::ThinningGolay(const char* GolayElement, Hlong Rotation) const

HRegion HRegion::ThinningGolay(const wchar_t* GolayElement, Hlong Rotation) const   ( Windows only)

static void HOperatorSet.ThinningGolay(HObject region, out HObject regionThin, HTuple golayElement, HTuple rotation)

HRegion HRegion.ThinningGolay(string golayElement, int rotation)

def thinning_golay(region: HObject, golay_element: str, rotation: int) -> HObject

Description

thinning_golaythinning_golayThinningGolayThinningGolaythinning_golay performs a thinning of the input regions using morphological operations and structuring elements from the Golay alphabet. The operator first applies a hit-or-miss-transformation to RegionRegionRegionregionregion (cf. hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay), and then removes the detected points from the input region. 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. The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements.

Attention

Not all values of RotationRotationRotationrotationrotation are valid for any Golay element.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Automatically parallelized on tuple level.

Parameters

RegionRegionRegionregionregion (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Regions to be processed.

RegionThinRegionThinRegionThinregionThinregion_thin (output_object)  region(-array) → objectHRegionHObjectHObjectHobject *

Result of the thinning operator.

GolayElementGolayElementGolayElementgolayElementgolay_element (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Structuring element from the Golay alphabet.

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

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 → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

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, 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:

Result

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

• no region: set_system('no_object_result',<RegionResult>)set_system("no_object_result",<RegionResult>)SetSystem("no_object_result",<RegionResult>)SetSystem("no_object_result",<RegionResult>)set_system("no_object_result",<RegionResult>)

• empty region: set_system('empty_region_result',<RegionResult>)set_system("empty_region_result",<RegionResult>)SetSystem("empty_region_result",<RegionResult>)SetSystem("empty_region_result",<RegionResult>)set_system("empty_region_result",<RegionResult>)

Otherwise, an exception is raised.

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionconnection

Alternatives

thinning_seqthinning_seqThinningSeqThinningSeqthinning_seq, thinningthinningThinningThinningthinning

See also

erosion_golayerosion_golayErosionGolayErosionGolayerosion_golay, hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay

Module

Foundation

---

ClassesClasses | | Operators