HarmonicEstimation (FPScript)
Schätzt die Harmonischen nach der Methode kleinster Quadrate.
Syntax
HarmonicEstimation(Signal, [ Result = HARMONIC_COMPONENTS ], [ Algorithm = HARMONIC_AUTO ], [ Components = 60 dB ], [ Order ] [ , Model = HARMONIC_SINE ])
Die Syntax der HarmonicEstimation-Funktion besteht aus folgenden Teilen:
Teil |
Beschreibung |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Signal |
Die zu analysierenden Daten. Erlaubte Datenstrukturen sind Datenreihe und Signal. Es sind alle reellen Datentypen erlaubt. Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste. |
||||||||||||||||||||
Result |
Die zu berechnende Information über die Harmonischen. Das Argument Result kann folgende Werte haben:
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 HARMONIC_COMPONENTS gesetzt. |
||||||||||||||||||||
Algorithm |
Der Algorithmus zur Ermittlung der Frequenzen. Das Argument Algorithm kann folgende Werte haben:
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 HARMONIC_AUTO gesetzt. |
||||||||||||||||||||
Components |
Bestimmt die Anzahl der auszugebenden Komponenten bzw. deren Frequenzen. Die Komponenten können als Anzahl - eine positive Zahl zwischen 1 und 100 - als dB Schwelle - eine negative Zahl zwischen -0,01 und -300 - oder als Datenreihe mit vorgegebenen Frequenzen bestimmt werden. Wenn Sie eine Datenreihe mit Frequenzen angeben, dann muss das Argument Algorithm auf den Wert HARMONIC_LINEARMODELING gesetzt werden. Erlaubte Datenstrukturen sind Einzelwert und Datenreihe. Es sind alle reellen Datentypen erlaubt. 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 60 dB gesetzt. |
||||||||||||||||||||
Order |
Die Ordnung des AutoRegressive- bzw. Eigenwertanalyse-Modells. Der gültige Bereich liegt zwischen 1 und dem Minimum von 100 und 1/2 der Datenlänge - 1. Das Argument ist optional, der Vorgabewert ist das Minimum von 50 und 1/2 der Datenlänge - 1. Erlaubte Datenstrukturen sind Einzelwert. Es sind alle ganzzahligen Datentypen erlaubt. Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt. |
||||||||||||||||||||
Model |
Das zu verwendende Modell. Das Argument Model kann folgende Werte haben:
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 HARMONIC_SINE gesetzt. |
Anmerkungen
Die HarmonicEstimation-Funktion erstellt ein parametrisches Modell (sinusförmig oder gedämpft-sinusförmig) des Signals. Der Algorithmus zur Harmonischen Modellierung hat zwei Schritte. Im optionalen ersten Schritt wird ein AR-, Prony-, Eigenwertanalyse-, oder Fourier-Algorithmus verwendet, um die Anzahl der Spektralkomponenten und deren Frequenzen zu bestimmen. Alternativ können Sie diese Frequenzen als eine Datenreihe vorgeben. Im zweiten Schritt wird eine lineare Approximation berechnet, um die Amplituden und Phasen zu ermitteln.
Verfügbarkeit
Option Spektralanalyse
Beispiele
HarmonicEstimation(Signal, HARMONIC_COMPONENTS, HARMONIC_FOURIER, 10, 40, HARMONIC_SINE)
Schätzt die Harmonischen des Signals 'Signal'. Dabei wird als Algorithmus Fourier und als Modell Sinusförmig gewählt. Dies ist ein Beispiel aus dem Tutorial Harmonische Analyse.