closing_rectangle1 closing_rectangle1 ClosingRectangle1 ClosingRectangle1 closing_rectangle1 (Operator)
Name
closing_rectangle1 closing_rectangle1 ClosingRectangle1 ClosingRectangle1 closing_rectangle1
— Close a region with a rectangular structuring element.
Signature
Description
closing_rectangle1 closing_rectangle1 ClosingRectangle1 ClosingRectangle1 ClosingRectangle1 closing_rectangle1
behaves as closing closing Closing Closing Closing closing
with a rectangular
structuring element on the input region Region Region Region Region region region
.
The size of the rectangular structuring element
is determined by the parameters Width Width Width Width width width
and
Height Height Height Height height height
. As is the case for all closing closing Closing Closing Closing closing
variants, regions' boundaries are smoothed and holes within a region
which are smaller than the rectangular structuring element are
closed.
Similar to erosion_rectangle1 erosion_rectangle1 ErosionRectangle1 ErosionRectangle1 ErosionRectangle1 erosion_rectangle1
and dilation_rectangle1 dilation_rectangle1 DilationRectangle1 DilationRectangle1 DilationRectangle1 dilation_rectangle1
closing_rectangle1 closing_rectangle1 ClosingRectangle1 ClosingRectangle1 ClosingRectangle1 closing_rectangle1
is a very fast operation.
Attention
closing_rectangle1 closing_rectangle1 ClosingRectangle1 ClosingRectangle1 ClosingRectangle1 closing_rectangle1
is applied to each input region
separately. If gaps between different regions are to be closed,
union1 union1 Union1 Union1 Union1 union1
or union2 union2 Union2 Union2 Union2 union2
has to be called first.
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 closed.
RegionClosing RegionClosing RegionClosing RegionClosing regionClosing region_closing
(output_object) region(-array) →
object HRegion HObject HRegion Hobject *
Closed regions.
Width Width Width Width width width
(input_control) extent.x →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Width of the structuring rectangle.
Default:
10
Suggested values:
1, 2, 3, 4, 5, 7, 9, 12, 15, 19, 25, 33, 45, 60, 110, 150, 200
Value range:
1
≤
Width
Width
Width
Width
width
width
≤
511
(lin)
Minimum increment:
1
Recommended increment:
1
Height Height Height Height height height
(input_control) extent.y →
HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Height of the structuring rectangle.
Default:
10
Suggested values:
1, 2, 3, 4, 5, 7, 9, 12, 15, 19, 25, 33, 45, 60, 110, 150, 200
Value range:
1
≤
Height
Height
Height
Height
height
height
≤
511
(lin)
Minimum increment:
1
Recommended increment:
1
Complexity
Let F1 be the area of an input region and H be the height of the
rectangle. Then the runtime complexity for one region is:
Result
closing_rectangle1 closing_rectangle1 ClosingRectangle1 ClosingRectangle1 ClosingRectangle1 closing_rectangle1
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
closing closing Closing Closing Closing closing
See also
dilation_rectangle1 dilation_rectangle1 DilationRectangle1 DilationRectangle1 DilationRectangle1 dilation_rectangle1
,
erosion_rectangle1 erosion_rectangle1 ErosionRectangle1 ErosionRectangle1 ErosionRectangle1 erosion_rectangle1
,
opening_rectangle1 opening_rectangle1 OpeningRectangle1 OpeningRectangle1 OpeningRectangle1 opening_rectangle1
,
gen_rectangle1 gen_rectangle1 GenRectangle1 GenRectangle1 GenRectangle1 gen_rectangle1
Module
Foundation