pruningpruningPruningPruningpruning (Operator)

Name

pruningpruningPruningPruningpruning — Prune the branches of a region.

Signature

pruning(Region : RegionPrune : Length : )

Description

pruningpruningPruningPruningPruningpruning removes branches from a skeleton (RegionRegionRegionRegionregionregion) having a length less than LengthLengthLengthLengthlengthlength. All other branches are preserved.

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

RegionRegionRegionRegionregionregion (input_object) region(-array) → object

Regions to be processed.

RegionPruneRegionPruneRegionPruneRegionPruneregionPruneregion_prune (output_object) region(-array) → object

Result of the pruning operation.

LengthLengthLengthLengthlengthlength (input_control) integer → (integer)

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

skeletonskeletonSkeletonSkeletonSkeletonskeleton

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionConnectionconnection

Module

Foundation

Operators