opening_golay opening_golay OpeningGolay OpeningGolay opening_golay (Operator)
Name
opening_golay opening_golay OpeningGolay OpeningGolay opening_golay
— Open a region with an element from the Golay alphabet.
Warning
opening_golay opening_golay OpeningGolay OpeningGolay opening_golay
is obsolete and is only provided for
reasons of backward compatibility.
Signature
Description
opening_golay opening_golay OpeningGolay OpeningGolay opening_golay
is defined as a Minkowski subtraction
followed by a Minkowski addition. First the Minkowski subtraction
of the input region (Region Region Region region region
) with the structuring element
from the Golay alphabet defined by GolayElement GolayElement GolayElement golayElement golay_element
and
Rotation Rotation Rotation rotation rotation
is computed. Then the Minkowski addition of the
result and the structuring element rotated by 180 degrees
is performed.
The following structuring elements are available:
'l', 'm', 'd', 'c', 'e', 'i', 'f', 'f2', 'h', 'k'.
The rotation number 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 golay_elements
.
opening_golay opening_golay OpeningGolay OpeningGolay opening_golay
serves to eliminate regions smaller than
the structuring element, and to smooth regions' boundaries.
Attention
Not all values of Rotation Rotation Rotation rotation rotation
are valid for any Golay
element. For some of the values of 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
(input_object) region(-array) →
object HRegion HObject HObject Hobject
Regions to be opened.
RegionOpening RegionOpening RegionOpening regionOpening region_opening
(output_object) region(-array) →
object HRegion HObject HObject Hobject *
Opened regions.
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"
List of values:
'c' "c" "c" "c" "c" , 'd' "d" "d" "d" "d" , 'e' "e" "e" "e" "e" , 'f' "f" "f" "f" "f" , 'f2' "f2" "f2" "f2" "f2" , 'h' "h" "h" "h" "h" , 'i' "i" "i" "i" "i" , 'k' "k" "k" "k" "k" , 'l' "l" "l" "l" "l" , 'm' "m" "m" "m" "m"
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
opening_golay opening_golay OpeningGolay OpeningGolay opening_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>) 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>) set_system("empty_region_result",<RegionResult>)
Otherwise, an exception is raised.
Possible Predecessors
threshold threshold Threshold Threshold threshold
,
regiongrowing regiongrowing Regiongrowing Regiongrowing regiongrowing
,
connection connection Connection Connection connection
,
union1 union1 Union1 Union1 union1
,
watersheds watersheds Watersheds Watersheds watersheds
,
class_ndim_norm class_ndim_norm ClassNdimNorm ClassNdimNorm class_ndim_norm
Possible Successors
reduce_domain reduce_domain ReduceDomain ReduceDomain reduce_domain
,
select_shape select_shape SelectShape SelectShape select_shape
,
area_center area_center AreaCenter AreaCenter area_center
,
connection connection Connection Connection connection
Alternatives
opening_seg opening_seg OpeningSeg OpeningSeg opening_seg
,
opening opening Opening Opening opening
See also
erosion_golay erosion_golay ErosionGolay ErosionGolay erosion_golay
,
dilation_golay dilation_golay DilationGolay DilationGolay dilation_golay
,
closing_golay closing_golay ClosingGolay ClosingGolay closing_golay
,
hit_or_miss_golay hit_or_miss_golay HitOrMissGolay HitOrMissGolay hit_or_miss_golay
,
thinning_golay thinning_golay ThinningGolay ThinningGolay thinning_golay
,
thickening_golay thickening_golay ThickeningGolay ThickeningGolay thickening_golay
,
golay_elements golay_elements GolayElements GolayElements golay_elements
Module
Foundation