TH NextGen - Tag Builder – Formel Tags

Mit der Formelfunktion können Sie mithilfe einfacher Mathematik und Funktionen berechnete Tags erstellen. Damit können Sie abgeleitete Größen definieren, z.B. Differenzdrücke, Temperaturdeltas, Gesamtdurchflüsse, KPIs, usw. 

Einen allgemeineren Überblick über Tags finden Sie hier.

Die Formel-Tags finden Sie im Menü des Tag Builders. 

screenshot1.png

Untermenü Formel

Formel-Feld: In diesem Feld können Sie Ihre gewünschte Formel mit Hilfe von Variablen eingeben. Jede eingegebene Variable wird im folgenden Abschnitt "Variablen zuordnen" angezeigt. 

Neben Variablen akzeptiert das Feld auch vordefinierte Funktionen, die Sie verwenden können, siehe "Funktionen" unten für weitere Details. Die automatische Vervollständigung von Funktionen wird ebenfalls unterstützt. Wenn Sie die Tabulatortaste auf Ihrer Tastatur drücken, wird die ausgewählte Funktion ausgefüllt.

formula_vis_autocomplete.png

Hinweis: Sie können jeden Variablennamen verwenden, wenn er keiner vordefinierten Funktion zugewiesen wurde.

formula_vis_format.png

Das Formelfeld unterstützt die Formatierung Ihrer Formel wie ein Code-Editor. So können Sie Ihre Formel einrücken und sogar Kommentare hinzufügen.

Wenn Sie auf eine Variable oder Funktion klicken, werden auch andere Vorkommen innerhalb der Formel hervorgehoben. Bei Klammern wird nur die entsprechende Klammer hervorgehoben.

Die farblichen Highlights sind wie folgt:
* variabel: blau
* Kommentar: grün
* Funktion: lila
* Klammern: alternierende Färbung. Rot gefärbt, wenn eine Klammer fehlt.

Hinweis: Dezimalstellen müssen mit einem Punkt (.) als Trennzeichen eingegeben werden, da das Komma (,) bereits für Formelfunktionen reserviert ist.

Hinweis: Die wissenschaftliche Notation mit der E-Notation wird unterstützt, wenn zwischen dem Koeffizienten und dem Exponenten kein Leerzeichen enthalten ist. Wenn ein Leerzeichen enthalten ist, wird der Buchstabe E als Variable interpretiert.

Variable zuordnen: Sobald Sie eine Variable in das Formel-Feld eingegeben haben, können Sie die Variable einem beliebigen bestehenden Tag in TrendMiner zuordnen. Über das Zuordnungsfeld können Sie schnell einen Tag aus Ihrer aktiven Liste auswählen oder nach einem beliebigen Tag suchen. 

Derzeit können maximal 10 Variablen zugewiesen werden.

Zeitverschiebungen: Mit diesem Kontrollkästchen können Sie Zeitverschiebungen für jeden zugeordneten Wert einbeziehen. Standardmäßig werden bei der Formelberechnung für alle zugeordneten Werte die Werte zum gleichen Zeitstempel verwendet. screenshot2.png

Formel-Funktionen

Sie können bestimmte Schlüsselwörter in das Formel-Feld eingeben, die als vordefinierte Funktion fungieren. Klicken Sie auf das Fragezeichensymbol "?", um die Dokumentation der integrierten Funktionen zu öffnen. Hier sehen Sie alle verfügbaren Funktionen und erfahren, wie Sie sie verwenden können. screenshot3.pngscreenshot4.png

In der Dokumentation der Funktionsdetails können Sie die Funktion automatisch in das Formelfeld einfügen, indem Sie auf das Syntaxbeispiel klicken.

Wenn Sie eine Funktion aus der Dokumentation hinzufügen, werden die Eingabeparameter und Ausdrücke für die Funktion als Platzhalter eingefügt. Diese Platzhalter können ersetzt werden, indem Sie die gewünschten Informationen direkt eingeben und mit der Tabulatortaste auf der Tastatur zwischen den verschiedenen Parametern und Ausdrücken wechseln.

Hinweis: Bei Funktionen, die zwei oder mehr Eingaben akzeptieren, werden nur die ersten beiden Parameter und Platzhalter für Ausdrücke hinzugefügt. Beispiel: Die Funktion max() kann bis zu 10 verschiedene Eingaben akzeptieren, aber es werden nur zwei Platzhalter angezeigt.

