Operator Reference

HALCON Operator Reference / Legacy / Morphology
ClassesClasses | | Operators

hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay (Operator)

hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay — Hit-or-miss operation for regions using the Golay alphabet.

Warning

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

Signature

hit_or_miss_golay(Region : RegionHitMiss : GolayElement, Rotation : )

Herror hit_or_miss_golay(const Hobject Region, Hobject* RegionHitMiss, const char* GolayElement, const Hlong Rotation)

Herror T_hit_or_miss_golay(const Hobject Region, Hobject* RegionHitMiss, const Htuple GolayElement, const Htuple Rotation)

void HitOrMissGolay(const HObject& Region, HObject* RegionHitMiss, const HTuple& GolayElement, const HTuple& Rotation)

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

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

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

static void HOperatorSet.HitOrMissGolay(HObject region, out HObject regionHitMiss, HTuple golayElement, HTuple rotation)

HRegion HRegion.HitOrMissGolay(string golayElement, int rotation)

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

Description

hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay performs the hit-or-miss-transformation for the input regions RegionRegionRegionregionregion (using structuring elements from the Golay alphabet). First, an erosion with the foreground of the structuring element GolayElementGolayElementGolayElementgolayElementgolay_element is done on the input region RegionRegionRegionregionregion. Then an erosion with the background of the structuring element GolayElementGolayElementGolayElementgolayElementgolay_element is performed on the complement of the input region. The intersection of the two resulting regions is the result RegionHitMissRegionHitMissRegionHitMissregionHitMissregion_hit_miss of hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayhit_or_miss_golay. 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 hit-or-miss-transformation selects precisely the points for which the conditions given by the selected Golay element are fulfilled.

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.

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

Result of the hit-or-miss operation.

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

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

Otherwise, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionconnection, union1union1Union1Union1union1, watershedswatershedsWatershedsWatershedswatersheds, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionconnection

Alternatives

hit_or_miss_seqhit_or_miss_seqHitOrMissSeqHitOrMissSeqhit_or_miss_seq, hit_or_misshit_or_missHitOrMissHitOrMisshit_or_miss

See also

erosion_golayerosion_golayErosionGolayErosionGolayerosion_golay, dilation_golaydilation_golayDilationGolayDilationGolaydilation_golay, opening_golayopening_golayOpeningGolayOpeningGolayopening_golay, closing_golayclosing_golayClosingGolayClosingGolayclosing_golay, thinning_golaythinning_golayThinningGolayThinningGolaythinning_golay, thickening_golaythickening_golayThickeningGolayThickeningGolaythickening_golay, golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements

Module

Foundation

ClassesClasses | | Operators