FB_ALY_ClearanceFactor

Der Algorithmus Clearance Factor berechnet das gleichnamige Signal-Feature aus den Eingangswerten. Der Ausgangswert berechnet sich aus dem Verhältnis des Spitzenwertes des Eingangssignals zu dem quadrierten Mittelwert der Quadratwurzeln des absoluten Eingangssignals.

Die Anzahl der Eingangsdaten, die mit in die Berechnung einbezogenen werden und die Art der Berechnung können konfiguriert werden.

Syntax

Definition:

FUNCTION_BLOCK FB_ALY_ClearanceFactor
VAR_OUTPUT
    ipResultMessage: Tc3_EventLogger.I_TcMessage;
    bError: BOOL;
    bNewResult: BOOL;
    bConfigured: BOOL;
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.

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.
FB_init()	Local	Initialisieren der Anzahl der Eingangskanäle.
Reset()	Local	Setzt alle internen Zustände oder die bisher durchgeführten Berechnungen zurück.
SetChannelValue()	Local	Methode zur Übergabe von Werten an den Algorithmus.
GetChannelOutputValue()	Local	Methode für den Empfang von Werten von verschiedenen Ausgangskanälen.

Beispiel

VAR
    fbClearanceFactor : FB_ALY_ClearanceFactor(nNumChannels := 1);
    eWindowMode : E_ALY_WindowMode := E_ALY_WindowMode.FixWindow;
    nWindowSize : UDINT := 100;
    bConfigure : BOOL := TRUE;
    fInput : LREAL;
    fClearanceFactor : LREAL;
END_VAR

// Configure algorithm
IF bConfigure THEN
    bConfigure := FALSE;
    fbClearanceFactor.Configure(eWindowMode, nWindowSize);
END_IF

// Call algorithm
fbClearanceFactor.SetChannelValue(1, fInput);
fbClearanceFactor.Call();
fbClearanceFactor.GetChannelOutputValue(1, fClearanceFactor);

Voraussetzungen

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

Weiterführende Informationen