ClassesClassesClassesClasses | | | | Operators

opening_golayopening_golayOpeningGolayopening_golayOpeningGolayOpeningGolay (Operator)

Name

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

Warning

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

Signature

opening_golay(Region : RegionOpening : GolayElement, Rotation : )

Herror opening_golay(const Hobject Region, Hobject* RegionOpening, const char* GolayElement, const Hlong Rotation)

Herror T_opening_golay(const Hobject Region, Hobject* RegionOpening, const Htuple GolayElement, const Htuple Rotation)

Herror opening_golay(Hobject Region, Hobject* RegionOpening, const HTuple& GolayElement, const HTuple& Rotation)

HRegion HRegion::OpeningGolay(const HTuple& GolayElement, const HTuple& Rotation) const

HRegionArray HRegionArray::OpeningGolay(const HTuple& GolayElement, const HTuple& Rotation) const

void OpeningGolay(const HObject& Region, HObject* RegionOpening, const HTuple& GolayElement, const HTuple& Rotation)

HRegion HRegion::OpeningGolay(const HString& GolayElement, Hlong Rotation) const

HRegion HRegion::OpeningGolay(const char* GolayElement, Hlong Rotation) const

void HOperatorSetX.OpeningGolay(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX*RegionOpening, [in] VARIANT GolayElement, [in] VARIANT Rotation)

IHRegionX* HRegionX.OpeningGolay(
[in] BSTR GolayElement, [in] Hlong Rotation)

static void HOperatorSet.OpeningGolay(HObject region, out HObject regionOpening, HTuple golayElement, HTuple rotation)

HRegion HRegion.OpeningGolay(string golayElement, int rotation)

Description

opening_golayopening_golayOpeningGolayopening_golayOpeningGolayOpeningGolay is defined as a Minkowski subtraction followed by a Minkowski addition. First the Minkowski subtraction of the input region (RegionRegionRegionRegionRegionregion) with the structuring element from the Golay alphabet defined by GolayElementGolayElementGolayElementGolayElementGolayElementgolayElement and RotationRotationRotationRotationRotationrotation 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 RotationRotationRotationRotationRotationrotation 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_elementsGolayElementsgolay_elementsGolayElementsGolayElements.

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

Attention

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

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Regions to be opened.

RegionOpeningRegionOpeningRegionOpeningRegionOpeningRegionOpeningregionOpening (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Opened regions.

GolayElementGolayElementGolayElementGolayElementGolayElementgolayElement (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Structuring element from the Golay alphabet.

Default value: 'h' "h" "h" "h" "h" "h"

List of values: 'c'"c""c""c""c""c", 'd'"d""d""d""d""d", 'e'"e""e""e""e""e", 'f'"f""f""f""f""f", 'f2'"f2""f2""f2""f2""f2", 'h'"h""h""h""h""h", 'i'"i""i""i""i""i", 'k'"k""k""k""k""k", 'l'"l""l""l""l""l", 'm'"m""m""m""m""m"

RotationRotationRotationRotationRotationrotation (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Rotation of the Golay element. Depending on the element, not all rotations are valid.

Default value: 0

List of values: 0, 2, 4, 6, 8, 10, 12, 14, 1, 3, 5, 7, 9, 11, 13, 15

Complexity

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

Result

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

Otherwise, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdthresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionconnectionConnectionConnection, union1union1Union1union1Union1Union1, watershedswatershedsWatershedswatershedsWatershedsWatersheds, class_ndim_normclass_ndim_normClassNdimNormclass_ndim_normClassNdimNormClassNdimNorm

Possible Successors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, connectionconnectionConnectionconnectionConnectionConnection

Alternatives

opening_segopening_segOpeningSegopening_segOpeningSegOpeningSeg, openingopeningOpeningopeningOpeningOpening

See also

erosion_golayerosion_golayErosionGolayerosion_golayErosionGolayErosionGolay, dilation_golaydilation_golayDilationGolaydilation_golayDilationGolayDilationGolay, closing_golayclosing_golayClosingGolayclosing_golayClosingGolayClosingGolay, hit_or_miss_golayhit_or_miss_golayHitOrMissGolayhit_or_miss_golayHitOrMissGolayHitOrMissGolay, thinning_golaythinning_golayThinningGolaythinning_golayThinningGolayThinningGolay, thickening_golaythickening_golayThickeningGolaythickening_golayThickeningGolayThickeningGolay, golay_elementsgolay_elementsGolayElementsgolay_elementsGolayElementsGolayElements

Module

Foundation


ClassesClassesClassesClasses | | | | Operators