_dp_fct (DP-Funktion)

Dp-Funktion

Die Attribute des Konfigs entnehmen Sie bitte dem Anhang.

Panel DP-Funktion

Wählten Sie zuvor DPE Verknüpfung als Funktionstyp, gelangen Sie mit der Schaltfläche Parametrieren zu folgendem Panel:

Parameter

In der Liste Parameter stehen die eingegebenen Parameter die bei der Berechnung der Funktion verknüpft werden sollen:

• Neue Parameter geben Sie im Textfeld unter der Parameterliste ein.
• Die Anordnung dieser Parameter wird über die Schaltflächen festgelegt (siehe Schaltflächen). Der aktuelle Eintrag wird in der Parameterliste markiert dargestellt.
• Markierte Einträge können durch Anklicken der Schaltfläche Löschen aus der Liste entfernt werden.
• Ein Editieren der Einträge in der Tabelle "Wert eines DPE als Parameter p" ist nach Markieren, durch Anklicken des Eintrags mit der linken Maustaste, und durch Anklicken der Schaltfläche möglich. Der markierte Eintrag wird gegen den Eintrag im Eingabefeld getauscht.
• Zur Unterstützung bei der Eingabe von Datenpunktparameter dient die Schaltfläche DP. Sie öffnet nach Anklicken den Datenpunktauswahldialog.

In derselben Weise definieren Sie die globale Variable für die Datenpunktfunktionen. Globale Variable werden allerdings nur einmal aufgerufen, nachträgliche Wertänderungen werden nicht berücksichtigt. Das heißt, der Funktionswert wird immer mit dem gleichen Wert von g1 multipliziert. Wird in der Funktionsleiste ein CTRL-Skript der <proj_path>/libs angeben, so kann der Rückgabewert der Funktion für die Berechnung verwendet werden.

Funktion

In diesem Feld wird die Datenpunktfunktion definiert und Parameter miteinander verknüpft. Erlaubte Eingaben sind die zuvor definierten Parameter p1, p2, ... und mathematische Verknüpfungen. Die folgenden mathematische Operatoren +,-,*,/,%,&,|,^,~,<<,>>, &&, ||, ?, <,>,<=,>=,==,!=,++ sind erlaubt, siehe Operatoren in CTRL.

Es können aber auch Control-Funktionen mit Rückgabewert in diesem Feld verwendet werden. Beachten Sie, dass wartende Funktionen nicht erlaubt sind (dpSetWait, kein delay, dpQuery …). Die system()-Funktion ist ebenfalls verboten.

anytype work(anytype p1, … anytype pn)
{
   return <string der eingabezeile im PARA>;
}
BEISPIEL: Aus p1 + p2 wird:
anytype work(anytype p1, anytype p2)
{
   return p1 + p2;
}
/* Der Ausdruck muss ein valides CTRL-Skript sein. Dadurch ist auch folgendes möglich:
Wenn auf ein integer DPE die dp_fct dynlen(p1) parametriert wird und p1 ein dyn DPE ist: */
anytype work(anytype p1)
{
   return dynlen(p1);
}

Alt-Neu-Vergleich

Über die Checkbox kann der alt/neu-Vergleich für die DP-Funktion aktiviert werden.

Statistische Funktionen

Die statistischen Funktionen dienen dazu, statistische Werte (wie Mittelwert, Maximum, usw.) intervallorientiert aus Onlinewerten, Originalwerten bzw. Offlinewerten (siehe Korrekturwerte und Statistische Funktionen) zu ermitteln. Die in den Statusbits enthaltene Qualitätsinformation wird, je nach Einstellung, ebenfalls berücksichtigt. Das Panel besteht aus drei Registerkarten.

Registerkarte Parameter

• In der Combobox oben rechts im Panel wird der Name des zu bearbeitenden Datenpunktelements bzw. Beschreibung oder Alias angezeigt.
• Die Datenpunktattribute wählen Sie über die Schaltfläche des DP Selektors oder geben Sie direkt in das Eingabefeld daneben ein. Hier muss ein Eintrag erfolgen.
• Mit den 4 Schaltflächen wird der Eintrag vor oder nach dem letzten Eintrag eingefügt, geändert oder gelöscht.
• Daneben ist eine Combobox, wo Sie aus verschiedenen Statistischen Funktionen wählen können.
• Darunter können Sie wieder globale Variable festlegen (optional). Sie wird wie bei den DP Funktionen nur einmal aufgerufen - Wertänderungen werden nicht berücksichtigt (siehe oben).
• Das Resultat der Funktion wird im untersten Eingabefeld definiert.

Minimum- und Maximumwerte werden aus der Treppenkurven-Interpolation berechnet und nicht aus der Wertreihe, d.h. Minimum und Maximumzeit sind immer im aktuellen Zeitbereich und wenn in einem Intervall keine neuen Werte auftreten, so enthält Minimum bzw. Maximum den ersten bekannten Wert des Intervalls als Zeitstempel.

Die beiden Integral-Funktionen liefern ihr Ergebnis in der Einheit: Einheit der Ausgangsgröße mal Sekunden.

Registerkarte Synchronisation

Der Zeitpunkt der Berechnung wird über die Registerkarte Synchronisation gesetzt.

