dilation_golay dilation_golay DilationGolay DilationGolay dilation_golay (Operator)
Name
dilation_golay dilation_golay DilationGolay DilationGolay dilation_golay
— Dilate a region with an element from the Golay alphabet.
Warning
dilation_golay dilation_golay DilationGolay DilationGolay DilationGolay dilation_golay
is obsolete and is only provided for
reasons of backward compatibility.
Signature
void DilationGolay (const HObject& Region , HObject* RegionDilation , const HTuple& GolayElement , const HTuple& Iterations , const HTuple& Rotation )
HRegion HRegion ::DilationGolay (const HString& GolayElement , Hlong Iterations , Hlong Rotation ) const
HRegion HRegion ::DilationGolay (const char* GolayElement , Hlong Iterations , Hlong Rotation ) const
HRegion HRegion ::DilationGolay (const wchar_t* GolayElement , Hlong Iterations , Hlong Rotation ) const
(Windows only)
Description
dilation_golay dilation_golay DilationGolay DilationGolay DilationGolay dilation_golay
dilates 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 that intersect the region, the corresponding
reference point (relative to the structuring element) is added to
the output region. This means that the union 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 dilated.
RegionDilation RegionDilation RegionDilation RegionDilation regionDilation region_dilation
(output_object) region(-array) →
object HRegion HObject HRegion Hobject *
Dilated 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
dilation_golay dilation_golay DilationGolay DilationGolay DilationGolay dilation_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 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
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
dilation1 dilation1 Dilation1 Dilation1 Dilation1 dilation1
,
dilation2 dilation2 Dilation2 Dilation2 Dilation2 dilation2
,
dilation_seq dilation_seq DilationSeq DilationSeq DilationSeq dilation_seq
See also
erosion_golay erosion_golay ErosionGolay ErosionGolay ErosionGolay erosion_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