rft_genericrft_genericRftGenericRftGenericrft_generic (Operator)

Name

rft_genericrft_genericRftGenericRftGenericrft_generic — Schnelle reelle Fouriertransformation.

Signatur

Beschreibung

rft_genericrft_genericRftGenericRftGenericRftGenericrft_generic berechnet die schnelle Fouriertransformation des Eingabebildes ImageImageImageImageimageimage. Dabei wird im Gegensatz zu fft_genericfft_genericFftGenericFftGenericFftGenericfft_generic, fft_imagefft_imageFftImageFftImageFftImagefft_image und fft_image_invfft_image_invFftImageInvFftImageInvFftImageInvfft_image_inv ausgenutzt, dass das Eingabebild der Hintransformation ein reellwertiges Bild (d.h. kein komplexes Bild) ist. In diesem Fall besitzt das komplexe Ausgabebild eine Redundanz. Die Werte in der rechten Hälfte des komplexen Bildes sind die komplexen Konjugierten der Werte an der entsprechenden Position in der linken Hälfte des Bildes. Entsprechend kann Laufzeit und Speicher eingespart werden, indem nur die linke Hälfte des komplexen Bildes berechnet und ausgegeben wird.

Der Parameter ResultTypeResultTypeResultTypeResultTyperesultTyperesult_type erlaubt es, bei der Rücktransformation (DirectionDirectionDirectionDirectiondirectiondirection = 'from_freq'"from_freq""from_freq""from_freq""from_freq""from_freq") den Ergebnisbildtyp festzulegen. Bei der Hintransformation (DirectionDirectionDirectionDirectiondirectiondirection = 'to_freq'"to_freq""to_freq""to_freq""to_freq""to_freq") muss ResultTypeResultTypeResultTypeResultTyperesultTyperesult_type auf 'complex'"complex""complex""complex""complex""complex" gesetzt werden.

Der Parameter DirectionDirectionDirectionDirectiondirectiondirection legt fest, ob in den Frequenzraum oder aus dem Frequenzraum zurück transformiert werden soll. Für DirectionDirectionDirectionDirectiondirectiondirection = 'to_freq'"to_freq""to_freq""to_freq""to_freq""to_freq" muss das Eingabebild ein reellwertiger Typ sein, d.h. es darf kein komplexes Bild als Eingabe verwendet werden. Es werden alle Bildtypen unterstützt, die sich in ein reelles Bild transformieren lassen. In diesem Fall ist die Ausgabe ein komplexes Bild der Dimension (w/2+1)*h, wobei w und h die Breite und Höhe des Eingabebildes sind. In diesem Modus wird als Exponent der Transformation -1 verwendet (siehe fft_genericfft_genericFftGenericFftGenericFftGenericfft_generic). Für DirectionDirectionDirectionDirectiondirectiondirection = 'from_freq'"from_freq""from_freq""from_freq""from_freq""from_freq" muss das Eingabebild ein komplexes Bild sein. In diesem Fall kann nicht aus der Größe des Eingabebildes entschieden werden, welche Größe das Ausgabebild besitzen soll. Hierzu muss WidthWidthWidthWidthwidthwidth korrekt gesetzt werden, d.h. auf 2*w-2 oder auf 2*w-1, wobei w die Breite des komplexen Eingabebildes ist. In diesem Modus wird als Exponent der Transformation 1 verwendet.

Mit NormNormNormNormnormnorm kann die gewünschte Normierung angegeben werden. Zulässige Werte sind 'none'"none""none""none""none""none", 'sqrt'"sqrt""sqrt""sqrt""sqrt""sqrt" und 'n'"n""n""n""n""n". In jedem Fall ist auf die konsistente Verwendung der Parameter zu achten. D.h., die Normierungsfaktoren bei der Hin- und Rücktransformation müssen aufmultipliziert w*h ergeben.

Achtung

Die Berechnung erfolgt immer für das gesamte Bild, d.h., der Definitionsbereich des Eingabebildes wird ignoriert.

Ausführungsinformationen

• 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 interner Datenebene.

Parameter

Ergebnis

Sind alle Parameterwerte korrekt, dann liefert rft_genericrft_genericRftGenericRftGenericRftGenericrft_generic 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>)set_system("no_object_result",<Result>) festlegen. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

optimize_rft_speedoptimize_rft_speedOptimizeRftSpeedOptimizeRftSpeedOptimizeRftSpeedoptimize_rft_speed, read_fft_optimization_dataread_fft_optimization_dataReadFftOptimizationDataReadFftOptimizationDataReadFftOptimizationDataread_fft_optimization_data

Nachfolger

convol_fftconvol_fftConvolFftConvolFftConvolFftconvol_fft, correlation_fftcorrelation_fftCorrelationFftCorrelationFftCorrelationFftcorrelation_fft, phase_correlation_fftphase_correlation_fftPhaseCorrelationFftPhaseCorrelationFftPhaseCorrelationFftphase_correlation_fft, convert_image_typeconvert_image_typeConvertImageTypeConvertImageTypeConvertImageTypeconvert_image_type, power_bytepower_bytePowerBytePowerBytePowerBytepower_byte, power_realpower_realPowerRealPowerRealPowerRealpower_real, power_lnpower_lnPowerLnPowerLnPowerLnpower_ln, phase_degphase_degPhaseDegPhaseDegPhaseDegphase_deg, phase_radphase_radPhaseRadPhaseRadPhaseRadphase_rad

Alternativen

fft_genericfft_genericFftGenericFftGenericFftGenericfft_generic, fft_imagefft_imageFftImageFftImageFftImagefft_image, fft_image_invfft_image_invFftImageInvFftImageInvFftImageInvfft_image_inv

Modul

Foundation