rank_regionrank_regionRankRegionRankRegionrank_region (Operator)

Name

rank_regionrank_regionRankRegionRankRegionrank_region — Rank operator for regions.

Signature

rank_region(Region : RegionCount : Width, Height, Number : )

Description

rank_regionrank_regionRankRegionRankRegionrank_region calculates the binary rank operator. A filter mask of size HeightHeightHeightheightheight x WidthWidthWidthwidthwidth) is used. In the process, for each point in the region the number of points of RegionRegionRegionregionregion lying within the filter mask are counted. If this number is greater or equal to NumberNumberNumbernumbernumber, the current point is added to the output region. If is chosen, the median operator is obtained.

Attention

For HeightHeightHeightheightheight and WidthWidthWidthwidthwidth only odd values > 3 are valid. If invalid parameters are chosen they are converted automatically (without raising an exception) to the next larger odd values.

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(s) to be transformed.

RegionCountRegionCountRegionCountregionCountregion_count (output_object) region(-array) → object

Resulting region(s).

WidthWidthWidthwidthwidth (input_control) extent.x → (integer)

Width of the filter mask.

Default: 15

Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21

Value range: 3 ≤ Width Width Width width width ≤ 511 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: Width >= 3 && odd(Width)

HeightHeightHeightheightheight (input_control) extent.y → (integer)

Height of the filter mask.

Default: 15

Suggested values: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21

Value range: 3 ≤ Height Height Height height height ≤ 511 (lin)

Minimum increment: 2

Recommended increment: 2

Restriction: Height >= 3 && odd(Height)

NumberNumberNumbernumbernumber (input_control) integer → (integer)

Minimum number of points lying within the filter mask.

Default: 70

Suggested values: 5, 10, 20, 40, 60, 80, 90, 120, 150, 200

Value range: 1 ≤ Number Number Number number number ≤ 1000 (lin)

Minimum increment: 1

Recommended increment: 10

Restriction: Number > 0

Example (HDevelop)

read_image(Image,'monkey')
mean_image(Image,Mean,5,5)
dyn_threshold(Image,Mean,Points,25,'light')
rank_region(Points,Textur,15,15,30)
gen_circle(Mask,10,10,3)
opening(Textur,Mask,Seg)

Example (C)

read_image(&Image,"monkey");
mean_image(Image,&Mean,5,5);
dyn_threshold(Image,Mean,&Points,25,"light");
rank_region(Points,Textur,15,15,30);
gen_circle(&Mask,10,10,3);
opening(Textur,Mask,&Seg);

Example (HDevelop)

read_image(Image,'monkey')
mean_image(Image,Mean,5,5)
dyn_threshold(Image,Mean,Points,25,'light')
rank_region(Points,Textur,15,15,30)
gen_circle(Mask,10,10,3)
opening(Textur,Mask,Seg)

Example (HDevelop)

read_image(Image,'monkey')
mean_image(Image,Mean,5,5)
dyn_threshold(Image,Mean,Points,25,'light')
rank_region(Points,Textur,15,15,30)
gen_circle(Mask,10,10,3)
opening(Textur,Mask,Seg)