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 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>)
empty region: set_system('empty_region_result',<RegionResult>)

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