eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxeliminate_min_max (Operator)

Name

eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxeliminate_min_max — Ortsraumglättung zur Entfernung von Rauschspitzen.

Signatur

eliminate_min_max(Image : FilteredImage : MaskWidth, MaskHeight, Gap, Mode : )

Herror eliminate_min_max(const Hobject Image, Hobject* FilteredImage, const Hlong MaskWidth, const Hlong MaskHeight, double Gap, const Hlong Mode)

Herror T_eliminate_min_max(const Hobject Image, Hobject* FilteredImage, const Htuple MaskWidth, const Htuple MaskHeight, const Htuple Gap, const Htuple Mode)

void EliminateMinMax(const HObject& Image, HObject* FilteredImage, const HTuple& MaskWidth, const HTuple& MaskHeight, const HTuple& Gap, const HTuple& Mode)

HImage HImage::EliminateMinMax(Hlong MaskWidth, Hlong MaskHeight, double Gap, Hlong Mode) const

static void HOperatorSet.EliminateMinMax(HObject image, out HObject filteredImage, HTuple maskWidth, HTuple maskHeight, HTuple gap, HTuple mode)

HImage HImage.EliminateMinMax(int maskWidth, int maskHeight, double gap, int mode)

def eliminate_min_max(image: HObject, mask_width: int, mask_height: int, gap: float, mode: int) -> HObject

Beschreibung

eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMaxeliminate_min_max filtert Rauschspitzen aus einem verrauschten Bild. Hierfür wird das Bild punktweise im Ortsraum verarbeitet. Um Kanten und Linien nicht allzu sehr zu glätten, werden nur diejenigen Bildpunkte ersetzt, die ein lokales Minimum bzw. Maximum darstellen. Der Gedanke hierbei ist, dass bei Kanten oder Linien noch mindestens ein weiterer Punkt innerhalb der lokalen Umgebung existiert, der ungefähr denselben Grauwert besitzt wie der betrachtete. Dadurch bleibt die Bedingung eines lokalen Minimums/Maximums unerfüllt, der Punkt wird nicht ersetzt und die Kante/Linie nicht geglättet. Um die Strenge der Ersetzungsbedingung beeinflussen zu können, kann mit GapGapGapGapgapgap angegeben werden, um wie viel kleiner bzw. größer das lokale Minimum/Maximum gegenüber den anderen Grauwerten mindestens sein muss. eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMaxeliminate_min_max arbeitet also nach folgendem Schema: Enthalte U(x,y) alle Grauwerte der NxM großen, rechteckigen lokalen Umgebung des Punktes (x,y), außer dem Grauwert des Punktes (x,y) selbst;

Mit welchem neuen Wert ein zu ersetzender Punkt belegt wird, ist durch ModeModeModeModemodemode zu steuern: ModeModeModeModemodemode = 1 --> Ersetzung eines lokalen Maximums durch das nächstkleinere lokale Maximum und Ersetzung eines lokalen Minimums durch das nächstgrößere lokale Minimum ModeModeModeModemodemode = 2 --> Ersetzung durch das (ungewichtete) arithmetische Mittel aller Punkte innerhalb der lokalen Umgebung (inkl. des betrachteten Punktes) ModeModeModeModemodemode = 3 --> Ersetzung durch den Median-Wert aller Punkte innerhalb der lokalen Umgebung (inkl. des betrachteten Punktes) (auch bei allen anderen Werten von Mode außer 1,2) Die Breite und Höhe der (rechteckigen) lokalen Punktumgebung wird durch MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width und MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height festgelegt. Bemerkung zur Randbehandlung: Punkte jenseits des Bildrands werden nicht in die Betrachtung einbezogen. Sei z.B. eine 3x3-Maske gegeben, so reduziert sich die lokale Umgebung des Punktes (0,0) auf die Werte von (1,0),(0,1) und (1,1).

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

Achtung

Der Filter ist nur für Bilder vom Typ 'byte' implementiert. Werden für MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width und MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height gerade statt ungerader Werte übergeben, verwendet die Routine an ihrer Stelle die nächstgrößeren ungeraden Werte (damit ist der Schwerpunkt der Filtermaske immer eindeutig bestimmt). Die Filtermaskenbreite bzw. -höhe darf die Bildbreite bzw. -höhe nicht überschreiten.

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 / uint2)

Bild, das gefiltert werden soll.

FilteredImageFilteredImageFilteredImageFilteredImagefilteredImagefiltered_image (output_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject * (byte / uint2)

Geglättetes Bild.

MaskWidthMaskWidthMaskWidthMaskWidthmaskWidthmask_width (input_control)  extent.x HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Breite der rechteckigen Filtermaske.

Defaultwert: 3

Wertevorschläge: 3, 5, 7, 9

Typischer Wertebereich: 3 ≤ MaskWidth MaskWidth MaskWidth MaskWidth maskWidth mask_width ≤ width(Image)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskWidth)

MaskHeightMaskHeightMaskHeightMaskHeightmaskHeightmask_height (input_control)  extent.y HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Höhe der rechteckigen Filtermaske.

Defaultwert: 3

Wertevorschläge: 3, 5, 7, 9

Typischer Wertebereich: 3 ≤ MaskHeight MaskHeight MaskHeight MaskHeight maskHeight mask_height ≤ width(Image)

Minimale Schrittweite: 2

Empfohlene Schrittweite: 2

Restriktion: odd(MaskWidth)

GapGapGapGapgapgap (input_control)  number HTuplefloatHTupleHtuple (real) (double) (double) (double)

Mindestabstand vom lokalen Minimum/Maximum zu allen anderen Grauwerten der lokalen Punktumgebung.

Defaultwert: 1.0

Wertevorschläge: 1.0, 2.0, 5.0, 10.0

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

Ersetzungsvorschrift für zu ersetzende Grauwerte (1=nächstes Minimum/Maximum, 2=Average, sonst Median).

Defaultwert: 3

Werteliste: 1, 2, 3

Ergebnis

Sind die Parameterwerte korrekt, dann liefert eliminate_min_maxeliminate_min_maxEliminateMinMaxEliminateMinMaxEliminateMinMaxeliminate_min_max den Wert TRUE. Bei einer leeren Eingabe wird mit einer entsprechenden Fehlermeldung abgebrochen.

Nachfolger

wiener_filterwiener_filterWienerFilterWienerFilterWienerFilterwiener_filter, wiener_filter_niwiener_filter_niWienerFilterNiWienerFilterNiWienerFilterNiwiener_filter_ni

Siehe auch

mean_spmean_spMeanSpMeanSpMeanSpmean_sp, mean_imagemean_imageMeanImageMeanImageMeanImagemean_image, median_imagemedian_imageMedianImageMedianImageMedianImagemedian_image, median_weightedmedian_weightedMedianWeightedMedianWeightedMedianWeightedmedian_weighted, binomial_filterbinomial_filterBinomialFilterBinomialFilterBinomialFilterbinomial_filter, gauss_filtergauss_filterGaussFilterGaussFilterGaussFiltergauss_filter, smooth_imagesmooth_imageSmoothImageSmoothImageSmoothImagesmooth_image

Literatur

M. Imme:„A Noise Peak Elimination Filter“; S. 204-211 in CVGIP Graphical Models and Image Processing, Vol. 53, No. 2, March 1991
M. Lückenhaus:„Grundlagen des Wiener-Filters und seine Anwendung in der Bildanalyse“; Diplomarbeit; Technische Universität München, Institut für Informatik; Lehrstuhl Prof. Radig; 1995.

Modul

Foundation