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_nRankNRankNrank_n 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 RankIndexRankIndexRankIndexrankIndexrank_index ausgewählt und im Ausgabebild an die gleiche Position geschrieben. Das Ausgabebild hat einen Kanal.

Die Spezialfälle RankIndexRankIndexRankIndexrankIndexrank_index = 1 und RankIndexRankIndexRankIndexrankIndexrank_index = '(Anzahl Eingabekanäle)'"(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)" liefern jeweils das Minimum bzw. Maximum. RankIndexRankIndexRankIndexrankIndexrank_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" liefert den Median (hierbei bezeichnet / die ganzzahlige Division). Für ein fünfkanaliges Bild liefert also 3 den Median.

Der Operator rank_nrank_nRankNRankNrank_n ist nicht mit dem Operator rank_imagerank_imageRankImageRankImagerank_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

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

Mehrkanaliges Graubild.

RankImageRankImageRankImagerankImagerank_image (output_object)  singlechannelimage(-array) objectHImageHObjectHObjectHobject * (byte / int2 / uint2 / int4 / int8 / real)

Ergebnis der Rang-Funktion.

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

Rang der zurückzugebenden Grauwertbilder.

Default: 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_channelsAddChannelsAddChannelsadd_channels

Alternativen

mean_nmean_nMeanNMeanNmean_n

Siehe auch

count_channelscount_channelsCountChannelsCountChannelscount_channels, rank_imagerank_imageRankImageRankImagerank_image

Modul

Foundation