FB_ALY_ArrayStatistics

Der Algorithmus Array Statistics berechnet verschiedene statistische Größen auf Basis des Eingangs-Arrays.

Syntax

Definition:

FUNCTION_BLOCK FB_ALY_ArrayStatistics
VAR_OUTPUT
    ipResultMessage : Tc3_EventLogger.I_TcMessage;
    bError : BOOL;
    bNewResult : BOOL;
    bConfigured : BOOL;
    fMin : LREAL;
    nIdxMin : DINT
    fMax : LREAL;
    nIdxMax : DINT;
    fMaxDelta : LREAL;
    nIdxMaxDelta : DINT;
    nCountPeaks : ULINT;
    nCountValleys : ULINT;
    fSum : LREAL;
    fMean : LREAL;
    fStandardDeviation : LREAL;
END_VAR

Ausgänge

Name	Typ	Beschreibung
ipResultMessage	I_TcMessage	Beinhaltet nähere Informationen zum aktuellen Rückgabewert. Für diesen speziellen Schnittstellenzeiger ist intern sichergestellt, dass er immer gültig/zugewiesen ist.
bError	BOOL	Der Ausgang ist `TRUE`, wenn ein Fehler auftritt.
bNewResult	BOOL	Wenn ein neues Ergebnis berechnet wurde, ist der Ausgang `TRUE.`
bConfigured	BOOL	Zeigt `TRUE` an, wenn der Baustein erfolgreich konfiguriert ist.
fMin	LREAL	Kleinster Wert im Eingangsarray.
nIdxMin	DINT	Array-Index von `fMin`. Die Indexierung beginnt bei 1.
fMax	LREAL	Größter Wert im Eingangsarray.
nIdxMax	DINT	Array-Index von `fMax`. Die Indexierung beginnt bei 1.
fMaxDelta	LREAL	Maximum der absoluten Differenz zwischen zwei aufeinanderfolgenden Werten im Eingangsarray.
nIdxMaxDelta	DINT	Array-Index von `fMaxDelta`. Die Indexierung beginnt bei 1.
nCountPeaks	ULINT	Gesamtanzahl der identifizierten Peaks.
nCountValleys	ULINT	Gesamtanzahl der identifizierten Täler.
fSum	LREAL	Summe über das gesamte Eingangsarray.
fMean	LREAL	Mittelwert über das gesamte Eingangsarray.
fStandardDeviation	LREAL	Standardabweichung über das gesamte Eingangsarray.

Methoden

Name	Definitionsort	Beschreibung
Call()	Local	Methode zur Berechnung der Ausgänge für eine bestimmte Konfiguration.
Configure()	Local	Allgemeine Konfiguration des Algorithmus mit seinen parametrisierten Bedingungen. Die Konfiguration ist für alle Kanäle identisch.
Reset()	Local	Setzt alle internen Zustände oder die bisher durchgeführten Berechnungen zurück.

Beispiel

VAR
    fbArrayStatistics : FB_ALY_ArrayStatistics;
    bUseBesselCorrection : BOOL := TRUE;
    fThresholdReversal : LREAL := 0.5;
    fThresholdDelta : LREAL := 0.5;
    nLowerBound : DINT := 1;
    bConfigure : BOOL := TRUE;
    aInput : ARRAY[1..20] OF LREAL;
END_VAR

// Configure algorithm
IF bConfigure THEN
    bConfigure := FALSE;

    fbArrayStatistics.Configure(bUseBesselCorrection, fThresholdReversal, fThresholdDelta, nLowerBound);
END_IF

// Call algorithm
fbArrayStatistics.Call(ADR(aInput), SIZEOF(aInput));

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT v3.1.4024.0	PC oder CX (x64, x86)	Tc3_Analytics

Weiterführende Informationen