Operator Reference

HALCON Operator Reference / Legacy / Morphology

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

ClassesClasses | | Operators

thickening_seqthickening_seqThickeningSeqThickeningSeqthickening_seq (Operator)

thickening_seqthickening_seqThickeningSeqThickeningSeqthickening_seq — Add the result of a hit-or-miss operation to a region (sequential).

Warning

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

Signature

thickening_seq(Region : RegionThick : GolayElement, Iterations : )

Herror thickening_seq(const Hobject Region, Hobject* RegionThick, const char* GolayElement, const Hlong Iterations)

Herror T_thickening_seq(const Hobject Region, Hobject* RegionThick, const Htuple GolayElement, const Htuple Iterations)

void ThickeningSeq(const HObject& Region, HObject* RegionThick, const HTuple& GolayElement, const HTuple& Iterations)

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

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

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

static void HOperatorSet.ThickeningSeq(HObject region, out HObject regionThick, HTuple golayElement, HTuple iterations)

HRegion HRegion.ThickeningSeq(string golayElement, int iterations)

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

Description

thickening_seqthickening_seqThickeningSeqThickeningSeqthickening_seq calculates the sequential thickening of the input regions with a structuring element from the Golay alphabet (GolayElementGolayElementGolayElementgolayElementgolay_element). To do so, thickening_seqthickening_seqThickeningSeqThickeningSeqthickening_seq calls the operator thickening_golaythickening_golayThickeningGolayThickeningGolaythickening_golay with all possible rotations of the structuring element IterationsIterationsIterationsiterationsiterations times. The following structuring elements are available:

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

The Golay elements, together with all possible rotations, are described with the operator golay_elementsgolay_elementsGolayElementsGolayElementsgolay_elements. For all elements of the Golay alphabet, except for 'c', the foreground and background masks are exchanged in order to have an effect for them on the outer boundary of the region. The element 'c' can be used to generate the convex hull of the input region if enough iterations are performed.

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

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

Result of the thickening operator.

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", 'e'"e""e""e""e", 'f'"f""f""f""f", 'f2'"f2""f2""f2""f2", 'h'"h""h""h""h", 'i'"i""i""i""i", 'k'"k""k""k""k", 'l'"l""l""l""l", 'm'"m""m""m""m"

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, 70, 100, 200

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

thickening_seqthickening_seqThickeningSeqThickeningSeqthickening_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 Successors

reduce_domainreduce_domainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionconnection

Alternatives

thickening_golaythickening_golayThickeningGolayThickeningGolaythickening_golay, thickeningthickeningThickeningThickeningthickening

See also

erosion_golayerosion_golayErosionGolayErosionGolayerosion_golay, thinning_seqthinning_seqThinningSeqThinningSeqthinning_seq

Module

Foundation

---

ClassesClasses | | Operators