Calcule la fonction de transfert entre un ensemble de données d'entrée et un ensemble de données de sortie.
Syntaxe
TransferFunction(InputSignal, le OutputSignal, le [ SpectrumType Variable TRANSFERFUNCTION_COMPLEX ], le [ Window Variable WIN_HANNING ], le [ Adjustment ], le [ SegmentLength Variable 0 ], le [ OverlapOrGap Variable 50 ], le [ FFTLength Variable 0 ] [ , le Peaks ])
La syntaxe de la fonction TransferFunction se compose des éléments suivants :
Section |
Description |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
InputSignal |
L'ensemble de données d'entrée à analyser. Les structures de données autorisées sont Série de données, le Matrice de données, le Signal et Série de signaux. Tous les types de données réels sont autorisés, sauf Temps calendaire et Période de temps. Les valeurs invalides ne sont pas autorisées dans cet argument. Des restrictions supplémentaires s'appliquent à la composante X.Les valeurs doivent avoir un espacement positif constant. Les valeurs invalides ne sont pas autorisées dans cet argument. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OutputSignal |
L'ensemble de données de sortie à analyser. Les structures de données autorisées sont Série de données, le Matrice de données, le Signal et Série de signaux. Tous les types de données réels sont autorisés, sauf Temps calendaire et Période de temps. Les valeurs invalides ne sont pas autorisées dans cet argument. Des restrictions supplémentaires s'appliquent à la composante X.Les valeurs doivent avoir un espacement positif constant. Les valeurs invalides ne sont pas autorisées dans cet argument. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SpectrumType |
Le format de la fonction de transfert à calculer. L'argument SpectrumType peut avoir les valeurs suivantes :
Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut TRANSFERFUNCTION_COMPLEX . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Window |
La fenêtre de données fixe ou ajustable à appliquer aux données. L'argument Window peut avoir les valeurs suivantes :
Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut WIN_HANNING . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Adjustment |
La largeur de Fourier unilatérale comme un multiple de l'intervalle de fréquence. La plage de validité est spécifique à la fenêtre. La valeur par défaut est de 1,5 pour une fenêtre d'observation cosinus et de 3,0 pour toutes les autres fenêtres de données ajustables. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SegmentLength |
La longueur des segments de données individuels. La plage valable est comprise entre 2 et la longueur des données. La valeur par défaut de 0 fixe la longueur du segment à la longueur des données. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 0 . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OverlapOrGap |
Si cet argument est un nombre positif, il détermine le pourcentage de chevauchement des différents segments de données. S'il est indiqué sous la forme d'un nombre négatif, son montant détermine l'écart entre les différents segments de données en points d'échantillonnage. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. La valeur doit être inférieure ou égale à 95. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 50 . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FFTLength |
La longueur de la transformée de Fourier. Si la longueur FFT spécifiée est supérieure à la longueur du segment, des zéros sont ajoutés. La plage valable se situe entre la longueur du segment et la longueur maximale de la FFT. La valeur par défaut est 0, ce qui définit la longueur de la FFT égale à la longueur du segment. Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés. La valeur doit être supérieure ou égale à 0 et inférieure ou égale à 268435456. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut 0 . |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Peaks |
Si spécifié, seuls les pics du spectre interpolés par la bande sont renvoyés. Les pics peuvent être spécifiés sous forme de nombre ou déterminés à l'aide d'un seuil en dB. Spécifiez un nombre comme un nombre positif de 1 à 100 sans unité. Vous pouvez spécifier un seuil en dB comme une quantité avec l'unité dB entre 0,01 dB et 300 dB, ou comme un nombre négatif entre -0,01 et -300 sans unité. Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés. Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. |
Remarques
Le résultat a la structure de données signal ou série de signaux. Si l'argument InputSignal est une série de données ou une matrice de données, alors la composante X du résultat contient des fréquences normalisées de Nyquist. Si les deux ensembles de données ont des composantes X, alors celles-ci doivent être identiques. Le nombre de valeurs de chaque ensemble de données et, pour les matrices de données et les séries de signaux, également le nombre de colonnes, doivent être identiques. Par exemple, vous pouvez combiner une série de signaux avec un signal. Dans ce cas, le spectre du signal est calculé avec les spectres des différentes colonnes de la série de signaux.
Disponible dans
Option Analyse spectrale
Exemples
Dim s = Signal(Chirp((1000, 0, 0.001), 1, 500, 1), (1000, 0, 0.001))
Dim iir = Filter(s, IIRFilter(FILTER_BUTTERWORTH, FILTER_BANDPASS, 4, {0.1, 0.3}, 0.1, 0.1, FILTER_DELTA))
TransferFunction(s, iir, TRANSFERFUNCTION_AMPLITUDE, WIN_HAMMING + WIN_NORMALIZEAMPLITUDE, 2, 0, 50, 0)
Calcule la fonction de transfert du filtrage IIR. L'ensemble de données d'entrée du filtrage est un signal cosinus wobulé.
Voir aussi
Objet d'analyse Interspectre de Fourier