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