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_imageRankImageRankImagerank_image führt eine Rangfilterung des Eingabebildes ImageImageImageimageimage mit einer Maske, die durch die Region MaskMaskMaskmaskmask beschrieben wird, durch und liefert das gefilterte Bild in ImageRankImageRankImageRankimageRankimage_rank zurück. Die Form der Maske kann beliebig gewählt werden und z.B. mit Operatoren wie gen_circlegen_circleGenCircleGenCirclegen_circle oder draw_regiondraw_regionDrawRegionDrawRegiondraw_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 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_centerAreaCenterAreaCenterarea_center). Für RankRankRankrankrank = (A - 1) / 2 + 1 liefert rank_imagerank_imageRankImageRankImagerank_image den Median zurück (siehe median_imagemedian_imageMedianImageMedianImagemedian_image). Für RankRankRankrankrank = 1 entspricht rank_imagerank_imageRankImageRankImagerank_image einer Grauwerterosion (siehe gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape und gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion), für RankRankRankrankrank = A entspricht rank_rectrank_rectRankRectRankRectrank_rect einer Grauwertdilatation (siehe gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapegray_dilation_shape und gray_dilationgray_dilationGrayDilationGrayDilationgray_dilation).

rank_imagerank_imageRankImageRankImagerank_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_imageRankImageRankImagerank_image unempfindlicher gegenüber Rauschen als die entsprechenden Operatoren der Grauwertmorphologie. 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'"continued""continued""continued""continued"

Fortsetzung der Randpunkte.

'cyclic'"cyclic""cyclic""cyclic""cyclic"

Zyklische Fortsetzung der Bildränder.

'mirrored'"mirrored""mirrored""mirrored""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_imageRankImageRankImagerank_image verwendet einen Algorithmus mit einer Laufzeit pro Pixel, die von der Anzahl der Sehnen der Maske MaskMaskMaskmaskmask abhängt. Daher ist rank_imagerank_imageRankImageRankImagerank_image für rechteckige Masken mit einer großen Maskenhöhe langsamer als rank_rectrank_rectRankRectRankRectrank_rect. Die genaue Maskenhöhe, ab der rank_rectrank_rectRankRectRankRectrank_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_rectRankRectRankRectrank_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_imageRankImageRankImagerank_image auch für größere Maskenhöhen schneller als rank_rectrank_rectRankRectRankRectrank_rect ist.

rank_imagerank_imageRankImageRankImagerank_image 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_rectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape oder gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion bzw. gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapegray_dilation_shape oder gray_dilationgray_dilationGrayDilationGrayDilationgray_dilation typischerweise schneller als rank_imagerank_imageRankImageRankImagerank_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

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) objectHImageHObjectHObjectHobject (byte / int2 / uint2 / int4 / real)

Zu filterndes Bild.

MaskMaskMaskmaskmask (input_object)  region objectHRegionHObjectHObjectHobject

Filtermaske.

ImageRankImageRankImageRankimageRankimage_rank (output_object)  multichannel-image(-array) objectHImageHObjectHObjectHobject * (byte / int2 / uint2 / int4 / real)

Gefiltertes Bild.

RankRankRankrankrank (input_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Rang des Ausgabegrauwerts.

Default: 5

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

Wertebereich: 1 ≤ Rank Rank Rank rank rank ≤ 4095

Minimale Schrittweite: 1

Empfohlene Schrittweite: 2

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

Randbehandlung.

Default: '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_featuresRunlengthFeaturesRunlengthFeaturesrunlength_features).

Ergebnis

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

Vorgänger

read_imageread_imageReadImageReadImageread_image, draw_regiondraw_regionDrawRegionDrawRegiondraw_region, gen_circlegen_circleGenCircleGenCirclegen_circle, gen_rectangle1gen_rectangle1GenRectangle1GenRectangle1gen_rectangle1, gen_rectangle2gen_rectangle2GenRectangle2GenRectangle2gen_rectangle2

Nachfolger

thresholdthresholdThresholdThresholdthreshold, dyn_thresholddyn_thresholdDynThresholdDynThresholddyn_threshold, regiongrowingregiongrowingRegiongrowingRegiongrowingregiongrowing

Alternativen

rank_rectrank_rectRankRectRankRectrank_rect, median_imagemedian_imageMedianImageMedianImagemedian_image, median_rectmedian_rectMedianRectMedianRectmedian_rect

Siehe auch

gray_erosion_rectgray_erosion_rectGrayErosionRectGrayErosionRectgray_erosion_rect, gray_dilation_rectgray_dilation_rectGrayDilationRectGrayDilationRectgray_dilation_rect, gray_erosion_shapegray_erosion_shapeGrayErosionShapeGrayErosionShapegray_erosion_shape, gray_dilation_shapegray_dilation_shapeGrayDilationShapeGrayDilationShapegray_dilation_shape, gray_erosiongray_erosionGrayErosionGrayErosiongray_erosion, gray_dilationgray_dilationGrayDilationGrayDilationgray_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