hit_or_miss_seqhit_or_miss_seqHitOrMissSeqHitOrMissSeq (Operator)

Name

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

Warning

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

Signature

hit_or_miss_seq(Region : RegionHitMiss : GolayElement : )

Description

hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayHitOrMissGolay performs the hit-or-miss-transformation for the input regions RegionRegionRegionRegionregion 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_elementsgolay_elementsGolayElementsGolayElementsGolayElements.

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) → object

Regions to be processed.

RegionHitMissRegionHitMissRegionHitMissRegionHitMissregionHitMiss (output_object) region(-array) → object

Result of the hit-or-miss operation.

GolayElementGolayElementGolayElementGolayElementgolayElement (input_control) string → (string)

Structuring element from the Golay alphabet.

Default value: '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"

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:

Result

hit_or_miss_seqhit_or_miss_seqHitOrMissSeqHitOrMissSeqHitOrMissSeq 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.

Possible Predecessors

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection, union1union1Union1Union1Union1, watershedswatershedsWatershedsWatershedsWatersheds, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNorm

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter, connectionconnectionConnectionConnectionConnection

Alternatives

hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayHitOrMissGolay, hit_or_misshit_or_missHitOrMissHitOrMissHitOrMiss

Module

Foundation

Operators