TransferFunction (FPScript)

21.09.2021

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, OutputSignal, [ SpectrumType = TRANSFERFUNCTION_COMPLEX ], [ Window = WIN_HANNING ], [ Adjustment ], [ SegmentLength = 0 ], [ OverlapOrGap = 50 ], [ FFTLength = 0 ] [ , 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éries de données, Matrice de données, 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éries de données, Matrice de données, 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 :

Constante

Signification

TRANSFERFUNCTION_AMPLITUDE

Amplitude de la fonction de transfert complexe

TRANSFERFUNCTION_DB

Fonction de transfert en dB (décibels)

TRANSFERFUNCTION_DBNORM

Fonction de transfert en dB (décibels), crête normalisée à zéro

TRANSFERFUNCTION_COMPLEX

Fonction de transfert complexe

TRANSFERFUNCTION_PHASE

Phase

TRANSFERFUNCTION_PHASEUNWRAP

Phase, dépliée

+ SPECTRUM_PEAKS O

Si cette constante est ajoutée à l'un des types de spectre ci-dessus, alors seuls les pics du spectre sont renvoyés.

O Cette constante n'est disponible que si une licence pour l'option Analyse spectrale est présente.

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 :

Constante

Signification

WIN_RECTANGULAR

Rectangulaire -13 dB (pas de fenêtrage, largeur=1)

WIN_WELCH

Welch -21 dB (largeur fixe=1,4)

WIN_SINE

Sinus -23 dB (largeur fixe=1,5)

WIN_BISQUARE

Bi-Square ou Connes -28 dB (largeur fixe=1,8)

WIN_BARTLETT

Bartlett -27 dB (largeur fixe=2)

WIN_HANNING

Hanning Max. Rolloff -31 dB (cosinus, ordre 2, largeur fixe=2)

WIN_TUKEYHANN O

Tukey-Hann -37 dB (largeur fixe=2)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_BARTLETTMOD O

Bartlett modifié -39 dB (largeur fixe=2,3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_HAMMING

Hamming Min. Sidelobe -43 dB (cosinus, ordre 2, largeur fixe=2)

WIN_COS3MAXROLLOFF O

C3 Max. Rolloff -47 dB (cosinus, ordre 3, largeur fixe=3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS3BLACKMAN

Blackman -58 dB (cosinus, ordre 3, largeur fixe=3)

WIN_COS3BHARRIS62 O

Blackman-Harris -62 dB (cosinus, ordre 3, largeur fixe=3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS3NUTALL O

C1 Nutall -64 dB (cosinus, ordre 3, largeur fixe=3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS3BLACKMANEXACT O

Blackman Exact -68 dB (cosinus, ordre 3, largeur fixe=3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS3BHARRIS68 O

Blackman-Harris -68 dB (cosinus, ordre 3, largeur fixe=3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS3MINSIDELOBE O

Nutall -71 dB (cosinus, ordre 3, largeur fixe=3)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS4MAXROLLOFF O

C5 Max. Rolloff -61 dB (cosinus, ordre 4, largeur fixe=4)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS4BHARRIS74 O

Blackman-Harris -74 dB (cosinus, ordre 4, largeur fixe=4)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS4NUTALL83 O

C3 Nutall -83 dB (cosinus, ordre 4, largeur fixe=4)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS4BHARRIS92 O

Blackman-Harris -92 dB (cosinus, ordre 4, largeur fixe=4)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS4NUTALL93 O

C1 Nutall -93 dB (cosinus, ordre 4, largeur fixe=4)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COS4NUTALL96 O

Nutall -96 dB (cosinus, ordre 4, largeur fixe=4)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_FLATTOP

Flattop -68 dB (cosinus, ordre 5, largeur fixe=5)

WIN_BETA O

Beta, Max. Rolloff (largeur réglable = 1,5-6)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COSMAXROLLOFF O

Cosinus Max. Rolloff (largeur réglable = 1,5-6)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_KAISERBESSEL

Kaiser-Bessel (largeur fixe = 3, largeur réglable = 1,5-6 avec l'option d'analyse spectrale installée)

WIN_VANDERMAAS O

VanderMaas (largeur réglable = 1,5-6)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_CHEBYSHEV O

Tchebyshev (largeur réglable = 1,75-5,75)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_CHEBYSHEVAPPROX O

Tchebychev Environ (largeur réglable = 2,1-5)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_SLEPIAN O

Slepian DPSS-1 (largeur réglable=2-5)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_GAUSS O

Gaussian (largeur réglable = 2-6)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

WIN_COSTAPER O

Tapered Cosine (largeur réglable = 1 à 2)

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

+ WIN_NORMALIZEAMPLITUDE

Si cette constante est ajoutée à l'une des constantes de la fenêtre ci-dessus, une normalisation de l'amplitude est effectuée après l'application de la fenêtre. Dans ce cas, le gain de la fonction de fenêtre utilisée est utilisé pour la normalisation qui est la somme de toutes les valeurs de la fenêtre divisée par leur nombre. Cela permet de compenser l'amortissement des amplitudes provoquées par la fenêtre. Il est donc particulièrement utile pour mesurer les pics dans le spectre.

+ WIN_NORMALIZEPOWER O

Si cette constante est ajoutée à l'une des constantes de fenêtre ci-dessus, une normalisation de la puissance est effectuée après l'application de la fenêtre. Ainsi, la perte de puissance est compensée. Le rapport entre la somme des données au carré avant et après l'application de la fenêtre est utilisé comme facteur de normalisation.

O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.

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 différents segments de données. 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 spécifié comme un nombre positif, alors il spécifie le pourcentage de chevauchement des segments de données individuels. S'il est spécifié comme un nombre négatif, alors son montant spécifie l'écart entre les segments de données individuels en échantillons.

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 à 2147483648.

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 de pics 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

La structure de données du résultat est un signal ou une 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 par Nyquist. Si les deux ensembles de données ont une composante X, celle-ci doit être identique. Le nombre de valeurs dans chaque ensemble de données et, dans le cas de matrices de données ou de séries de signaux, le nombre de colonnes doit également correspondre. Par exemple, vous pouvez combiner une série de signaux avec un signal. Dans ce cas, le spectre du signal est combiné avec les spectres de chaque colonne 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

Fonction Coherence

Fonction CrossPeriodogram

Fonction CrossSpectrum

Option Analyse Spectrale

Objet d'analyse Interspectre de Fourier

Mesures Interspectres

Fenêtre d'observation des données

Analyse spectrale de Fourier

Tutoriel Analyse Interspectrale

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :