erosion_golay erosion_golay ErosionGolay ErosionGolay erosion_golay (Operator)
Name
erosion_golay erosion_golay ErosionGolay ErosionGolay erosion_golay
— Erode a region with an element from the Golay alphabet.
Warning
erosion_golay erosion_golay ErosionGolay ErosionGolay ErosionGolay erosion_golay
is obsolete and is only provided for
reasons of backward compatibility.
Signature
void ErosionGolay (const HObject& Region , HObject* RegionErosion , const HTuple& GolayElement , const HTuple& Iterations , const HTuple& Rotation )
HRegion HRegion ::ErosionGolay (const HString& GolayElement , Hlong Iterations , Hlong Rotation ) const
HRegion HRegion ::ErosionGolay (const char* GolayElement , Hlong Iterations , Hlong Rotation ) const
HRegion HRegion ::ErosionGolay (const wchar_t* GolayElement , Hlong Iterations , Hlong Rotation ) const
(Windows only)
Description
erosion_golay erosion_golay ErosionGolay ErosionGolay ErosionGolay erosion_golay
erodes a region with the selected element
GolayElement GolayElement GolayElement GolayElement golayElement golay_element
from the Golay alphabet. 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, and whether the foreground (even) or
background version (odd) of the selected 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
. The
operator works by shifting the structuring element over the region
to be processed (Region Region Region Region region region
). For all positions of the
structuring element fully contained in the region, the
corresponding reference point (relative to the structuring element)
is added to the output region. This means that the intersection of
all translations of the structuring element within the region is
computed.
The parameter Iterations Iterations Iterations Iterations iterations iterations
determines the number of
iterations which are to be performed with the structuring element.
The result of iteration n-1 is used as input for iteration n.
Attention
Not all values of Rotation Rotation Rotation Rotation rotation rotation
are valid for any Golay
element. For some of the values of Rotation Rotation Rotation Rotation rotation rotation
, the
resulting regions are identical to the input regions.
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 eroded.
RegionErosion RegionErosion RegionErosion RegionErosion regionErosion region_erosion
(output_object) region(-array) →
object HRegion HObject HRegion Hobject *
Eroded regions.
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 value:
'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"
Iterations Iterations Iterations Iterations iterations iterations
(input_control) integer →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Number of iterations.
Default value: 1
Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 15, 17, 20, 30, 40, 50
Typical range of values: 1
≤
Iterations
Iterations
Iterations
Iterations
iterations
iterations
(lin)
Minimum increment: 1
Recommended increment: 1
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 value: 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
erosion_golay erosion_golay ErosionGolay ErosionGolay ErosionGolay erosion_golay
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>) 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
,
watersheds watersheds Watersheds Watersheds Watersheds watersheds
,
class_ndim_norm class_ndim_norm ClassNdimNorm ClassNdimNorm ClassNdimNorm class_ndim_norm
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
erosion_seq erosion_seq ErosionSeq ErosionSeq ErosionSeq erosion_seq
,
erosion1 erosion1 Erosion1 Erosion1 Erosion1 erosion1
,
erosion2 erosion2 Erosion2 Erosion2 Erosion2 erosion2
See also
dilation_golay dilation_golay DilationGolay DilationGolay DilationGolay dilation_golay
,
opening_golay opening_golay OpeningGolay OpeningGolay OpeningGolay opening_golay
,
closing_golay closing_golay ClosingGolay ClosingGolay ClosingGolay closing_golay
,
hit_or_miss_golay hit_or_miss_golay HitOrMissGolay HitOrMissGolay HitOrMissGolay hit_or_miss_golay
,
thinning_golay thinning_golay ThinningGolay ThinningGolay ThinningGolay thinning_golay
,
thickening_golay thickening_golay ThickeningGolay ThickeningGolay ThickeningGolay thickening_golay
,
golay_elements golay_elements GolayElements GolayElements GolayElements golay_elements
Module
Foundation