thinning_golay thinning_golay ThinningGolay ThinningGolay thinning_golay (Operator)
Name
thinning_golay thinning_golay ThinningGolay ThinningGolay thinning_golay
— Remove the result of a hit-or-miss operation from a region (using a
Golay structuring element).
Warning
thinning_golay thinning_golay ThinningGolay ThinningGolay ThinningGolay thinning_golay
is obsolete and is only provided for
reasons of backward compatibility.
Signature
Description
thinning_golay thinning_golay ThinningGolay ThinningGolay ThinningGolay thinning_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 Region Region Region Region region region
(cf.
hit_or_miss_golay hit_or_miss_golay HitOrMissGolay HitOrMissGolay HitOrMissGolay hit_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 Rotation Rotation Rotation Rotation rotation rotation
determines which rotation of
the element should be used. The Golay elements, together with all
possible rotations, are described with the operator
golay_elements golay_elements GolayElements GolayElements GolayElements golay_elements
.
Attention
Not all values of Rotation Rotation Rotation Rotation rotation rotation
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
Region Region Region Region region region
(input_object) region(-array) →
object HRegion HObject HRegion Hobject
Regions to be processed.
RegionThin RegionThin RegionThin RegionThin regionThin region_thin
(output_object) region(-array) →
object HRegion HObject HRegion Hobject *
Result of the thinning operator.
GolayElement GolayElement GolayElement GolayElement golayElement golay_element
(input_control) string →
HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Structuring element from the Golay alphabet.
Default:
'h'
"h"
"h"
"h"
"h"
"h"
List of values:
'c' "c" "c" "c" "c" "c" , 'd' "d" "d" "d" "d" "d" , 'e' "e" "e" "e" "e" "e" , 'f' "f" "f" "f" "f" "f" , 'f2' "f2" "f2" "f2" "f2" "f2" , 'h' "h" "h" "h" "h" "h" , 'i' "i" "i" "i" "i" "i" , 'k' "k" "k" "k" "k" "k" , 'l' "l" "l" "l" "l" "l" , 'm' "m" "m" "m" "m" "m"
Rotation Rotation Rotation Rotation rotation rotation
(input_control) integer →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
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_golay thinning_golay ThinningGolay ThinningGolay ThinningGolay thinning_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:
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 Successors
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
Alternatives
thinning_seq thinning_seq ThinningSeq ThinningSeq ThinningSeq thinning_seq
,
thinning thinning Thinning Thinning Thinning thinning
See also
erosion_golay erosion_golay ErosionGolay ErosionGolay ErosionGolay erosion_golay
,
hit_or_miss_golay hit_or_miss_golay HitOrMissGolay HitOrMissGolay HitOrMissGolay hit_or_miss_golay
Module
Foundation