thinning_golaythinning_golayThinningGolayThinningGolaythinning_golay (Operator)

Name

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

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

Regions to be processed.

RegionThinRegionThinRegionThinregionThinregion_thin (output_object) region(-array) → object

Result of the thinning operator.

GolayElementGolayElementGolayElementgolayElementgolay_element (input_control) string → (string)

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 → (integer)

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:

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

Module

Foundation

Operators