Event-aggregator: Unterschied zwischen den Versionen

Version vom 8. März 2018, 14:51 Uhr

	An dieser Seite wird momentan noch gearbeitet.

Mit dem Attribut event-aggregator können (zeitlich gewichtete) Durchschnittswerte berechnet werden.

Syntax

Das event-aggregator Attribut wird in der folgenden Weise spezifiziert:

attr <device> event-aggregator reading:interval:method:function:holdTime

Die einzelnen Teile haben folgende Bedeutung:

reading

Das zu bearbeitende Reading des aktuellen Gerätes. Wichtig zu bedenken: es kann immer nur einen event-aggregator pro Reading geben. Will man daher mehrere Werte (z.B. min, max, avg), muss man das Reading erst duplizieren (z.B. mit userReadings oder notify). Kann als regulärer Ausdruck angegeben werden (bsp. .*_rain.*)

interval

Updates des <readings> werden ignoriert, Events werden für mindestens <interval> Sekunden unterdrückt.

Nach der blackout-periode wird das reading mit einem Wert upgedated, der sich aus den Werten und Zeitstempeln der vorher ignorierten Updates zusammensetzt.

method

betrifft die Gewichtung nach Zeitintervallen

none: keine zeitliche Gewichtung
const: Annahme, dass zwischen den zwei Messpunkten keine Veränderung stattgefunden hat
linear: Annahme, dass der Wert sich zwischen zwei Messpunkten linear verändert hat.

function

count Anzahl
min Minimum
max Maximum
mean artihmetischer Mittelwert
sd Standardabweichung
integral Summe (falls holdTime nicht angegeben) oder Integral für den Zeitraum holdTime
median Median (nur für method none und gesetzte holdTime)

holdTime

Zeitfenster in Sekunden, für die die vergangenen Werte gehalten werden, um die Aggregatfunktion zu berechnen.

Wechselwirkungen

- keine bekannt -

Beispiele

aus der commandref/Event-aggregator

attr myPowerMeter event-aggregator EP_POWER_METER:300:linear:mean,EP_ENERGY_METER:300:none:v attr myBadSensor event-aggregator TEMP::none:median:300 attr mySunMeter event-aggregator SUN_INTENSITY_24H::const:integral:86400

Siehe auch

Links

Benutzungstipps (Best Practice) für das Attribut in diesem Forenthread

@@ Zeile 21: / Zeile 21: @@
 === method ===
-todo
+betrifft die Gewichtung nach Zeitintervallen
+* <code>none</code>: keine zeitliche Gewichtung
+* <code>const</code>: Annahme, dass zwischen den zwei Messpunkten keine Veränderung stattgefunden hat
+* <code>linear</code>: Annahme, dass der Wert sich zwischen zwei Messpunkten linear verändert hat.
 === function ===
-todo
+* <code>count</code> Anzahl
+* <code>min</code> Minimum
+* <code>max</code> Maximum
+* <code>mean</code> artihmetischer Mittelwert
+* <code>sd</code> Standardabweichung
+* <code>integral</code> Summe (falls holdTime nicht angegeben) oder Integral für den Zeitraum holdTime
+* <code>median</code> Median (nur für method <code>none</code> und gesetzte holdTime)
 === holdTime ===
-todo
+Zeitfenster in Sekunden, für die die vergangenen Werte gehalten werden, um die Aggregatfunktion zu berechnen.
 == Wechselwirkungen ==