formula_vis_documentation.png

Beispiel 1: In diesem Beispiel möchten Sie je nach Temperatur eine andere Berechnung zurückgeben. Sie möchten die Messung mit einem Korrekturfaktor von 0,789 zurückgeben, wenn die Temperatur unter 30 Grad Celsius liegt, und mit einem Faktor von 1,345, wenn die Temperatur darüber liegt. Für diesen Fall können Sie die "if"-Funktion verwenden.  

Aus dem Hilfe-Menü können Sie ersehen, dass die Syntax für die "if"-Funktion wie folgt lautet:

if(condition,value_if_true,value_if_false)

Hier müssen wir unsere Bedingung definieren (Temperatur über 30 Grad Celsius) und was zurückgeben werden soll, wenn diese Bedingung wahr (Faktor 1,345) oder falsch (Faktor 0,789) ist. Die Formel, die wir eingeben müssen, lautet also: 

if(temp>30, 1.345 * tagA, 0.789 * tagA)

Mit dieser Formel könnten wir dann die Temperaturmessung der Variablen "temp" zuordnen und die Messung, die wir korrigieren möchten, der Variablen "tagA".

Beispiel 2: In diesem Beispiel möchten Sie eine Summe berechnen, wenn mindestens 1 von 3 Ventilen offen ist. Wenn alle Ventile geschlossen sind, wollen wir 0 anzeigen. Dazu verwenden wir eine Kombination aus einer "if"- und "or"-Funktion.

Aus dem Hilfe-Menü können Sie ersehen, dass die Syntax für die "oder"-Funktion wie folgt lautet:

or(expression1,expression2,…,expression10)

Beachten Sie, dass die "oder"-Funktion WAHR zurückgibt, wenn einer der Ausdrücke als wahr bewertet wird. Dies können wir direkt in die "if"-Funktion als Bedingung eingeben: 

if(or(valve1="open", valve2="open", valve3=1), A+B, 0) 

Diese Formel gibt den Wert Null zurück, wenn alle Ventile geschlossen sind, und gibt die Berechnung der Tags zurück, die auf "A+B" abgebildet sind, wenn mindestens eines der Ventile geöffnet ist.

Formel Ausgabe

Die Ausgabe eines Formel-Tags ist immer ein analoges (linear interpoliertes) Tag.

Tag Typ & Eingabe Konvertierungen

Diskrete, digitale und String-Tags werden zunächst in lineare Analogwerte umgewandelt, wenn sie in mathematischen Operationen verwendet werden.

Berechnung

Die Berechnung der Formel-Tags erfolgt auf der Grundlage aller vorhandenen Indexierungspunkte der zugeordneten Variablen. Ein interpolierter Wert zwischen zwei Punkten wird verwendet, wenn für andere zugeordneten Variablen zu diesem bestimmten Zeitstempel kein Indexierungspunkt existiert. 

Bei der Betrachtung kleinerer Zeitfenster (kleiner als das 300-fache der Indexauflösung) holt sich TrendMiner die Daten direkt aus dem Historian, anstatt indexierte Werte zu verwenden. In diesem Szenario wird eine Ad-hoc-Berechnung auf der Grundlage der visualisierten Daten anstelle der indexierten Werte durchgeführt, die möglicherweise feinkörniger sind als die indexierten Werte. 

Hinweis: Andere TrendMiner-Funktionen verwenden immer die gespeicherten Indexwerte der Formel-Tags für weitere Berechnungen.

Beschränkungen 

Für Formel-Tags gelten die allgemeinen Einschränkungen, die im Übersichtsdokument des Tag Builders aufgeführt sind. 

Variablen

Es können maximal 10 Variablen für die Zuordnung jeder Formel aufgenommen werden.

Eingabe und Ausgabe

  • Diskrete, digitale und String-Tags werden bei der Verwendung in mathematischen Operationen zunächst in lineare Analogwerte umgewandelt.
  • Die Ausgabe eines Formel-Tags ist immer ein analoger (linear interpolierter) Tag.
Enjoying TrendMiner? Share your experience to help the community.
Rate TrendMiner