dilation2 dilation2 Dilation2 Dilation2 dilation2 (Operator)
Name
dilation2 dilation2 Dilation2 Dilation2 dilation2
Signature
Herror dilation2 (const Hobject Region StructElement RegionDilation Row Column Iterations
Herror T_dilation2 (const Hobject Region StructElement RegionDilation Row Column Iterations
Description
dilation2 dilation2 Dilation2 Dilation2 Dilation2 dilation2 StructElement StructElement StructElement StructElement structElement struct_element Row Row Row Row row row Column Column Column Column column column dilation2 dilation2 Dilation2 Dilation2 Dilation2 dilation2 dilation1 dilation1 Dilation1 Dilation1 Dilation1 dilation1 Iterations Iterations Iterations Iterations iterations iterations
An empty region is generated in case of an empty structuring
element.
Structuring elements (StructElement StructElement StructElement StructElement structElement struct_element gen_circle gen_circle GenCircle GenCircle GenCircle gen_circle gen_rectangle1 gen_rectangle1 GenRectangle1 GenRectangle1 GenRectangle1 gen_rectangle1 gen_rectangle2 gen_rectangle2 GenRectangle2 GenRectangle2 GenRectangle2 gen_rectangle2 gen_ellipse gen_ellipse GenEllipse GenEllipse GenEllipse gen_ellipse draw_region draw_region DrawRegion DrawRegion DrawRegion draw_region gen_region_polygon gen_region_polygon GenRegionPolygon GenRegionPolygon GenRegionPolygon gen_region_polygon gen_region_points gen_region_points GenRegionPoints GenRegionPoints GenRegionPoints gen_region_points
Attention
A dilation always results in enlarged regions. Closely
spaced regions which may touch or overlap as a result of the
dilation are still treated as two separate regions. If the desired
behavior is to merge them into one region, the operator
union1 union1 Union1 Union1 Union1 union1
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 region(-array) → object HRegion HObject HRegion Hobject
Regions to be dilated.
StructElement StructElement StructElement StructElement structElement struct_element region → object HRegion HObject HRegion Hobject
Structuring element.
RegionDilation RegionDilation RegionDilation RegionDilation regionDilation region_dilation region(-array) → object HRegion HObject HRegion Hobject *
Dilated regions.
Row Row Row Row row row point.y → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Row coordinate of the reference point.
Default:
0
Column Column Column Column column column point.x → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Column coordinate of the reference point.
Default:
0
Iterations Iterations Iterations Iterations iterations iterations integer → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Number of iterations.
Default:
1
Suggested values:
1, 2, 3, 4, 5, 7, 11, 17, 25, 32, 64, 128
Value range:
1
≤
Iterations
Iterations
Iterations
Iterations
iterations
iterations
(lin)
Minimum increment:
1
Recommended increment:
1
Complexity
Let F1 be the area of the input region, and F2 be the area of
the structuring element. Then the runtime complexity for one region
is:
Result
dilation2 dilation2 Dilation2 Dilation2 Dilation2 dilation2 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 gen_circle gen_circle GenCircle GenCircle GenCircle gen_circle gen_ellipse gen_ellipse GenEllipse GenEllipse GenEllipse gen_ellipse gen_rectangle1 gen_rectangle1 GenRectangle1 GenRectangle1 GenRectangle1 gen_rectangle1 gen_rectangle2 gen_rectangle2 GenRectangle2 GenRectangle2 GenRectangle2 gen_rectangle2 draw_region draw_region DrawRegion DrawRegion DrawRegion draw_region gen_region_points gen_region_points GenRegionPoints GenRegionPoints GenRegionPoints gen_region_points gen_region_polygon_filled gen_region_polygon_filled GenRegionPolygonFilled GenRegionPolygonFilled GenRegionPolygonFilled gen_region_polygon_filled
Possible Successors
reduce_domain reduce_domain ReduceDomain ReduceDomain ReduceDomain reduce_domain add_channels add_channels AddChannels AddChannels AddChannels add_channels 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
minkowski_add1 minkowski_add1 MinkowskiAdd1 MinkowskiAdd1 MinkowskiAdd1 minkowski_add1 minkowski_add2 minkowski_add2 MinkowskiAdd2 MinkowskiAdd2 MinkowskiAdd2 minkowski_add2 dilation1 dilation1 Dilation1 Dilation1 Dilation1 dilation1
See also
erosion1 erosion1 Erosion1 Erosion1 Erosion1 erosion1 erosion2 erosion2 Erosion2 Erosion2 Erosion2 erosion2 opening opening Opening Opening Opening opening closing closing Closing Closing Closing closing
Module
Foundation