Name
thinningthinningThinningThinning — Remove the result of a hit-or-miss operation from a region.
Warning
thinningthinningThinningThinningThinning is obsolete and is only provided for
reasons of backward compatibility.
Herror thinning(const Hobject Region, const Hobject StructElement1, const Hobject StructElement2, Hobject* RegionThin, const Hlong Row, const Hlong Column, const Hlong Iterations)
Herror T_thinning(const Hobject Region, const Hobject StructElement1, const Hobject StructElement2, Hobject* RegionThin, const Htuple Row, const Htuple Column, const Htuple Iterations)
void Thinning(const HObject& Region, const HObject& StructElement1, const HObject& StructElement2, HObject* RegionThin, const HTuple& Row, const HTuple& Column, const HTuple& Iterations)
HRegion HRegion::Thinning(const HRegion& StructElement1, const HRegion& StructElement2, Hlong Row, Hlong Column, Hlong Iterations) const
static void HOperatorSet.Thinning(HObject region, HObject structElement1, HObject structElement2, out HObject regionThin, HTuple row, HTuple column, HTuple iterations)
HRegion HRegion.Thinning(HRegion structElement1, HRegion structElement2, int row, int column, int iterations)
thinningthinningThinningThinningThinning performs a thinning of the input regions
using morphological operations. The operator first applies a
hit-or-miss-transformation to RegionRegionRegionRegionregion (cf.
hit_or_misshit_or_missHitOrMissHitOrMissHitOrMiss), and then removes the detected points from
the input region. The parameter IterationsIterationsIterationsIterationsiterations determines
the number of iterations performed.
For the choice of the structuring elements StructElement1StructElement1StructElement1StructElement1structElement1
and StructElement2StructElement2StructElement2StructElement2structElement2, as well as for RowRowRowRowrow and
ColumnColumnColumnColumncolumn, the same restrictions described under
hit_or_misshit_or_missHitOrMissHitOrMissHitOrMiss apply.
Structuring elements (StructElement1StructElement1StructElement1StructElement1structElement1,
StructElement2StructElement2StructElement2StructElement2structElement2) can be generated with operators such as
gen_circlegen_circleGenCircleGenCircleGenCircle, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2,
gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipse, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion,
gen_region_polygongen_region_polygonGenRegionPolygonGenRegionPolygonGenRegionPolygon, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints, etc.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Structuring element for the foreground.
Structuring element for the background.
Result of the thinning operator.
Row coordinate of the reference point.
Default value: 0
Typical range of values: 0
≤
Row
Row
Row
Row
row
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
Column coordinate of the reference point.
Default value: 0
Typical range of values: 0
≤
Column
Column
Column
Column
column
≤
511 (lin)
Minimum increment: 1
Recommended increment: 1
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
(lin)
Minimum increment: 1
Recommended increment: 1
Let F be the area of an input region, F1 the area of the
structuring element 1, and F2 the area of the structuring element
2. Then the runtime complexity for one object is:
thinningthinningThinningThinningThinning 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>)
-
empty region:
set_system('empty_region_result',<RegionResult>)
Otherwise, an exception is raised.
thresholdthresholdThresholdThresholdThreshold,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing,
connectionconnectionConnectionConnectionConnection,
union1union1Union1Union1Union1,
watershedswatershedsWatershedsWatershedsWatersheds,
class_ndim_normclass_ndim_normClassNdimNormClassNdimNormClassNdimNorm,
gen_circlegen_circleGenCircleGenCircleGenCircle,
gen_ellipsegen_ellipseGenEllipseGenEllipseGenEllipse,
gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1,
gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2,
draw_regiondraw_regionDrawRegionDrawRegionDrawRegion,
gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints,
gen_region_polygon_filledgen_region_polygon_filledGenRegionPolygonFilledGenRegionPolygonFilledGenRegionPolygonFilled
reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain,
select_shapeselect_shapeSelectShapeSelectShapeSelectShape,
area_centerarea_centerAreaCenterAreaCenterAreaCenter,
connectionconnectionConnectionConnectionConnection
thinning_golaythinning_golayThinningGolayThinningGolayThinningGolay,
thinning_seqthinning_seqThinningSeqThinningSeqThinningSeq
hit_or_misshit_or_missHitOrMissHitOrMissHitOrMiss
Foundation