morph_skizmorph_skizMorphSkizMorphSkizmorph_skiz (Operator)

Name

morph_skizmorph_skizMorphSkizMorphSkizmorph_skiz — Thinning of a region.

Warning

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

Signature

morph_skiz(Region : RegionSkiz : Iterations1, Iterations2 : )

Description

morph_skizmorph_skizMorphSkizMorphSkizMorphSkizmorph_skiz first performs a sequential thinning (thinning_seqthinning_seqThinningSeqThinningSeqThinningSeqthinning_seq) of the input region with the element 'l' of the Golay alphabet. The number of iterations is determined by the parameter Iterations1Iterations1Iterations1Iterations1iterations1iterations_1. Then a sequential thinning of the resulting region with the element 'e' of the Golay alphabet is carried out. The number of iterations for this step is determined by the parameter Iterations2Iterations2Iterations2Iterations2iterations2iterations_2. The skiz operation serves to compute a kind of skeleton of the input regions, and to prune the branches of the resulting skeleton. If the skiz operation is applied to the complement of the region, the region and the resulting skeleton are separated.

If very large values or 'maximal' are passed for Iterations1Iterations1Iterations1Iterations1iterations1iterations_1 or Iterations2Iterations2Iterations2Iterations2iterations2iterations_2, the processing stops if no more changes occur.

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

RegionRegionRegionRegionregionregion (input_object) region(-array) → object

Regions to be thinned.

RegionSkizRegionSkizRegionSkizRegionSkizregionSkizregion_skiz (output_object) region(-array) → object

Result of the skiz operator.

Iterations1Iterations1Iterations1Iterations1iterations1iterations_1 (input_control) integer → (integer / string)

Number of iterations for the sequential thinning with the element 'l' of the Golay alphabet.

Default value: 100

Suggested values: 'maximal'"maximal""maximal""maximal""maximal""maximal", 0, 1, 2, 3, 5, 7, 10, 15, 20, 30, 40, 50, 70, 100, 150, 200, 300, 400

Typical range of values: 0 ≤ Iterations1 Iterations1 Iterations1 Iterations1 iterations1 iterations_1 (lin)

Minimum increment: 1

Recommended increment: 1

Iterations2Iterations2Iterations2Iterations2iterations2iterations_2 (input_control) integer → (integer / string)

Number of iterations for the sequential thinning with the element 'e' of the Golay alphabet.

Default value: 1

Suggested values: 'maximal'"maximal""maximal""maximal""maximal""maximal", 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 15, 17, 20, 30, 40, 50

Typical range of values: 0 ≤ Iterations2 Iterations2 Iterations2 Iterations2 iterations2 iterations_2 (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

Let F be the area of the input region. Then the runtime complexity for one region is

Result

morph_skizmorph_skizMorphSkizMorphSkizMorphSkizmorph_skiz returns 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

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection, union1union1Union1Union1Union1union1, watershedswatershedsWatershedsWatershedsWatershedswatersheds, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNormclass_ndim_norm

Possible Successors

pruningpruningPruningPruningPruningpruning, reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionConnectionconnection, background_segbackground_segBackgroundSegBackgroundSegBackgroundSegbackground_seg, complementcomplementComplementComplementComplementcomplement

Alternatives

skeletonskeletonSkeletonSkeletonSkeletonskeleton, thinning_seqthinning_seqThinningSeqThinningSeqThinningSeqthinning_seq, morph_skeletonmorph_skeletonMorphSkeletonMorphSkeletonMorphSkeletonmorph_skeleton, interjacentinterjacentInterjacentInterjacentInterjacentinterjacent

Module

Foundation

Operators