gen_gauss_filtergen_gauss_filterGenGaussFilterGenGaussFilter (Operator)

Name

gen_gauss_filtergen_gauss_filterGenGaussFilterGenGaussFilter — Erzeugen eines Gaußfilters im Frequenzraum.

Signatur

gen_gauss_filter( : ImageGauss : Sigma1, Sigma2, Phi, Norm, Mode, Width, Height : )

Beschreibung

gen_gauss_filtergen_gauss_filterGenGaussFilterGenGaussFilterGenGaussFilter erzeugt einen (evtl. anisotropen) Gaußfilter im Frequenzraum. Die Standardabweichungen (d.h. die Stärke der Glättung) des Gaußfilters im Ortsraum werden durch Sigma1Sigma1Sigma1Sigma1sigma1 und Sigma2Sigma2Sigma2Sigma2sigma2 festgelegt. Dabei ist Sigma1Sigma1Sigma1Sigma1sigma1 die Standardabweichung in Richtung der durch den Winkel PhiPhiPhiPhiphi gegebenen Hauptrichtung des Filters im Ortsraum. Um eine maximale Effizienz der gesamten Filterung zu erreichen, kann mit NormNormNormNormnorm der Normierungsfaktor des Filters festgelegt werden. Somit kann eine Normierung in der FFT unterbleiben, falls fft_genericfft_genericFftGenericFftGenericFftGeneric verwendet wird, falls NormNormNormNormnorm = 'n'"n""n""n""n" verwendet wird. Mit ModeModeModeModemode kann festgelegt werden, wo der Nullfrequenz der FFT liegen soll bzw. ob der Filter für die reelle FFT erzeugt werden soll. Falls fft_genericfft_genericFftGenericFftGenericFftGeneric verwendet wird, kann zur Effizienzsteigerung 'dc_edge'"dc_edge""dc_edge""dc_edge""dc_edge" verwendet werden. Falls fft_imagefft_imageFftImageFftImageFftImage und fft_image_invfft_image_invFftImageInvFftImageInvFftImageInv zur Filterung verwendet werden, muss NormNormNormNormnorm = 'none'"none""none""none""none" und ModeModeModeModemode = 'dc_center'"dc_center""dc_center""dc_center""dc_center" verwendet werden. Falls rft_genericrft_genericRftGenericRftGenericRftGeneric verwendet wird, muss ModeModeModeModemode = 'rft'"rft""rft""rft""rft" verwendet werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

ImageGaussImageGaussImageGaussImageGaussimageGauss (output_object) image → object (real)

Gaußfilter als Bild in Frequenzraum.

Sigma1Sigma1Sigma1Sigma1sigma1 (input_control) real → (real)

Standardabweichung des Gaußfilters in der Hauptrichtung des Filters im Ortsraum.

Defaultwert: 1.0

Wertevorschläge: 0.7, 0.8, 0.9, 1.0, 1.1, 1.2, 1.5, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0

Restriktion: Sigma1 >= 0

Sigma2Sigma2Sigma2Sigma2sigma2 (input_control) real → (real)

Standardabweichung des Gaußfilters senkrecht zur Hauptrichtung des Filters im Ortsraum.

Defaultwert: 1.0

Wertevorschläge: 0.7, 0.8, 0.9, 1.0, 1.1, 1.2, 1.5, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0, 9.0, 10.0

Restriktion: Sigma2 >= 0

PhiPhiPhiPhiphi (input_control) angle.rad → (real)

Hauptrichtung des Filters im Ortsraum.

Defaultwert: 0.0

Wertevorschläge: 0.0, 0.523599, 0.785398, 1.047198, 1.570796, 2.094395, 2.356194, 2.617994, 3.141593

NormNormNormNormnorm (input_control) string → (string)

Normierung des Filters.

Defaultwert: 'none' "none" "none" "none" "none"

Werteliste: 'n'"n""n""n""n", 'none'"none""none""none""none"

ModeModeModeModemode (input_control) string → (string)

Position der Nullfrequenz im Frequenzraum.

Defaultwert: 'dc_center' "dc_center" "dc_center" "dc_center" "dc_center"

Werteliste: 'dc_center'"dc_center""dc_center""dc_center""dc_center", 'dc_edge'"dc_edge""dc_edge""dc_edge""dc_edge", 'rft'"rft""rft""rft""rft"

WidthWidthWidthWidthwidth (input_control) integer → (integer)

Breite des Bildes (Filters).

Defaultwert: 512

Wertevorschläge: 128, 160, 192, 256, 320, 384, 512, 640, 768, 1024, 2048, 4096, 8192

HeightHeightHeightHeightheight (input_control) integer → (integer)

Höhe des Bildes (Filters).

Defaultwert: 512

Wertevorschläge: 120, 128, 144, 240, 256, 288, 480, 512, 576, 1024, 2048, 4096, 8192

Beispiel (HDevelop)

* Generate a smoothed derivative filter.
gen_gauss_filter (ImageGauss, Sigma, Sigma, 0, 'n', 'dc_edge', 512, 512)
convert_image_type (ImageGauss, ImageGaussComplex, 'complex')
gen_derivative_filter (ImageDerivX, 'x', 1, 'none', 'dc_edge', 512, 512)
mult_image (ImageGaussComplex, ImageDerivX, ImageDerivXGauss, 1, 0)
* Filter an image with the smoothed derivative filter.
fft_generic (Image, ImageFFT, 'to_freq', -1, 'none', 'dc_edge', 'complex')
convol_fft (ImageFFT, ImageDerivXGauss, Filtered)
fft_generic (Filtered, ImageX, 'from_freq', 1, 'none', 'dc_edge', 'real')

Ergebnis

Sind die Parameterwerte korrekt, dann liefert gen_gauss_filtergen_gauss_filterGenGaussFilterGenGaussFilterGenGaussFilter den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

fft_imagefft_imageFftImageFftImageFftImage, fft_genericfft_genericFftGenericFftGenericFftGeneric, rft_genericrft_genericRftGenericRftGenericRftGeneric

Nachfolger

convol_fftconvol_fftConvolFftConvolFftConvolFft

Siehe auch

fft_image_invfft_image_invFftImageInvFftImageInvFftImageInv, gen_mean_filtergen_mean_filterGenMeanFilterGenMeanFilterGenMeanFilter, gen_derivative_filtergen_derivative_filterGenDerivativeFilterGenDerivativeFilterGenDerivativeFilter, gen_lowpassgen_lowpassGenLowpassGenLowpassGenLowpass, gen_bandpassgen_bandpassGenBandpassGenBandpassGenBandpass, gen_bandfiltergen_bandfilterGenBandfilterGenBandfilterGenBandfilter, gen_highpassgen_highpassGenHighpassGenHighpassGenHighpass

Modul

Foundation

Operatoren