rank_nrank_nRankNRankN (Operator)

Name

rank_nrank_nRankNRankN — Rückgabe der Grauwerte mit angegebenem Rang aus mehreren Kanälen.

Signatur

rank_n(Image : RankImage : RankIndex : )

Herror rank_n(const Hobject Image, Hobject* RankImage, const Hlong RankIndex)

Herror T_rank_n(const Hobject Image, Hobject* RankImage, const Htuple RankIndex)

void RankN(const HObject& Image, HObject* RankImage, const HTuple& RankIndex)

HImage HImage::RankN(Hlong RankIndex) const

static void HOperatorSet.RankN(HObject image, out HObject rankImage, HTuple rankIndex)

HImage HImage.RankN(int rankIndex)

Beschreibung

rank_nrank_nRankNRankNRankN gibt pixelweise das Ergebnis der Rang-Funktion über alle Kanäle des Eingabebildes ImageImageImageImageimage zurück.

Für jedes Pixel des Eingabebildes gilt: Die Grauwerte aller Kanäle an dieser Position werden aufsteigend sortiert. Dann wird das Pixel mit Index RankIndexRankIndexRankIndexRankIndexrankIndex ausgewählt und im Ausgabebild an die gleiche Position geschrieben. Das Ausgabebild hat einen Kanal.

Die SpezialfälleRankIndexRankIndexRankIndexRankIndexrankIndex = 1 und RankIndexRankIndexRankIndexRankIndexrankIndex = '(Anzahl Eingabekanäle)'"(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)" liefern jeweils das Minimum bzw. Maximum. RankIndexRankIndexRankIndexRankIndexrankIndex = '(Anzahl Eingabekanäle + 1) / 2'"(Anzahl Eingabekanäle + 1) / 2""(Anzahl Eingabekanäle + 1) / 2""(Anzahl Eingabekanäle + 1) / 2""(Anzahl Eingabekanäle + 1) / 2" liefert den Median (hierbei bezeichnet / die ganzzahlige Division). Für ein fünfkanaliges Bild liefert also 3 den Median.

Der Operator rank_nrank_nRankNRankNRankN ist nicht mit dem Operator rank_imagerank_imageRankImageRankImageRankImage zu verwechseln der die Rang-Funktion innerhalb einer bestimmten Maske durchführt.

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

Achtung

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 / int8 / real)

Mehrkanaliges Graubild.

RankImageRankImageRankImageRankImagerankImage (output_object)  singlechannelimage(-array) objectHImageHImageHobject * (byte / int2 / uint2 / int4 / int8 / real)

Ergebnis der Rang-Funktion.

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

Rang der zurückzugebenden Grauwertbilder.

Defaultwert: 2

Wertevorschläge: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20

Beispiel (HDevelop)

compose5 (Image1, Image2, Image3, Image4, Image5, MultiChannelImage)
rank_n (MultiChannelImage, ImageMin, 1)
rank_n (MultiChannelImage, ImageMax, 5)
rank_n (MultiChannelImage, ImageMedian, 3)

Vorgänger

compose2compose2Compose2Compose2Compose2, compose3compose3Compose3Compose3Compose3, compose4compose4Compose4Compose4Compose4, compose5compose5Compose5Compose5Compose5, add_channelsadd_channelsAddChannelsAddChannelsAddChannels

Alternativen

mean_nmean_nMeanNMeanNMeanN

Siehe auch

count_channelscount_channelsCountChannelsCountChannelsCountChannels, rank_imagerank_imageRankImageRankImageRankImage

Modul

Foundation