FB_ALY_Histogram_1Ch

Histogram 1Ch berechnet die Verteilung eines Einzelkanal-Eingangswerts zyklisch. Er kann mit minimaler Klasse, maximaler Klasse und Gesamtanzahl der Klassen konfiguriert werden. Die Dimension des Ausgangs-Arrays ist die Anzahl der Klassen + 2, da Werte, die kleiner als die minimale Klasse sind, im ersten Array-Element gespeichert werden und Werte, die größer als die maximale Klasse sind, im letzten Array-Element gespeichert werden.

Syntax

Definition:

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

FB_ALY_Histogram_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_Histogram_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.

SetInitial()

Local

Methode zum Setzen von Startwerten für das Histogramm

Beispiel

VAR
    fbHistogram : FB_ALY_Histogram_1Ch;
    eHistMode : E_ALY_HistMode := E_ALY_HistMode.Absolute;
    nBins : UDINT := 20;
    fMinBinned : LREAL := 1;
    fMaxBinned : LREAL:= 200;
    bConfigure : BOOL := TRUE;
    nInput : INT;
    aHistArrayOut : ARRAY[0..21] OF ULINT;
END_VAR
// Configure algorithm
IF bConfigure THEN
    bConfigure := FALSE;

    fbHistogram.Configure(eHistMode, nBins, fMinBinned, fMaxBinned);
END_IF

// Call algorithm
fbHistogram.SetChannelValue(nInput);
fbHistogram.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