morph_skiz morph_skiz MorphSkiz MorphSkiz morph_skiz (Operator)
Name
morph_skiz morph_skiz MorphSkiz MorphSkiz morph_skiz
— Thinning of a region.
Warning
morph_skiz morph_skiz MorphSkiz MorphSkiz MorphSkiz morph_skiz
is obsolete and is only provided for
reasons of backward compatibility.
Signature
Description
morph_skiz morph_skiz MorphSkiz MorphSkiz MorphSkiz morph_skiz
first performs a sequential thinning
(thinning_seq thinning_seq ThinningSeq ThinningSeq ThinningSeq thinning_seq
) of the input region with the element 'l'
of the Golay alphabet. The number of iterations is determined by
the parameter Iterations1 Iterations1 Iterations1 Iterations1 iterations1 iterations_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 Iterations2 Iterations2 Iterations2 Iterations2 iterations2 iterations_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
Iterations1 Iterations1 Iterations1 Iterations1 iterations1 iterations_1
or Iterations2 Iterations2 Iterations2 Iterations2 iterations2 iterations_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
Region Region Region Region region region
(input_object) region(-array) →
object HRegion HObject HRegion Hobject
Regions to be thinned.
RegionSkiz RegionSkiz RegionSkiz RegionSkiz regionSkiz region_skiz
(output_object) region(-array) →
object HRegion HObject HRegion Hobject *
Result of the skiz operator.
Iterations1 Iterations1 Iterations1 Iterations1 iterations1 iterations_1
(input_control) integer →
HTuple Union[int, str] HTuple Htuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
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
Iterations2 Iterations2 Iterations2 Iterations2 iterations2 iterations_2
(input_control) integer →
HTuple Union[int, str] HTuple Htuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
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_skiz morph_skiz MorphSkiz MorphSkiz MorphSkiz morph_skiz
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>) set_system("no_object_result",<RegionResult>) SetSystem("no_object_result",<RegionResult>) SetSystem("no_object_result",<RegionResult>) SetSystem("no_object_result",<RegionResult>) set_system("no_object_result",<RegionResult>)
empty region:
set_system('empty_region_result',<RegionResult>) set_system("empty_region_result",<RegionResult>) SetSystem("empty_region_result",<RegionResult>) SetSystem("empty_region_result",<RegionResult>) SetSystem("empty_region_result",<RegionResult>) set_system("empty_region_result",<RegionResult>)
Otherwise, an exception is raised.
Possible Predecessors
threshold threshold Threshold Threshold Threshold threshold
,
regiongrowing regiongrowing Regiongrowing Regiongrowing Regiongrowing regiongrowing
,
connection connection Connection Connection Connection connection
,
union1 union1 Union1 Union1 Union1 union1
,
watersheds watersheds Watersheds Watersheds Watersheds watersheds
,
class_ndim_norm class_ndim_norm ClassNdimNorm ClassNdimNorm ClassNdimNorm class_ndim_norm
Possible Successors
pruning pruning Pruning Pruning Pruning pruning
,
reduce_domain reduce_domain ReduceDomain ReduceDomain ReduceDomain reduce_domain
,
select_shape select_shape SelectShape SelectShape SelectShape select_shape
,
area_center area_center AreaCenter AreaCenter AreaCenter area_center
,
connection connection Connection Connection Connection connection
,
background_seg background_seg BackgroundSeg BackgroundSeg BackgroundSeg background_seg
,
complement complement Complement Complement Complement complement
Alternatives
skeleton skeleton Skeleton Skeleton Skeleton skeleton
,
thinning_seq thinning_seq ThinningSeq ThinningSeq ThinningSeq thinning_seq
,
morph_skeleton morph_skeleton MorphSkeleton MorphSkeleton MorphSkeleton morph_skeleton
,
interjacent interjacent Interjacent Interjacent Interjacent interjacent
See also
thinning thinning Thinning Thinning Thinning thinning
,
hit_or_miss_seq hit_or_miss_seq HitOrMissSeq HitOrMissSeq HitOrMissSeq hit_or_miss_seq
,
difference difference Difference Difference Difference difference
Module
Foundation