Operator Reference

HALCON Operator Reference / Legacy / Morphology

• HDevelop
• .NET
• Python
• C++
• C

ClassesClasses | | Operators

dilation_seqdilation_seqDilationSeqDilationSeqdilation_seq (Operator)

dilation_seqdilation_seqDilationSeqDilationSeqdilation_seq — Dilate a region sequentially.

Warning

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

Signature

dilation_seq(Region : RegionDilation : GolayElement, Iterations : )

Herror dilation_seq(const Hobject Region, Hobject* RegionDilation, const char* GolayElement, const Hlong Iterations)

Herror T_dilation_seq(const Hobject Region, Hobject* RegionDilation, const Htuple GolayElement, const Htuple Iterations)

void DilationSeq(const HObject& Region, HObject* RegionDilation, const HTuple& GolayElement, const HTuple& Iterations)

HRegion HRegion::DilationSeq(const HString& GolayElement, Hlong Iterations) const

HRegion HRegion::DilationSeq(const char* GolayElement, Hlong Iterations) const

HRegion HRegion::DilationSeq(const wchar_t* GolayElement, Hlong Iterations) const   ( Windows only)

static void HOperatorSet.DilationSeq(HObject region, out HObject regionDilation, HTuple golayElement, HTuple iterations)

HRegion HRegion.DilationSeq(string golayElement, int iterations)

def dilation_seq(region: HObject, golay_element: str, iterations: int) -> HObject

Description

dilation_seqdilation_seqDilationSeqDilationSeqdilation_seq computes the sequential dilation of the input region RegionRegionRegionregionregion with the selected structuring element GolayElementGolayElementGolayElementgolayElementgolay_element from the Golay alphabet. This is done by executing the operator dilation_golaydilation_golayDilationGolayDilationGolaydilation_golay with all rotations of the structuring element IterationsIterationsIterationsiterationsiterations times. The following structuring elements can be selected:

'l', 'd', 'c', 'f', 'h', 'k'.

In order to compute the skeleton of a region, usually the elements 'l' and 'm' are used. Only the “foreground elements” (even rotation numbers) are used. The elements 'i' and 'e' result in unchanged output regions. The elements 'l', 'm' and 'f2' are identical for the foreground. The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements.

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

RegionRegionRegionregionregion (input_object)  region(-array) → objectHRegionHObjectHObjectHobject

Regions to be dilated.

RegionDilationRegionDilationRegionDilationregionDilationregion_dilation (output_object)  region(-array) → objectHRegionHObjectHObjectHobject *

Dilated regions.

GolayElementGolayElementGolayElementgolayElementgolay_element (input_control)  string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Structuring element from the Golay alphabet.

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

List of values: 'c'"c""c""c""c", 'd'"d""d""d""d", 'f'"f""f""f""f", 'h'"h""h""h""h", 'k'"k""k""k""k", 'l'"l""l""l""l"

IterationsIterationsIterationsiterationsiterations (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Number of iterations.

Default: 1

Suggested values: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 15, 17, 20, 30, 40, 50

Value range: 1 ≤ Iterations Iterations Iterations iterations iterations (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

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

Result

dilation_seqdilation_seqDilationSeqDilationSeqdilation_seq 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>)set_system("no_object_result",<RegionResult>)SetSystem("no_object_result",<RegionResult>)SetSystem("no_object_result",<RegionResult>)set_system("no_object_result",<RegionResult>)

• empty region: set_system('empty_region_result',<RegionResult>)set_system("empty_region_result",<RegionResult>)SetSystem("empty_region_result",<RegionResult>)SetSystem("empty_region_result",<RegionResult>)set_system("empty_region_result",<RegionResult>)

Otherwise, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionconnection, union1union1Union1Union1union1, watershedswatershedsWatershedsWatershedswatersheds, class_ndim_normclass_ndim_normClassNdimNormClassNdimNormclass_ndim_norm

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionconnection

Alternatives

dilation1dilation1Dilation1Dilation1dilation1, dilation2dilation2Dilation2Dilation2dilation2, dilation_golaydilation_golayDilationGolayDilationGolaydilation_golay

See also

erosion_seqerosion_seqErosionSeqErosionSeqerosion_seq, hit_or_miss_seqhit_or_miss_seqHitOrMissSeqHitOrMissSeqhit_or_miss_seq, thinning_seqthinning_seqThinningSeqThinningSeqthinning_seq

Module

Foundation

---

ClassesClasses | | Operators