KlassenKlassenKlassenKlassen | | | | Operatoren

rank_nrank_nRankNrank_nRankNRankN (Operator)

Name

rank_nrank_nRankNrank_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)

Herror rank_n(Hobject Image, Hobject* RankImage, const HTuple& RankIndex)

HImage HImage::RankN(const HTuple& RankIndex) const

HImageArray HImageArray::RankN(const HTuple& RankIndex) const

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

HImage HImage::RankN(Hlong RankIndex) const

void HOperatorSetX.RankN(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*RankImage, [in] VARIANT RankIndex)

IHImageX* HImageX.RankN([in] Hlong RankIndex)

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

HImage HImage.RankN(int rankIndex)

Beschreibung

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

Die SpezialfälleRankIndexRankIndexRankIndexRankIndexRankIndexrankIndex = 1 und RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex = '(Anzahl Eingabekanäle)'"(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)""(Anzahl Eingabekanäle)" liefern jeweils das Minimum bzw. Maximum. RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex = '(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_nRankNrank_nRankNRankN ist nicht mit dem Operator rank_imagerank_imageRankImagerank_imageRankImageRankImage zu verwechseln der die Rang-Funktion innerhalb einer bestimmten Maske durchführt.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte / int2 / uint2 / int4 / int8 / real)

Mehrkanaliges Graubild.

RankImageRankImageRankImageRankImageRankImagerankImage (output_object)  singlechannelimage(-array) objectHImageHImageHImageHImageXHobject * (byte / int2 / uint2 / int4 / int8 / real)

Ergebnis der Rang-Funktion.

RankIndexRankIndexRankIndexRankIndexRankIndexrankIndex (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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_channelsAddChannelsadd_channelsAddChannelsAddChannels

Alternativen

mean_nmean_nMeanNmean_nMeanNMeanN

Siehe auch

count_channelscount_channelsCountChannelscount_channelsCountChannelsCountChannels, rank_imagerank_imageRankImagerank_imageRankImageRankImage

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren