opening_golayopening_golayOpeningGolayOpeningGolay (Operator)

Name

opening_golayopening_golayOpeningGolayOpeningGolay — Open a region with an element from the Golay alphabet.

Warning

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

Signature

Description

opening_golayopening_golayOpeningGolayOpeningGolayOpeningGolay is defined as a Minkowski subtraction followed by a Minkowski addition. First the Minkowski subtraction of the input region (RegionRegionRegionRegionregion) with the structuring element from the Golay alphabet defined by GolayElementGolayElementGolayElementGolayElementgolayElement and RotationRotationRotationRotationrotation is computed. Then the Minkowski addition of the result and the structuring element rotated by 180 degrees is performed.

The following structuring elements are available:

'l', 'm', 'd', 'c', 'e', 'i', 'f', 'f2', 'h', 'k'.

The rotation number RotationRotationRotationRotationrotation determines which rotation of the element should be used, and whether the foreground (even) or background version (odd) of the selected element should be used. The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsGolayElementsGolayElementsGolayElements.

opening_golayopening_golayOpeningGolayOpeningGolayOpeningGolay serves to eliminate regions smaller than the structuring element, and to smooth regions' boundaries.

Attention

Not all values of RotationRotationRotationRotationrotation are valid for any Golay element. For some of the values of RotationRotationRotationRotationrotation, the resulting regions are identical to the input regions.

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

Complexity

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

Result

opening_golayopening_golayOpeningGolayOpeningGolayOpeningGolay 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_normClassNdimNormClassNdimNormClassNdimNorm

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter, connectionconnectionConnectionConnectionConnection

Alternatives

opening_segopening_segOpeningSegOpeningSegOpeningSeg, openingopeningOpeningOpeningOpening

See also

erosion_golayerosion_golayErosionGolayErosionGolayErosionGolay, dilation_golaydilation_golayDilationGolayDilationGolayDilationGolay, closing_golayclosing_golayClosingGolayClosingGolayClosingGolay, hit_or_miss_golayhit_or_miss_golayHitOrMissGolayHitOrMissGolayHitOrMissGolay, thinning_golaythinning_golayThinningGolayThinningGolayThinningGolay, thickening_golaythickening_golayThickeningGolayThickeningGolayThickeningGolay, golay_elementsgolay_elementsGolayElementsGolayElementsGolayElements

Module

Foundation