FB_ALY_StateHistogram_1Ch

Der Algorithmus State Histogram 1Ch zählt, wie oft das Eingangssignal (INT) einen bestimmten Wert zwischen dem konfigurierten Minimum und Maximum einnimmt und zeigt die Verteilung in einem Histogramm. Der erste Balken stellt die Grenzwerte dar, die kleiner als das Minimum sind, und der letzte Balken stellt die Grenzwerte dar, die größer als das Maximum sind. Der State Histogram 1Ch eignet sich für Zustandsmaschinen, um zu zeigen, wie oft die verschiedenen Zustände ausgeführt werden.

Syntax

Definition:

FUNCTION_BLOCK FB_ALY_StateHistogram_1Ch
VAR_OUTPUT
    ipResultMessage: Tc3_EventLogger.I_TcMessage;
    bError: BOOL;
    bNewResult: BOOL;
    bConfigured: BOOL;
    nNumValues: ULINT;
END_VAR

FB_ALY_StateHistogram_1Ch 1: 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.

nNumValues

ULINT

Anzahl der Werte, die im Histogramm aufgenommen wurden.

FB_ALY_StateHistogram_1Ch 2:Methoden

Name

Definitionsort

Beschreibung

Call()

Local

Methode zur Berechnung der Ausgänge für eine bestimmte Konfiguration.

GetResults()

Local

Abrufen des Ergebnis-Arrays, ohne neue Werte hinzuzufügen.

Configure()

Local

Allgemeine Konfiguration des Algorithmus mit seinen parametrisierten Bedingungen.

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.

SetInital()

Local

Methode zur Festlegung von Starthistogrammwerten.

Beispiel

VAR
    fbStateHistogram : FB_ALY_StateHistogram_1Ch;
    eStateHistMode : E_ALY_StateHistMode := E_ALY_StateHistMode.Absolute;
    nMin : LINT := 1;
    nMax : LINT:= 20;
    bConfigure : BOOL := TRUE;
    nInput : INT;
    aHistArrayOut : ARRAY[0..21] OF ULINT;
END_VAR
// Configure algorithm
IF bConfigure THEN
    bConfigure := FALSE;

    fbStateHistogram.Configure(eStateHistMode, nMin, nMax);
END_IF

// Call algorithm
fbStateHistogram.SetChannelValue(nInput);
fbStateHistogram.Call(ADR(aHistArrayOut), SIZEOF(aHistArrayOut));

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS-Bibliotheken

TwinCAT v3.1.4024.0

PC oder CX (x64, x86)

Tc3_Analytics

Weiterführende Informationen