HALCON Website / HALCON Operator Reference / Morphology / Region
ClassesClassesClassesClasses | | | | Operators

pruningpruningPruningpruningPruningPruning (Operator)

Name

pruningpruningPruningpruningPruningPruning — Prune the branches of a region.

Signature

pruning(Region : RegionPrune : Length : )

Herror pruning(const Hobject Region, Hobject* RegionPrune, const Hlong Length)

Herror T_pruning(const Hobject Region, Hobject* RegionPrune, const Htuple Length)

Herror pruning(Hobject Region, Hobject* RegionPrune, const HTuple& Length)

HRegion HRegion::Pruning(const HTuple& Length) const

HRegionArray HRegionArray::Pruning(const HTuple& Length) const

void Pruning(const HObject& Region, HObject* RegionPrune, const HTuple& Length)

HRegion HRegion::Pruning(Hlong Length) const

void HOperatorSetX.Pruning(
[in] IHUntypedObjectX* Region, [out] IHUntypedObjectX** RegionPrune, [in] VARIANT Length)

IHRegionX* HRegionX.Pruning([in] Hlong Length)

static void HOperatorSet.Pruning(HObject region, out HObject regionPrune, HTuple length)

HRegion HRegion.Pruning(int length)

Description

pruningpruningPruningpruningPruningPruning removes branches from a skeleton (RegionRegionRegionRegionRegionregion) having a length less than LengthLengthLengthLengthLengthlength. All other branches are preserved.

Parallelization

Parameters

RegionRegionRegionRegionRegionregion (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Regions to be processed.

RegionPruneRegionPruneRegionPruneRegionPruneRegionPruneregionPrune (output_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject *

Result of the pruning operation.

LengthLengthLengthLengthLengthlength (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Length of the branches to be removed.

Default value: 2

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

Typical range of values: 1 ≤ Length Length Length Length Length length ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

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

Result

pruningpruningPruningpruningPruningPruning 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

morph_skizmorph_skizMorphSkizmorph_skizMorphSkizMorphSkiz, skeletonskeletonSkeletonskeletonSkeletonSkeleton, thinning_seqthinning_seqThinningSeqthinning_seqThinningSeqThinningSeq

Possible Successors

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, area_centerarea_centerAreaCenterarea_centerAreaCenterAreaCenter, connectionconnectionConnectionconnectionConnectionConnection

See also

morph_skeletonmorph_skeletonMorphSkeletonmorph_skeletonMorphSkeletonMorphSkeleton, junctions_skeletonjunctions_skeletonJunctionsSkeletonjunctions_skeletonJunctionsSkeletonJunctionsSkeleton

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH