fittingfittingFittingFitting (Operator)

Name

fittingfittingFittingFitting — Perform a closing after an opening with multiple structuring elements.

Warning

gauss_imagegauss_imageGaussImageGaussImageGaussImage is obsolete and is only provided for reasons of backward compatibility.

Signature

fitting(Region, StructElements : RegionFitted : : )

fittingfittingFittingFittingFitting performs an openingopeningOpeningOpeningOpening and a closingclosingClosingClosingClosing successively on the input regions. The eight structuring elements normally used for this operation can be generated with the operator gen_struct_elementsgen_struct_elementsGenStructElementsGenStructElementsGenStructElements. However, other user-defined structuring elements can also be used. Let R be the input region(s) and let denote the structuring elements. Furthermore, let P be the result of the opening and Q be the final result. Then the operator can be formalized as follows:

Regions larger than the structuring elements are preserved, while small gaps are closed.

Execution Information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

RegionRegionRegionRegionregion (input_object) region(-array) → object

Regions to be processed.

StructElementsStructElementsStructElementsStructElementsstructElements (input_object) region(-array) → object

Structuring elements.

RegionFittedRegionFittedRegionFittedRegionFittedregionFitted (output_object) region(-array) → object

Fitted regions.

Result

fittingfittingFittingFittingFitting 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

gen_struct_elementsgen_struct_elementsGenStructElementsGenStructElementsGenStructElements, gen_region_pointsgen_region_pointsGenRegionPointsGenRegionPointsGenRegionPoints

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter, connectionconnectionConnectionConnectionConnection

Alternatives

openingopeningOpeningOpeningOpening, closingclosingClosingClosingClosing, connectionconnectionConnectionConnectionConnection, select_shapeselect_shapeSelectShapeSelectShapeSelectShape

Module

Foundation

Operators