eliminate_runseliminate_runsEliminateRunsEliminateRuns (Operator)

Name

eliminate_runseliminate_runsEliminateRunsEliminateRuns — Eliminate runs of a given length.

Signature

eliminate_runs(Region : RegionClipped : ElimShorter, ElimLonger : )

Description

eliminate_runseliminate_runsEliminateRunsEliminateRunsEliminateRuns eliminates all runs of the run length encoding of the input regions which are shorter than ElimShorterElimShorterElimShorterElimShorterelimShorter or longer as ElimLongerElimLongerElimLongerElimLongerelimLonger.

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) → object

Region to be clipped.

RegionClippedRegionClippedRegionClippedRegionClippedregionClipped (output_object) region(-array) → object

Clipped regions.

ElimShorterElimShorterElimShorterElimShorterelimShorter (input_control) integer → (integer)

All runs which are shorter are eliminated.

Default value: 3

Suggested values: 2, 3, 4, 5, 6, 8, 10, 12, 15

Typical range of values: 1 ≤ ElimShorter ElimShorter ElimShorter ElimShorter elimShorter ≤ 500 (lin)

Minimum increment: 1

Recommended increment: 1

ElimLongerElimLongerElimLongerElimLongerelimLonger (input_control) integer → (integer)

All runs which are longer are eliminated.

Default value: 1000

Suggested values: 50, 100, 200, 500, 1000, 2000

Typical range of values: 1 ≤ ElimLonger ElimLonger ElimLonger ElimLonger elimLonger ≤ 10000 (lin)

Minimum increment: 1

Recommended increment: 10

Result

eliminate_runseliminate_runsEliminateRunsEliminateRunsEliminateRuns returns 2 (H_MSG_TRUE) if all parameters are correct. The behavior in case of empty input (no regions given) can be set via set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) and the behavior in case of an empty input region via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>). If necessary, an exception is raised.

Possible Predecessors

thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, pouringpouringPouringPouringPouring

Possible Successors

erosion1erosion1Erosion1Erosion1Erosion1, dilation1dilation1Dilation1Dilation1Dilation1, disp_regiondisp_regionDispRegionDispRegionDispRegion

Alternatives

shape_transshape_transShapeTransShapeTransShapeTrans

Module

Foundation