rank_regionrank_regionRankRegionrank_regionRankRegionRankRegion (Operator)

Name

rank_regionrank_regionRankRegionrank_regionRankRegionRankRegion — Berechnen des Rangoperators für Regionen.

Signatur

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

rank_regionrank_regionRankRegionrank_regionRankRegionRankRegion berechnet den binären Rangoperator. Es wird eine Filtermaske (Rechteck: HeightHeightHeightHeightHeightheight x WidthWidthWidthWidthWidthwidth) verwendet. Dabei wird für jede Position die Anzahl der Punkte aus RegionRegionRegionRegionRegionregion gezählt, die in der Rechteckmaske liegen. Ist die Anzahl größer oder gleich NumberNumberNumberNumberNumbernumber, dann wird der Schwerpunkt des Rechtecks in der Ergebnisregion eingetragen. Wählt man

so erhält man den Median Operator.

Achtung

Als Werte für HeightHeightHeightHeightHeightheight und WidthWidthWidthWidthWidthwidth sind nur ungerade Zahlen > 3 zugelassen. Werden andere Werte eingegeben, so werden diese automatisch (ohne Fehlermeldung) entsprechend modifiziert (nächstgrößere ungerade Zahl).

Parallelisierung

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.

Parameter

RegionRegionRegionRegionRegionregion (input_object) region(-array) → object

Zu transformierende Region(en).

RegionCountRegionCountRegionCountRegionCountRegionCountregionCount (output_object) region(-array) → object

Ergebnisregion(en)

WidthWidthWidthWidthWidthwidth (input_control) extent.x → (integer)

Breite der Filtermaske.

Defaultwert: 15

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21

Typischer Wertebereich: 3 ≤ Width Width Width Width Width width ≤ 511 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

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

HeightHeightHeightHeightHeightheight (input_control) extent.y → (integer)

Höhe der Filtermaske.

Defaultwert: 15

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21

Typischer Wertebereich: 3 ≤ Height Height Height Height Height height ≤ 511 (lin)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

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

NumberNumberNumberNumberNumbernumber (input_control) integer → (integer)

Zahl der Punkte innerhalb der Filtermaske >= Number: Punkt wird in Ausgaberegion aufgenommen.

Defaultwert: 70

Wertevorschläge: 5, 10, 20, 40, 60, 80, 90, 120, 150, 200

Typischer Wertebereich: 1 ≤ Number Number Number Number Number number ≤ 1000 (lin)

Minimale Schrittweite: 1

Empfohlene Schrittweite: 10

Restriktion: Number > 0

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

Beispiel (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) ;

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

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

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

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

Komplexität

Sei F die Fläche der Eingaberegion, dann ist die Laufzeitkomplexität: O(F * 8).

Ergebnis

rank_regionrank_regionRankRegionrank_regionRankRegionRankRegion liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Das Verhalten bei leerer Eingabe (keine Eingaberegionen vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>), das bei leerer Region mit set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdthresholdThresholdThreshold, connectionconnectionConnectionconnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingregiongrowingRegiongrowingRegiongrowing, pouringpouringPouringpouringPouringPouring, class_ndim_normclass_ndim_normClassNdimNormclass_ndim_normClassNdimNormClassNdimNorm

Nachfolger

select_shapeselect_shapeSelectShapeselect_shapeSelectShapeSelectShape, disp_regiondisp_regionDispRegiondisp_regionDispRegionDispRegion

Alternativen

closing_rectangle1closing_rectangle1ClosingRectangle1closing_rectangle1ClosingRectangle1ClosingRectangle1, expand_regionexpand_regionExpandRegionexpand_regionExpandRegionExpandRegion

Siehe auch

rank_imagerank_imageRankImagerank_imageRankImageRankImage, mean_imagemean_imageMeanImagemean_imageMeanImageMeanImage

Modul

Foundation

Operatoren