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.