Beschreibung der Aggregationsfunktionen
Beschreibung
Folgenden Aggregationsmöglichkeiten stehen zur Verfügung.
Aggregationstypen
-
Einzelwertaggregation
Eine Variable wird durch die Angabe der Aggregationsmethode und des Berechnungszeitraums aggregiert. Das Ergebnis ist ein Wert, der die Werte des Zeitraums für die jeweilige Aggregation darstellt.
Berechnungszeitraum: from[to], from exclusive, to inclusive
Beispiel: "Ich möchte, dass die Summe 'sum' der 'Variable X' von '2022 bis 2023' berechnet wird." => 1 Wert wird zurückgegeben, der die aufsummierten Werte des Jahres darstellt.
-
Aggregation mehrerer Werte
Eine Einzelwertaggregation kann für einen bestimmten Zeitraum mehrfach berechnet werden. Die Aggregation mehrerer Werte wird durch den Zeitraum und die Aggregationen der einzelnen Werte (bestehend aus Berechnungszeitraum und Aggregationsmethode) definiert. Das Ergebnis sind mehrere Werte, wobei jeder Wert die Werte in diesem Berechnungszeitraum für die jeweilige Aggregation darstellt.
Beispiel: "Ich möchte, dass die Summe 'sum' der 'Variable X' jeden Tag 'von 2022 bis 2023' berechnet wird." => Es werden 365 Werte zurückgegeben, wobei jeder Wert die aufsummierten Werte eines Tages darstellt.
-
Vorberechnete Aggregationen
Aggregationen können so geplant werden, dass sie kontinuierlich im Hintergrund durchgeführt werden. Die beiden anderen Aggregationstypen werden auf Anfrage berechnet. Dieser Aggregationstyp ermöglicht die Berechnung der Aggregationen auf 'new-value-written'. Das reduziert die Rückgabezeit der Anforderung und verteilt die Ressourcennutzung entsprechend den geschriebenen Ratenwerten, sodass keine Spitzen wie bei den anderen beiden Aggregationstypen auftreten.
Eine vorberechnete Aggregation wird durch eine Aggregation und einen Zyklus, in dem sie ausgeführt werden soll, definiert. Das Ergebnis ist eine zusätzliche Untervariable, die die Aggregation jeden Zyklus speichert.
Beispiel: "Ich möchte, dass die Summe 'sum' der 'Variable X' 'jeden Tag' berechnet wird." => Es wird eine neue Untervariable erstellt, in der jeden Tag ein neuer Wert gespeichert wird, welcher die aufsummierten Werte des Tages darstellt.
Aggregationsmethoden
Boolesche Werte werden in Berechnungen als numerische Werte 0 und 1 interpretiert.
-
Sum
Gibt die Summe der numerischen Werte für den Berechnungszeitraum zurück.
-
Count
Gibt die Anzahl der Werte innerhalb des Berechnungszeitraums zurück.
-
Average
Gibt den arithmetischen Durchschnitt numerischer Werte für den Berechnungszeitraum zurück.
Alle Werte haben die gleiche Gewichtung. Das Ergebnis kann eine Gleitpunktzahl sein.
-
Min
Gibt den niedrigsten numerischen Wert innerhalb des Berechnungszeitraums zurück.
-
Max
Gibt den höchsten numerischen Wert innerhalb des Berechnungszeitraums zurück.
-
First
Gibt den ersten Wert innerhalb des Berechnungszeitraums zurück.
-
Last
Gibt den letzten Wert innerhalb des Berechnungszeitraums zurück.
-
Counter
Gibt die summierten Wertänderungen numerischer Werte innerhalb des Berechnungszeitraums zurück.
Bei einem Vorwärtszähler werden nur positive Wertänderungen aufsummiert. Negative Wertänderungen werden als Zählerreset interpretiert.
Bei einem Rückwärtszähler werden positive und negative Wertänderungen aufsummiert.
Genauere Einstellungen können an der Variable über die Zählereinstellungen vorgenommen werden.
-
Step duration
Gibt an, wie lange die Variable einen Wert hat und damit nicht gleich 0 (NULL) ist.
Zeit, die die Variable aktiv Werte liefert.
-
Timer
Gibt die Zeit zurück, während der ein Wert nicht "falsch" war (FALSE, NULL oder leerer String).
-
Time weighted average
Gibt den zeitgewichteten Durchschnitt numerischer Werte für den Berechnungszeitraum zurück.
Die Werte haben unterschiedliche Gewichtungen, je nachdem, seit wann sie vorhanden sind. Je länger ein Wert vorhanden war, desto stärker wird er gewichtet.
-
Standard deviation
Gibt die Standardabweichung numerischer Werte innerhalb des Berechnungszeitraums zurück.
-
Variance
Gibt die Varianz numerischer Werte innerhalb des Berechnungszeitraums zurück.
-
ValueChanges
Gibt den aktualisierten Wert an, wenn er sich verändert hat
-
Gantt
Gibt an, wie lange ein Wert gültig war, z. B. wie lange eine Maschine in einem bestimmten Zustand war.
-
EnergyToPower
Ein Verbrauchswert wird in Leistung umgerechnet.
Diese Aggregationsfunktion kann nur im Zusammenhang mit der Erfassungskategorie Verbrauchswert (Energy) und Counter ausgewählt werden.
-
PowerToEnergy
Leistung wird in einen Verbrauchswert umgerechnet.
Diese Aggregationsfunktion kann nur im Zusammenhang mit der Erfassungskategorie Leistungswert (Power) ausgewählt werden.
-
AmountToFlow
Ein Mengenwert (pro Stunde) wird direkt in einen Durchflusswert umgerechnet.
Diese Aggregationsfunktion kann nur im Zusammenhang mit der Erfassungskategorie Mengenwert (Amount) und Counter ausgewählt werden.
-
FlowToAmount
Ein Durchflusswert (Menge/h) wird in einen Mengenwert umgerechnet.
Die Funktion errechnet einen Schätzwert für den bevorstehenden Zeitraum auf Basis des aktuellen Durchflusswerts.
Diese Aggregationsfunktion kann nur im Zusammenhang mit der Erfassungskategorie Durchflusswert (Flow) ausgewählt werden.