deviation_imagedeviation_imageDeviationImageDeviationImage (Operator)

Name

deviation_imagedeviation_imageDeviationImageDeviationImage — Standardabweichnung der Grauwerte in Rechteckfenstern.

Signatur

deviation_image(Image : ImageDeviation : Width, Height : )

Beschreibung

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage transformiert die Grauwerte der Eingabebilder aus ImageImageImageImageimage mit Hilfe einer Filtermaske (HeightHeightHeightHeightheight, WidthWidthWidthWidthwidth), in der die Standardabweichung der Grauwerte berechnet wird. Um den Grauwertwerteberich des Ergebnisbildes besser auszunutzen, wird das Ergebnis mit 2 multipliziert. Das Ergebnis wird in ImageDeviationImageDeviationImageDeviationImageDeviationimageDeviation übergeben. Die Steuerparameter HeightHeightHeightHeightheight, WidthWidthWidthWidthwidth werden, falls sie jeweils einen geraden Wert haben, zu dem nächstgrößeren ungeraden Wert gewandelt. An den Bildrändern wird eine Spiegelung der Randpunkte durchgeführt.

Achtung

deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage kann auf OpenCL Geräten ausgeführt werden. Da der gleiche OpenCL Code verwendet wird, gelten die selben Einschränkungen wie für mean_imagemean_imageMeanImageMeanImageMeanImage. Das Ergebnis kann geringfühgig von dem der CPU abweichen, da intern mit einfach genauer Fließkommaarithmetik gerechnet wird.

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

Unterstützt OpenCL Compute Devices.
Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf Tupelebene.
Automatisch parallelisiert auf Kanalebene.
Automatisch parallelisiert auf Domainebene.

Parameter

ImageImageImageImageimage (input_object) (multichannel-)image(-array) → object (byte* / int4* / real* / int2* / uint2*) *erlaubt für Compute Devices

Bilder, für deren Grauwerte die Standardabweichung berechnet werden sollen.

ImageDeviationImageDeviationImageDeviationImageDeviationimageDeviation (output_object) image(-array) → object (byte / int4 / real / int2 / uint2)

Bilder, die die Standardabweichung enthalten.

WidthWidthWidthWidthwidth (input_control) extent.x → (integer)

Breite der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriktion: 3 <= Width && odd(Width)

HeightHeightHeightHeightheight (input_control) extent.y → (integer)

Höhe der Filtermaske.

Defaultwert: 11

Wertevorschläge: 3, 5, 7, 9, 11, 13, 15, 17, 19, 21, 23, 25

Restriktion: 3 <= Height && odd(Height)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (C)

read_image(&Image,"fabrik");
disp_image(Image,WindowHandle);
deviation_image(Image,&Deviation,9,9);
disp_image(Deviation,WindowHandle);

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Beispiel (HDevelop)

read_image(Image,'fabrik')
dev_display(Image)
deviation_image(Image,Deviation,9,9)
dev_display(Image)

Ergebnis

Sind die Parameterwerte korrekt, dann liefert deviation_imagedeviation_imageDeviationImageDeviationImageDeviationImage den Wert 2 (H_MSG_TRUE). Das Verhalten bei leerer Eingabe (keine Eingabebilder vorhanden) lässt sich mittels set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Nachfolger

disp_imagedisp_imageDispImageDispImageDispImage

Alternativen

entropy_imageentropy_imageEntropyImageEntropyImageEntropyImage, entropy_grayentropy_grayEntropyGrayEntropyGrayEntropyGray

Siehe auch

convol_imageconvol_imageConvolImageConvolImageConvolImage, texture_lawstexture_lawsTextureLawsTextureLawsTextureLaws, intensityintensityIntensityIntensityIntensity

Modul

Foundation

Operatoren