closing_circleclosing_circleclosing_circleClosingCircleClosingCircle (Operator)

Name

closing_circleclosing_circleclosing_circleClosingCircleClosingCircle — Close a region with a circular structuring element.

Signature

Description

closing_circleclosing_circleclosing_circleClosingCircleClosingCircle behaves analogously to closingclosingclosingClosingClosing, i.e., the regions' boundaries are smoothed and holes within a region which are smaller than the circular structuring element of radius RadiusRadiusRadiusRadiusradius are closed. The closing_circleclosing_circleclosing_circleClosingCircleClosingCircle operation is defined as a dilation followed by a Minkowski subtraction, both with the same circular structuring element.

Attention

closing_circleclosing_circleclosing_circleClosingCircleClosingCircle is applied to each input region separately. If gaps between different regions are to be closed, union1union1union1Union1Union1 or union2union2union2Union2Union2 has to be called first.

Parallelization

• 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

Example (C)

my_closing_circle(Hobject In, double Radius, Hobject *Out)
{
  Hobject  tmp, StructElement;
  gen_circle(StructElement,100.0,100.0,Radius);
  dilation1(In,StructElement,&tmp,1);
  minkowski_sub1(tmp,StructElement,Out,1);
  clear_obj(tmp); clear_obj(StructElement);
}

Complexity

Let F1 be the area of the input region. Then the runtime complexity for one region is:

    O(4 * sqrt(F1) * Radius) .

Result

closing_circleclosing_circleclosing_circleClosingCircleClosingCircle 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.

Possible Predecessors

thresholdthresholdthresholdThresholdThreshold, regiongrowingregiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionconnectionConnectionConnection, union1union1union1Union1Union1, watershedswatershedswatershedsWatershedsWatersheds, class_ndim_normclass_ndim_normclass_ndim_normClassNdimNormClassNdimNorm

Possible Successors

reduce_domainreduce_domainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeselect_shapeSelectShapeSelectShape, area_centerarea_centerarea_centerAreaCenterAreaCenter, connectionconnectionconnectionConnectionConnection

Alternatives

rank_regionrank_regionrank_regionRankRegionRankRegion, fill_upfill_upfill_upFillUpFillUp, closingclosingclosingClosingClosing, closing_circleclosing_circleclosing_circleClosingCircleClosingCircle, closing_golayclosing_golayclosing_golayClosingGolayClosingGolay

See also

dilation1dilation1dilation1Dilation1Dilation1, minkowski_sub1minkowski_sub1minkowski_sub1MinkowskiSub1MinkowskiSub1, erosion1erosion1erosion1Erosion1Erosion1, openingopeningopeningOpeningOpening

Module

Foundation