eliminate_runseliminate_runsEliminateRunsEliminateRunseliminate_runs (Operator)
Name
eliminate_runseliminate_runsEliminateRunsEliminateRunseliminate_runs
— Eliminate runs of a given length.
Signature
Description
eliminate_runseliminate_runsEliminateRunsEliminateRunsEliminateRunseliminate_runs
eliminates all runs of the
run length encoding of the input regions which are shorter
than ElimShorterElimShorterElimShorterElimShorterelimShorterelim_shorter
or longer as
ElimLongerElimLongerElimLongerElimLongerelimLongerelim_longer
.
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) →
objectHRegionHObjectHRegionHobject
Region to be clipped.
RegionClippedRegionClippedRegionClippedRegionClippedregionClippedregion_clipped
(output_object) region(-array) →
objectHRegionHObjectHRegionHobject *
Clipped regions.
ElimShorterElimShorterElimShorterElimShorterelimShorterelim_shorter
(input_control) integer →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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
elim_shorter
≤
500
(lin)
Minimum increment: 1
Recommended increment: 1
ElimLongerElimLongerElimLongerElimLongerelimLongerelim_longer
(input_control) integer →
HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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
elim_longer
≤
10000
(lin)
Minimum increment: 1
Recommended increment: 10
Result
eliminate_runseliminate_runsEliminateRunsEliminateRunsEliminateRunseliminate_runs
returns 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>)set_system("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>)set_system("empty_region_result",<Result>)
.
If necessary, an exception is raised.
Possible Predecessors
thresholdthresholdThresholdThresholdThresholdthreshold
,
connectionconnectionConnectionConnectionConnectionconnection
,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing
,
pouringpouringPouringPouringPouringpouring
Possible Successors
erosion1erosion1Erosion1Erosion1Erosion1erosion1
,
dilation1dilation1Dilation1Dilation1Dilation1dilation1
,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region
Alternatives
shape_transshape_transShapeTransShapeTransShapeTransshape_trans
Module
Foundation