hit_or_miss_seqHitOrMissSeqHitOrMissSeqhit_or_miss_seqhit_or_miss_seq

HALCON ScriptCpp++.NETPythonC

Short description

hit_or_miss_seqHitOrMissSeqHitOrMissSeqhit_or_miss_seqhit_or_miss_seq — Hit-or-miss operation for regions using the Golay alphabet (sequential).

Warning

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

Signature

hit_or_miss_seq( region Region, out region RegionHitMiss, string GolayElement )void HitOrMissSeq( const HObject& Region, HObject* RegionHitMiss, const HTuple& GolayElement )static void HOperatorSet.HitOrMissSeq( HObject region, out HObject regionHitMiss, HTuple golayElement )def hit_or_miss_seq( region: HObject, golay_element: str ) -> HObject

Herror hit_or_miss_seq( const Hobject Region, Hobject* RegionHitMiss, const char* GolayElement )

Herror T_hit_or_miss_seq( const Hobject Region, Hobject* RegionHitMiss, const Htuple GolayElement )

HRegion HRegion::HitOrMissSeq( const HString& GolayElement ) const

HRegion HRegion::HitOrMissSeq( const char* GolayElement ) const

HRegion HRegion::HitOrMissSeq( const wchar_t* GolayElement ) const (Windows only)

HRegion HRegion.HitOrMissSeq( string golayElement )

Description

hit_or_miss_golayHitOrMissGolay performs the hit-or-miss-transformation for the input regions Regionregionregion using all rotations of a structuring element from the Golay alphabet. The result of the operator is the union of all intermediate results of the respective rotations. The following structuring elements are available:

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

The Golay elements, together with all possible rotations, are described with the operator golay_elementsGolayElements.

Execution information

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

Regionregionregion (input_object) region(-array) → objectHObjectHRegionHObjectHobject

Regions to be processed.

RegionHitMissregionHitMissregion_hit_miss (output_object) region(-array) → objectHObjectHRegionHObjectHobject *

Result of the hit-or-miss operation.

GolayElementgolayElementgolay_element (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Structuring element from the Golay alphabet.

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

Complexity

Let \(F\) be the area of an input region, and \(R\) be the number of rotations. Then the runtime complexity for one region is:

\[\begin{eqnarray*} O(R \cdot 6 \cdot \sqrt{F}) \enspace . \end{eqnarray*}\]

Result

hit_or_miss_seqHitOrMissSeq 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>)

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

Otherwise, an exception is raised.

Combinations with other operators

Combinations

Possible predecessors

thresholdThreshold, regiongrowingRegiongrowing, connectionConnection, union1Union1, watershedsWatersheds, class_ndim_normClassNdimNorm

Possible successors

reduce_domainReduceDomain, select_shapeSelectShape, area_centerAreaCenter, connectionConnection

Alternatives

hit_or_miss_golayHitOrMissGolay, hit_or_missHitOrMiss

See also

thinning_seqThinningSeq, thickening_seqThickeningSeq

Module

Foundation