FB_ALY_PieChart

Der Baustein Pie Chart kann verwendet werden, um ein Tortendiagramm (Pie Chart) zur späteren Verwendung im HMI Dashboard zu erstellen. Die Anzahl der Tortenstücke kann über den ParameterNum Channels parametriert werden.

Da die Funktion dieses Bausteins für die Analyse selbst irrelevant ist, zählt er zur Kategorie Visualization Only.

Syntax

Definition:

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

FB_ALY_PieChart 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.

FB_ALY_PieChart 2: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.

ConfigureChannel()

Local

Kanalspezifische Konfiguration

FB_init

Local

Initialisieren der Anzahl der Eingangskanäle.

GetChannelOutputValue()

Local

Methode für das Abholen von einzelnen Ausgangswerten aus dem Ausgangs-Array.

GetOutputArray()

Local

Methode für das Abholen des gesamten Ausgangs-Arrays.

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.

SetInputArray()

Local

Gleichzeitiges Setzen aller Eingangskanäle.

Beispiel

VAR
    fbPieChart : FB_ALY_PieChart(nNumChannels := 3);
    aChannelNames : ARRAY[1..3] OF STRING(255) := ['First Channel', 'Second Channel', 'Third Channel'];
    bRelativeOutput : BOOL := TRUE;
    bConfigure : BOOL := TRUE;
    fInput1 : LREAL;
    nInput2 : ULINT;
    nInput3 : INT;
    aResult : ARRAY[1..3] OF LREAL;
END_VAR
// Configure algorithm
IF bConfigure THEN
    bConfigure := FALSE;

    fbPieChart.ConfigureChannel(1, aChannelNames[1]);
    fbPieChart.ConfigureChannel(2, aChannelNames[2]);
    fbPieChart.ConfigureChannel(3, aChannelNames[3]);
    fbPieChart.Configure(bRelativeOutput);
END_IF

// Call algorithm
fbPieChart.SetChannelValue(1, fInput1);
fbPieChart.SetChannelValue(2, nInput2);
fbPieChart.SetChannelValue(3, nInput3);
fbPieChart.Call();
fbPieChart.GetOutputArray(ADR(aResult), SIZEOF(aResult));

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS-Bibliotheken

TwinCAT v3.1.4024.0

PC oder CX (x64, x86)

Tc3_Analytics

Weiterführende Informationen