Registerkarte Bit

In der Registerkarte Bit stellen Sie den Einfluss der Statusbits auf die Berechnungen ein.

Die Qualitätsinformation soll auch auf den Ergebniswert übernommen werden können.

Eine Spalte listet sämtliche Bits, welche die Berechnung beeinflussen können. Je Bit kann eine Schwelle eingestellt werden. Dazu schreiben Sie einen Wert in das vorgesehen Eingabefeld.

In der Combobox "Behandlung von Statusbits" wählen Sie aus folgenden Möglichkeiten:

• Nichts: Das Statusbit wird für die Berechnung nicht berücksichtigt (default);
• Zeitraum ignorieren: der Zeitraum, in welchem das Bit gesetzt war, wird für die Berechnung nicht herangezogen. Wenn bei mehreren Bits eine Behandlung der Statusbit für Wert oder Zeit angegeben ist, werden die betroffenen Bits miteinander ODER-verknüpft und das Ergebnisbit wird zur Berechnung verwendet. Außerdem müssen alle diese Bits die gleiche Behandlung der Statusbits parametriert haben. Ansonsten liegt ein Parametrierfehler vor (wenn z.B. der ASCII-Manager entsprechende Daten einspielt).
• Bits übertragen: Das Statusbit wird für die Berechnung nicht berücksichtigt; Zusätzlich aber wird das Statusbit entsprechend der gewählten Schwelle übertragen. Mit anderen Worten wird für das Datenpunktelement wofür die _dp_fct aktiviert wurde, das Statusbit für das _original-Konfig gesetzt

Als "Schwelle" wird einen Wert in Prozent bezeichnet, welcher wie folgt ausgewertet wird:

• Ist das Bit gleich lang oder länger als die Zeit Schwelle % vom Berechnungsintervall gesetzt, so wird das Bit unter Änderbare Bits -> User Bits im Ergebniswert (_original-Konfig) gesetzt (die Bits "ungültig" und "ersatz" sind nur lesbare Attribute und können daher nicht direkt übernommen werden).
• Bei Schwelle = 0% führt jedes Auftreten zur Übernahme des Bits.
• Bei einem negativen Wert (default = -1) wird das Bit niemals übernommen. Das Bit "aut_inv" wird auch schon in den derzeitigen statistischen Funktionen bei internen Fehlern gesetzt. Dieser invalid-Zustand wird mit dem aus dem Bit "ungültig" abgeleiteten ODER-verknüpft.

Korrekturwerte und statistische Funktionen

Die statistischen DP-Funktionen wurden um die Behandlung von Korrekturwerten erweitert. Dies erfolgt automatisch bei Anmeldung der DP-Funktion auf das config "_offline.._value" (nicht aber bei _original/_online.._value). Im Detail:

Der Anwender schickt einen Korrekturwert xx.:_corr.._value auf einen Datenpunkt, der die Quelle für eine andere statistische Funktion ist. In diesem Fall berechnet der Event-Manager die statistische Funktion neu. Dabei sind zwei Fälle möglich:

Intervall noch nicht berechnet:

Ist das betreffende Intervall noch nicht berechnet, dann wird am Ende des Intervalls der Korrekturwert in die laufende Berechnung mit einbezogen. Weiters gilt:

• Der abhängige Wert (in den Beispielen der Tageswert) wird nur dann als Korrekturwert gekennzeichnet, wenn die Änderung mehr als statFctLimitForMarkAsCorrcted (default: 0; siehe unten) in Relation zum nicht korrigierten Tageswert ausmacht.
• Andernfalls wird der Wert ohne Korrekturkennung verschickt. Für diese Entscheidung wird der Wert OHNE Korrekturen (Online-Wert) mit dem Wert MIT Korrekturen (Offline-Wert) vergleichen (siehe Konfig-Eintrag statFctInheritCorrValues).

Intervall ist schon berechnet

Ist das betreffende Intervall schon abgeschlossen, dann muss die Berechnung aus den historischen Werten durchgeführt werden, um einen Wert als Korrekturwert zu kennzeichnen.

statFctInheritCorrValues

[general]
 statFctInheritCorrValues = 1

Mit 0 werden die Änderungen nicht übernommen, die Statistischen Funktionen arbeiten wie bisher.

statFctLimitForMarkAsCorrected

Der Config-Eintrag statFctLimitForMarkAsCorrected (Voraussetzung: statFctInheritCorrValue = 1) legt die Schranke für die angenommen Korrekturwerte fest (Type: int, Default: 0, Wertebereich 0-1000 %% Promille).

[general]
 statFctLimitForMarkAsCorrected = 0

Mit dem Wert 0 werden alle Werte als korrigiert markiert. Werte größer Null markieren die Werte nur ab der Änderung größer als x %%.

Wenn der Korrekturwert jetzt einen Einfluss auf den letzten Wert der Periode hat, müsste eigentlich auch die Folgeperiode (und die weiter nachfolgende Periode usw.; abhängig von der eingestellten Statistischen Funktion und den Werten) nachgerechnet werden, solange bis der Korrekturwert AUCH IN DEN WEITEREN FOLGEPERIODEN keine Änderung mehr gegenüber den ursprünglichen Werten verursacht.