weisang.com > Dokumentation > GroupDelay (FPScript)

FlexPro-Dokumentation

GroupDelay (FPScript)

21.09.2021

Berechnet die Gruppenlaufzeit aus den Filterkoeffizienten.

Syntax

GroupDelay(FilterCoefficients, [ Length = 1024 ] [ , SamplingRate = 1 ])

Die Syntax der GroupDelay-Funktion besteht aus folgenden Teilen:

Teil	Beschreibung
FilterCoefficients	Die Filterkoeffizienten, für die die Gruppenlaufzeit berechnet wird. Erlaubte Datenstrukturen sind Datenreihe und Liste. Es sind alle numerischen Datentypen erlaubt außer Kalenderzeit und Zeitspanne.
Length	Gibt die Datenlänge der Gruppenlaufzeit an. Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl und 32-Bit Ganzzahl. Der Wert muss größer 0 sein. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 1024 gesetzt.
SamplingRate	Wenn Sie hier die Abtastrate der Zeitsignale angeben, auf die Sie das Filter anwenden, dann wird die X-Komponente so skaliert, dass diese physikalische Frequenzen darstellt. Wenn Sie das Argument weglassen, wird die Gruppenlaufzeit für normierte Frequenzen im Bereich 0 bis 0,5 berechnet. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt. Der Wert muss größer 0 sein. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 1 gesetzt.

Teil

Beschreibung

FilterCoefficients

Die Filterkoeffizienten, für die die Gruppenlaufzeit berechnet wird.

Erlaubte Datenstrukturen sind Datenreihe und Liste. Es sind alle numerischen Datentypen erlaubt außer Kalenderzeit und Zeitspanne.

Length

Gibt die Datenlänge der Gruppenlaufzeit an.

Erlaubte Datenstrukturen sind Einzelwert. Unterstützte Datentypen sind 16-Bit Ganzzahl und 32-Bit Ganzzahl.

Der Wert muss größer 0 sein.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 1024 gesetzt.

SamplingRate

Wenn Sie hier die Abtastrate der Zeitsignale angeben, auf die Sie das Filter anwenden, dann wird die X-Komponente so skaliert, dass diese physikalische Frequenzen darstellt. Wenn Sie das Argument weglassen, wird die Gruppenlaufzeit für normierte Frequenzen im Bereich 0 bis 0,5 berechnet.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle reellen Datentypen erlaubt.

Der Wert muss größer 0 sein.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert 1 gesetzt.

Anmerkungen

Das Ergebnis ist ein Signal und hat immer den Datentyp reelle oder komplexe 64-Bit Fließkommazahl. Die X-Komponente enthält die Frequenzen von 0 bis zur halben Abtastfrequenz. Die Einheit des Ergebnisses entspricht dem Kehrwert der Einheit der Abtastrate.

Das Argument FilterCoefficients ist entweder eine Liste mit den Zähler- und Nennerkoeffizienten (IIR) oder eine Datenreihe mit den Zählerkoeffizienten (FIR) eines Filters.

Verfügbarkeit

Option Digitale Filter

Beispiele

GroupDelay(IIRFilter(FILTER_BUTTERWORTH, FILTER_LOWPASS, 5, 200 Hz, 0.1, 0.1, FILTER_DELTA, , 1 kHz), , 1 kHz)

Berechnet die Gruppenlaufzeit aus den Koeffizienten eines Butterworth-Tiefpass-Filters 5. Ordnung mit der Eckfrequenz 200 Hz für eine Abtastrate von 1 kHz.