rank_imagerank_imageRankImageRankImage (Operator)

Name

rank_imagerank_imageRankImageRankImage — Rangfilterung mit beliebigen Masken.

Signatur

rank_image(Image, Mask : ImageRank : Rank, Margin : )

Herror rank_image(const Hobject Image, const Hobject Mask, Hobject* ImageRank, const Hlong Rank, const char* Margin)

Herror T_rank_image(const Hobject Image, const Hobject Mask, Hobject* ImageRank, const Htuple Rank, const Htuple Margin)

void RankImage(const HObject& Image, const HObject& Mask, HObject* ImageRank, const HTuple& Rank, const HTuple& Margin)

HImage HImage::RankImage(const HRegion& Mask, Hlong Rank, const HTuple& Margin) const

HImage HImage::RankImage(const HRegion& Mask, Hlong Rank, const HString& Margin) const

HImage HImage::RankImage(const HRegion& Mask, Hlong Rank, const char* Margin) const

HImage HImage::RankImage(const HRegion& Mask, Hlong Rank, const wchar_t* Margin) const   (Nur Windows)

static void HOperatorSet.RankImage(HObject image, HObject mask, out HObject imageRank, HTuple rank, HTuple margin)

HImage HImage.RankImage(HRegion mask, int rank, HTuple margin)

HImage HImage.RankImage(HRegion mask, int rank, string margin)

Beschreibung

rank_imagerank_imageRankImageRankImageRankImage führt eine Rangfilterung des Eingabebildes ImageImageImageImageimage mit einer Maske, die durch die Region MaskMaskMaskMaskmask beschrieben wird, durch und liefert das gefilterte Bild in ImageRankImageRankImageRankImageRankimageRank zurück. Die Form der Maske kann beliebig gewählt werden und z.B. mit Operatoren wie gen_circlegen_circleGenCircleGenCircleGenCircle oder draw_regiondraw_regionDrawRegionDrawRegionDrawRegion erzeugt werden. Die Position der Maske spielt dabei keine Rolle, da der Schwerpunkt der Maskenregion als Referenzpunkt der Maske verwendet wird.

Konzeptuell sortiert der Rangfilter alle Grauwerte innerhalb der Maske aufsteigend und wählt dann den Grauwert mit dem Rang RankRankRankRankrank aus. Dabei entspricht der Rang 1 dem kleinsten Grauwert und der Rang A dem größten Grauwert innerhalb der Maske. Hierbei ist A die Fläche von MaskMaskMaskMaskmask (siehe area_centerarea_centerAreaCenterAreaCenterAreaCenter). Für RankRankRankRankrank = (A - 1) / 2 + 1 liefert rank_imagerank_imageRankImageRankImageRankImage den Median zurück (siehe median_imagemedian_imageMedianImageMedianImageMedianImage). Für RankRankRankRankrank = 1 entspricht rank_imagerank_imageRankImageRankImageRankImage einer Grauwerterosion (siehe gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape und gray_erosiongray_erosionGrayErosionGrayErosionGrayErosion), für RankRankRankRankrank = A entspricht rank_rectrank_rectRankRectRankRectRankRect einer Grauwertdilatation (siehe gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRect, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShape und gray_dilationgray_dilationGrayDilationGrayDilationGrayDilation).

rank_imagerank_imageRankImageRankImageRankImage kann unter anderem zur Rauschunterdrückung oder zum Unterdrücken unerwünschter Objekte, die kleiner als die Maske sind, verwendet werden. Außerdem ist rank_imagerank_imageRankImageRankImageRankImage unempfindlicher gegenüber Rauschen als die entsprechenden Operatoren der Grauwertmorpholgie. Um eine robustere Version der Grauwertmorphologie zu erhalten, empfiehlt es sich daher, anstatt 1 bzw. A etwas höhere bzw. niedrigere Werte für RankRankRankRankrank zu wählen.

Bei der Filterung kann über MarginMarginMarginMarginmargin zwischen verschiedenen Randbehandlungen gewählt werden: Grauwert Bildpunkte außerhalb der Bildränder werden als konstant (mit dem angegebenen Grauwert) angenommen. 'continued' Fortsetzung der Randpunkte. 'cyclic' zyklische Fortsetzung der Bildränder. 'mirrored' Spiegelung der Bildpunkte an den Bildrändern.

Das Konzept der Glättungsfilter ist in der Einleitung zum Kapitel Filter / Glättung beschrieben.

Achtung

rank_imagerank_imageRankImageRankImageRankImage verwendet einen Algorithmus mit einer Laufzeit pro Pixel, die von der Anzahl der Sehnen der Maske MaskMaskMaskMaskmask abhängt. Daher ist rank_imagerank_imageRankImageRankImageRankImage für rechteckige Masken mit einer großen Maskenhöhe langsamer als rank_rectrank_rectRankRectRankRectRankRect. Die genaue Maskenhöhe, ab der rank_rectrank_rectRankRectRankRectRankRect schneller ist, ist abhängig von der Rechnerarchitektur (Prozessortyp, Verfügbarkeit von SIMD-Befehlen wie SSE2 oder MMX, Cachegröße und -durchsatz, Speicherdurchsatz). Typischerweise ist das für eine Maskenhöhe > 15 der Fall, kann aber z.B. bei nicht vorhandenen SIMD-Befehlen und langsamem Speicher auch erst für größere Maskenhöhen zutreffen.

Weiterhin ist zu beachten, dass rank_rectrank_rectRankRectRankRectRankRect aufgrund der rekursiven Implementierung die Filterantwort intern auf dem kleinsten umschließenden Rechteck der Region des Bildes berechnet. Falls die Region nur einen sehr kleinen Teil des umschließenden Rechtecks abdeckt, kann es daher vorkommen, dass rank_imagerank_imageRankImageRankImageRankImage auch für größere Maskenhöhen schneller als rank_rectrank_rectRankRectRankRectRankRect ist.

rank_imagerank_imageRankImageRankImageRankImage sollte weder mit RankRankRankRankrank = 1 zur Berechnung einer Grauwerterosion noch mit RankRankRankRankrank = A zur Berechnung einer Grauwertdilatation verwendet werden. In diesen Fällen sind die Operatoren gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape oder gray_erosiongray_erosionGrayErosionGrayErosionGrayErosion bzw. gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRect, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShape oder gray_dilationgray_dilationGrayDilationGrayDilationGrayDilation typischerweise schneller als rank_imagerank_imageRankImageRankImageRankImage.

Beachten Sie, dass Filteroperatoren eventuell unerwartete Resultate ausgeben, wenn ein Bild mit einer reduzierten Domäne als Input übergeben wird. Weitere Informationen können im Kapitel Filter gefunden werden.

Ausführungsinformationen

Parameter

ImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHobject (byte / int2 / uint2 / int4 / real)

Zu filterndes Bild.

MaskMaskMaskMaskmask (input_object)  region objectHRegionHRegionHobject

Filtermaske.

ImageRankImageRankImageRankImageRankimageRank (output_object)  multichannel-image(-array) objectHImageHImageHobject * (byte / int2 / uint2 / int4 / real)

Gefiltertes Bild.

RankRankRankRankrank (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Rang des Ausgabegrauwerts.

Defaultwert: 5

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 31, 49, 51, 61, 71, 81, 91, 101

Typischer Wertebereich: 1 ≤ Rank Rank Rank Rank rank ≤ 4095

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

MarginMarginMarginMarginmargin (input_control)  string HTupleHTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Randbehandlung.

Defaultwert: 'mirrored' "mirrored" "mirrored" "mirrored" "mirrored"

Wertevorschläge: 'mirrored'"mirrored""mirrored""mirrored""mirrored", 'cyclic'"cyclic""cyclic""cyclic""cyclic", 'continued'"continued""continued""continued""continued", 0, 30, 60, 90, 120, 150, 180, 210, 240, 255

Beispiel (HDevelop)

read_image (Image, 'fabrik')
draw_region (Region, WindowHandle)
rank_image (Image, Region, ImageRank, 5, 'mirrored')
dev_display(ImageRank)

Komplexität

Pro Bildpunkt: O(N), wobei N die Anzahl der Sehnen von MaskMaskMaskMaskmask ist (siehe runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeatures).

Ergebnis

Sind die Parameterwerte korrekt, dann liefert rank_imagerank_imageRankImageRankImageRankImage den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels 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>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageReadImageReadImage, draw_regiondraw_regionDrawRegionDrawRegionDrawRegion, gen_circlegen_circleGenCircleGenCircleGenCircle, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1, gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2

Nachfolger

thresholdthresholdThresholdThresholdThreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing

Alternativen

rank_rectrank_rectRankRectRankRectRankRect, median_imagemedian_imageMedianImageMedianImageMedianImage, median_rectmedian_rectMedianRectMedianRectMedianRect

Siehe auch

gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRect, gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShape, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShape, gray_erosiongray_erosionGrayErosionGrayErosionGrayErosion, gray_dilationgray_dilationGrayDilationGrayDilationGrayDilation

Literatur

T.S. Huang, G.J. Yang, G.Y. Tang; „A Fast Two-Dimensional Median Filtering Algorithm“; IEEE Transactions on Acoustics, Speech, and Signal Processing, vol. 27, no. 1, pp. 13-18, 1979.
R. Haralick, L. Shapiro; „Computer and Robot Vision“; Addison-Wesley, 1992, pp. 318-320.

Modul

Foundation