rank_nrank_nRankNRankNrank_n (Operator)

Name

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

def rank_n(image: HObject, rank_index: int) -> HObject

Beschreibung

rank_nrank_nRankNRankNRankNrank_n gibt pixelweise das Ergebnis der Rang-Funktion über alle Kanäle des Eingabebildes ImageImageImageImageimageimage 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 RankIndexRankIndexRankIndexRankIndexrankIndexrank_index ausgewählt und im Ausgabebild an die gleiche Position geschrieben. Das Ausgabebild hat einen Kanal.

Die Spezialfälle RankIndexRankIndexRankIndexRankIndexrankIndexrank_index = 1 und RankIndexRankIndexRankIndexRankIndexrankIndexrank_index = '(Anzahl Eingabekanäle)'"(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)" liefern jeweils das Minimum bzw. Maximum. RankIndexRankIndexRankIndexRankIndexrankIndexrank_index = '(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""(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_nRankNRankNRankNrank_n ist nicht mit dem Operator rank_imagerank_imageRankImageRankImageRankImagerank_image 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

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

Mehrkanaliges Graubild.

RankImageRankImageRankImageRankImagerankImagerank_image (output_object)  singlechannelimage(-array) objectHImageHObjectHImageHobject * (byte / int2 / uint2 / int4 / int8 / real)

Ergebnis der Rang-Funktion.

RankIndexRankIndexRankIndexRankIndexrankIndexrank_index (input_control)  integer HTupleintHTupleHtuple (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

compose2compose2Compose2Compose2Compose2compose2, compose3compose3Compose3Compose3Compose3compose3, compose4compose4Compose4Compose4Compose4compose4, compose5compose5Compose5Compose5Compose5compose5, add_channelsadd_channelsAddChannelsAddChannelsAddChannelsadd_channels

Alternativen

mean_nmean_nMeanNMeanNMeanNmean_n

Siehe auch

count_channelscount_channelsCountChannelsCountChannelsCountChannelscount_channels, rank_imagerank_imageRankImageRankImageRankImagerank_image

Modul

Foundation