minkowski_sub2minkowski_sub2MinkowskiSub2MinkowskiSub2minkowski_sub2 (Operator)

Name

minkowski_sub2minkowski_sub2MinkowskiSub2MinkowskiSub2minkowski_sub2 — Erode a region (using a reference point).

Signature

minkowski_sub2(Region, StructElement : RegionMinkSub : Row, Column, Iterations : )

Description

minkowski_sub2minkowski_sub2MinkowskiSub2MinkowskiSub2MinkowskiSub2minkowski_sub2 computes the Minkowski subtraction of the input regions with a structuring element (StructElementStructElementStructElementStructElementstructElementstruct_element) having the reference point (RowRowRowRowrowrow,ColumnColumnColumnColumncolumncolumn). minkowski_sub2minkowski_sub2MinkowskiSub2MinkowskiSub2MinkowskiSub2minkowski_sub2 has a similar effect as minkowski_sub1minkowski_sub1MinkowskiSub1MinkowskiSub1MinkowskiSub1minkowski_sub1, the difference is that the reference point of the structuring element can be chosen arbitrarily. The parameter IterationsIterationsIterationsIterationsiterationsiterations 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.

A maximum region is generated in case of an empty structuring element.

Structuring elements (StructElementStructElementStructElementStructElementstructElementstruct_element) can be generated with operators such as gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2, gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipsegen_ellipse, draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region, gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygongen_region_polygon, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPointsgen_region_points, etc.

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

RegionRegionRegionRegionregionregion (input_object) region(-array) → object

Regions to be eroded.

StructElementStructElementStructElementStructElementstructElementstruct_element (input_object) region → object

Structuring element.

RegionMinkSubRegionMinkSubRegionMinkSubRegionMinkSubregionMinkSubregion_mink_sub (output_object) region(-array) → object

Eroded regions.

RowRowRowRowrowrow (input_control) point.y → (integer)

Row coordinate of the reference point.

Default value: 0

Suggested values: 0, 10, 16, 32, 64, 100, 128

Typical range of values: 0 ≤ Row Row Row Row row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumncolumn (input_control) point.x → (integer)

Column coordinate of the reference point.

Default value: 0

Suggested values: 0, 10, 16, 32, 64, 100, 128

Typical range of values: 0 ≤ Column Column Column Column column column ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

IterationsIterationsIterationsIterationsiterationsiterations (input_control) integer → (integer)

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

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

minkowski_sub2minkowski_sub2MinkowskiSub2MinkowskiSub2MinkowskiSub2minkowski_sub2 returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via: