rank_imagerank_imageRankImageRankImagerank_image (Operator)

Name

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

def rank_image(image: HObject, mask: HObject, rank: int, margin: Union[int, float, str]) -> HObject

Beschreibung

rank_imagerank_imageRankImageRankImageRankImagerank_image führt eine Rangfilterung des Eingabebildes ImageImageImageImageimageimage mit einer Maske, die durch die Region MaskMaskMaskMaskmaskmask beschrieben wird, durch und liefert das gefilterte Bild in ImageRankImageRankImageRankImageRankimageRankimage_rank zurück. Die Form der Maske kann beliebig gewählt werden und z.B. mit Operatoren wie gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle oder draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region 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 RankRankRankRankrankrank 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 MaskMaskMaskMaskmaskmask (siehe area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center). Für RankRankRankRankrankrank = (A - 1) / 2 + 1 liefert rank_imagerank_imageRankImageRankImageRankImagerank_image den Median zurück (siehe median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image). Für RankRankRankRankrankrank = 1 entspricht rank_imagerank_imageRankImageRankImageRankImagerank_image einer Grauwerterosion (siehe gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShapegray_erosion_shape und gray_erosiongray_erosionGrayErosionGrayErosionGrayErosiongray_erosion), für RankRankRankRankrankrank = A entspricht rank_rectrank_rectRankRectRankRectRankRectrank_rect einer Grauwertdilatation (siehe gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_shape und gray_dilationgray_dilationGrayDilationGrayDilationGrayDilationgray_dilation).

rank_imagerank_imageRankImageRankImageRankImagerank_image 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_imageRankImageRankImageRankImagerank_image 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 RankRankRankRankrankrank zu wählen.

Bei der Filterung kann über MarginMarginMarginMarginmarginmargin 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_imageRankImageRankImageRankImagerank_image verwendet einen Algorithmus mit einer Laufzeit pro Pixel, die von der Anzahl der Sehnen der Maske MaskMaskMaskMaskmaskmask abhängt. Daher ist rank_imagerank_imageRankImageRankImageRankImagerank_image für rechteckige Masken mit einer großen Maskenhöhe langsamer als rank_rectrank_rectRankRectRankRectRankRectrank_rect. Die genaue Maskenhöhe, ab der rank_rectrank_rectRankRectRankRectRankRectrank_rect 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_rectRankRectRankRectRankRectrank_rect 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_imageRankImageRankImageRankImagerank_image auch für größere Maskenhöhen schneller als rank_rectrank_rectRankRectRankRectRankRectrank_rect ist.

rank_imagerank_imageRankImageRankImageRankImagerank_image sollte weder mit RankRankRankRankrankrank = 1 zur Berechnung einer Grauwerterosion noch mit RankRankRankRankrankrank = A zur Berechnung einer Grauwertdilatation verwendet werden. In diesen Fällen sind die Operatoren gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShapegray_erosion_shape oder gray_erosiongray_erosionGrayErosionGrayErosionGrayErosiongray_erosion bzw. gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_shape oder gray_dilationgray_dilationGrayDilationGrayDilationGrayDilationgray_dilation typischerweise schneller als rank_imagerank_imageRankImageRankImageRankImagerank_image.

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

ImageImageImageImageimageimage (input_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject (byte / int2 / uint2 / int4 / real)

Zu filterndes Bild.

MaskMaskMaskMaskmaskmask (input_object)  region objectHRegionHObjectHRegionHobject

Filtermaske.

ImageRankImageRankImageRankImageRankimageRankimage_rank (output_object)  multichannel-image(-array) objectHImageHObjectHImageHobject * (byte / int2 / uint2 / int4 / real)

Gefiltertes Bild.

RankRankRankRankrankrank (input_control)  integer HTupleintHTupleHtuple (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 rank ≤ 4095

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

MarginMarginMarginMarginmarginmargin (input_control)  string HTupleUnion[int, float, str]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Randbehandlung.

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

Wertevorschläge: 'mirrored'"mirrored""mirrored""mirrored""mirrored""mirrored", 'cyclic'"cyclic""cyclic""cyclic""cyclic""cyclic", 'continued'"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 MaskMaskMaskMaskmaskmask ist (siehe runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeaturesrunlength_features).

Ergebnis

Sind die Parameterwerte korrekt, dann liefert rank_imagerank_imageRankImageRankImageRankImagerank_image den Wert 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>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

read_imageread_imageReadImageReadImageReadImageread_image, draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region, gen_circlegen_circleGenCircleGenCircleGenCirclegen_circle, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1GenRectangle1gen_rectangle1, gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2GenRectangle2gen_rectangle2

Nachfolger

thresholdthresholdThresholdThresholdThresholdthreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholdDynThresholddyn_threshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing

Alternativen

rank_rectrank_rectRankRectRankRectRankRectrank_rect, median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image, median_rectmedian_rectMedianRectMedianRectMedianRectmedian_rect

Siehe auch

gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapeGrayErosionShapegray_erosion_shape, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapeGrayDilationShapegray_dilation_shape, gray_erosiongray_erosionGrayErosionGrayErosionGrayErosiongray_erosion, gray_dilationgray_dilationGrayDilationGrayDilationGrayDilationgray_dilation

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