ST_CM_SparseSpectrum_InitPars

Baustein-spezifische Struktur mit Initialisierungsparametern, die bei der Initialisierung des Bausteins ausgewertet werden.

TYPE ST_CM_SparseSpectrum_InitPars EXTENDS ST_CM_Object_InitPars :
STRUCT
    nWindowLength        : UDINT := 1000;                                         (* Length of analysis window. *)
    fSampleRate          : LREAL := 10000;                                        (* Sample rate in Hertz. *)
    nBins                : UDINT := 1;                                            (* Number of spectral bins. *)
    eSpectrumType        : E_CM_SpectrumType := E_CM_SpectrumType.eCM_Magnitude;  (* Type of spectrum, i.e. plain DFT, magnitude, power. *)
    eWindowType          : E_CM_WindowType := eCM_HannWindow;                     (* Window type. *)
    aWindowParameters    : T_CM_WindowParameters := [2.5,1,1,1,1];                (* Window parameters for specific windows, e.g. FlatTop. *)
    nOverlap             : UDINT := -1;                                           (* Size of overlap in samples. *)
    eScalingType         : E_CM_ScalingType := eCM_DiracScaling;                  (* Scaling type. *)
    bTransformToDecibel  : BOOL := FALSE;                                         (* Transform to decibel. *)
    fDecibelThreshold    : LREAL := cCM_MinArgLog10;                              (* Minimum argument of decadic logarithm for 64- bit IEEE 754 arithmetic. *)
    nChannels            : UDINT := 1;                                            (* Number of channels. *)
END_STRUCT
END_TYPE

• nWindowLength ist die Länge des Analysefensters in Samples. Die Länge muss größer als Eins und eine gerade Zahl sein.
• fSampleRate Abtastrate des eingehenden Zeitsignals. Der Wert wird genutzt zur Skalierung des Ergebnisses in Hz.
• nBins ist die Anzahl der zu berechnenden Spektralwerte. Die zugehörigen Indizes (k := f / fSampleRate / nWindowLength) müssen über die Configure() Methode nach der Initialisierung konfiguriert werden.
• eSpectrumType definiert die Art der zu berechnenden Spektralwerte (vom Typ E_CM_SpectrumType). Die Skalierung der Werte ist auf den jeweiligen Typ angepasst, sodass die Werte mit den Ergebnissen der Bausteine FB_CMA_RealFFT, FB_CMA_MagnitudeSpectrum bzw. FB_CMA_PowerSpectrum übereinstimmen.
• eWindowType definiert die verwendete Fensterfunktion (vom Typ E_CM_WindowType). Ein guter Standardwert ist der Fenstertyp eCM_HannWindow.
• aWindowParameters beinhaltet die freien Parameter ausgewählter Fensterfunktionen. Bei der Verwendung von eCM_KaiserWindow definiert der erste Eintrag den Parameter beta; wird das eCM_FlatTopWindow verwendet, werden alle Parameter genutzt. Siehe Abschnitt Fensterfunktionen.
• nOverlap definiert die Anzahl der überlappenden Samples. Diese muss größer oder gleich Null sein. Wird der Wert cCM_OverlapRecommended gewählt, so wird eine empfohlene Überlappung intern berechnet (siehe F_CM_CalculateRecommendedOverlap); der Wert cCM_OverlapInactive deaktiviert den intern verwendeten Puffer und setzt den Wert Null.
• eScalingType ermöglicht eine Auswahl der verwendeten Skalierung (vom Typ E_CM_ScalingType), falls eine absolute Skalierung benötigt wird. Standardwert ist eCM_DiracScaling. Bei der Auswahl der Skalierung sollte die Art des Signals, entweder deterministische Signale oder breitbandige Signale mit stochastischen Anteil, berücksichtigt werden; Beide Arten erfordern unterschiedliche Skalierungen.
• bTransformToDecibel ist ein boolescher Wert, der angibt, ob das Ergebnis der FFT in die Dezibel-Skala transformiert werden soll, entsprechend der Transformation x → 20 * log10(x).
• fDecibelThreshold ist ein sehr kleiner Fließkommawert größer als Null. Werte, die kleiner als diese Zahl sind, werden vor einer Transformation in die Dezibel-Skala durch diesen Wert ersetzt. (Zweck ist die Vermeidung von Wertbereichsfehlern. Der Logarithmus von Null ist nicht definiert und strebt für den Grenzwert kleiner Argumente gegen minus unendlich. Entsprechendes gilt für das Argument der Zahl Null, arg(0). Der kleinste mögliche Wert ist 2.3e-308, dies entspricht der Konstanten cCM_MinArgLog10.)
• nChannels definiert die Anzahl von unabhängigen Kanälen. Diese muss größer als Null sein.