weisang.com > Documents Articles > MultitaperSpectrum (FPScript)

Documentation FlexPro

MultitaperSpectrum (FPScript)

21.09.2021

Calcule le spectre de Slepian ou DPSS Multitaper Fourier.

Syntaxe

MultitaperSpectrum(Signal, [ SpectrumType = SPECTRUM_DBNORM ], [ Adjustment = 4.0 ], [ WindowCount = WIN_NORMALIZEAMPLITUDE ], [ FFTLength = 0 ] [ , Peaks ])

La syntaxe de la fonction MultitaperSpectrum se compose des éléments suivants :

Section

Description

Signal

Les données à analyser. Les données doivent avoir un taux d'échantillonnage constant et ne doivent pas contenir de valeurs invalides (void).

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 spectral à calculer.

L'argument SpectrumType peut avoir les valeurs suivantes :

Constante	Signification
SPECTRUM_AMPLITUDE	Amplitude
SPECTRUM_RMSAMPLITUDE	Amplitude RMS
SPECTRUM_AMPLITUDE2	Amplitude2
SPECTRUM_DB O	Amplitude en dB (décibels) O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_DBNORM O	dB (décibels) crête normalisée à zéro O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_PSD O	DSP (Densité Spectrale de Puissance) O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_TISA O	TISA (Time Integral Amplitude2) O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_MSA	MSA (Amplitude moyenne2)
SPECTRUM_SSA O	SSA (Somme des Amplitudes2) O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_VARIANCE O	Normalisation de la variance de puissance O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_MAGNITUDE2 O	Magnitude2 O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
SPECTRUM_MAGNITUDE O	Magnitude O Cette constante n'est disponible que si une licence pour l'option Analyse d'ordre ou l'option Analyse spectrale est présente.
+ 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.
+ SPECTRUM_SIGNIFICANCE50 O	Si l'on ajoute l'une de ces constantes à l'un des types de spectre ci-dessus, alors la limite critique pour le niveau de signification 50 % est renvoyée sous la forme d'une courbe sur la fréquence. O Cette constante n'est disponible que si une licence pour l'option Analyse spectrale est présente.
+ SPECTRUM_SIGNIFICANCE90 O	Si l'on ajoute l'une de ces constantes à l'un des types de spectre ci-dessus, la limite critique pour le niveau de signification de 90 % est renvoyée sous la forme d'une courbe sur la fréquence. O Cette constante n'est disponible que si une licence pour l'option Analyse spectrale est présente.
+ SPECTRUM_SIGNIFICANCE95 O	Si l'on ajoute l'une de ces constantes à l'un des types de spectre ci-dessus, la limite critique pour le niveau de signification 95 % est renvoyée sous la forme d'une courbe sur la fréquence. O Cette constante n'est disponible que si une licence pour l'option Analyse spectrale est présente.
+ SPECTRUM_SIGNIFICANCE99 O	Si l'on ajoute l'une de ces constantes à l'un des types de spectre ci-dessus, la limite critique pour le niveau de signification 99 % est renvoyée sous la forme d'une courbe sur la fréquence. O Cette constante n'est disponible que si une licence pour l'option Analyse spectrale est présente.
+ SPECTRUM_SIGNIFICANCE99_9 O	Si l'on ajoute l'une de ces constantes à l'un des types de spectre ci-dessus, la limite critique pour le niveau de signification 99,9 % est renvoyée sous la forme d'une courbe sur la fréquence. O Cette constante n'est disponible que si une licence pour l'option Analyse spectrale est présente.
SPECTRUM_HARMONICS O	Produit les informations spectrales sur les pics du spectre sous forme de matrice de données. Il s'agit du spectre de Fourier : Fréquence, amplitude, phase, PSD, % de puissance et % de puissance relative. Le % de puissance est normalisé à la somme de 100 et le % de puissance relative est normalisé à un maximum de 100 %. Pour le spectre de Fourier des données non équidistantes: Fréquence, Amplitude, PSD, % de puissance et % de puissance relative. Pour le périodogramme : Fréquence, Amplitude, Amplitude SD, PSD, % de puissance et % de puissance relative. Pour le spectre Multitaper : Fréquence, Amplitude, Phase, PSD, Puissance en %, Puissance relative en % et valeur F. Si l'argumentPeaks n'est pas spécifié, un nombre de crêtes de 10 est pris par défaut. Ce type est autorisé uniquement pour les ensembles de données unidimensionnels. 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 SPECTRUM_DBNORM .

Adjustment

La largeur de Fourier unilatérale comme un multiple de l'intervalle de fréquence.

Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés.

La valeur doit être supérieure ou égale à 2.0 et inférieure ou égale à 5.0.

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 4.0 .

WindowCount

Le nombre de fenêtres à appliquer et à moyenner dans la séquence DPSS. La plage valable est comprise entre 1 et 2 * Ajustement -1. En option, une constante peut être ajoutée pour sélectionner la normalisation de l'amplitude ou de la puissance. La valeur par défaut 0 + WIN_NORMALIZEAMPLITUDE permet de choisir le nombre maximum de fenêtres et la normalisation de l'amplitude.

L'argument WindowCount peut avoir les valeurs suivantes :

Constante

Signification

+ 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

L'ajout de cette constante n'a aucune incidence dans ce cas car le spectre est toujours normalisé en puissance tant que la normalisation de l'amplitude n'est pas sélectionnée.

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_NORMALIZEAMPLITUDE .

FFTLength

La longueur de la transformée de Fourier. Si la longueur FFT est supérieure à la longueur des données, des zéros sont ajoutés. La plage valable va de la longueur des données à la limite maximale de la FFT. La valeur par défaut est -1, ce qui définit la longueur de la FFT égale à la puissance suivante la plus élevée de deux. La valeur par défaut est 0, ce qui définit la longueur de la FFT égale à la longueur des données.

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 à -1 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

S'il est spécifié, seuls les pics interpolés en bin du spectre sont émis. Les pics peuvent être spécifiés comme un nombre de pics, un nombre positif de 1 à 100, ou comme une valeur F, un nombre négatif de -1000 à -0,5. Cet argument n'est autorisé que pour les ensembles de données unidimensionnels.

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 des données du résultat est un signal ou une série de signaux. Si l'argument Signal 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.

Disponible dans

Option Analyse spectrale

Exemples

MultitaperSpectrum(Signal, SPECTRUM_DBNORM, 3, 0 + WIN_NORMALIZEPOWER, 4096)

Calcule le spectre de Fourier Multitaper pour le signal "Signal". Cette méthode est utilisée lorsqu'une estimation spectrale avec une faible variance est nécessaire, comme pour la mesure de la puissance. dB est normalisé comme type de spectre et 3 est sélectionné comme ajustement de la fenêtre. Le nombre de fenêtres DPSS est fixé à la valeur maximale. La longueur de la FFT est de 4096. Il s'agit d'un exemple tiré du Tutoriel Analyse spectrale de Fourier.