Analytics Builder 10.9.0 | Bedienungsanleitung für Analytics Builder for Cumulocity IoT | Blockreferenz | Aggregat | Durch­schnitt (Mittelwert)
 
Durch­schnitt (Mittelwert)
apama.analyticskit.blocks.core.Mean
Berechnet den Mittelwert der Werte im Laufe der Zeit.
Dieser Block ist für kontinuierliche Werte geeignet, auch wenn diese unregelmäßig abgetastet werden. Die Zeit zwischen den Eingaben oder Proben ist von Bedeutung, die Anzahl der Proben hingegen nicht. Verwenden Sie diesen Block z. B., wenn es sich bei der Eingabe um eine physikalische Eigenschaft, wie etwa die Temperatur, handelt, die entweder regelmäßig oder unregelmäßig abgetastet wird (z. B. Erzeugung von Messwerten lediglich bei einer Temperaturänderung). Verwenden Sie den Block "Diskrete Statistik" anstelle des Blocks "Durchschnitt (Mittelwert)" für unabhängige Messungen, wie etwa Ticketverkäufe, bei denen die Anzahl der Messungen von Bedeutung ist, die Zeit zwischen den Messungen jedoch nicht.
Der Mittelwert ist definiert als die Summe der Eingabewerte multipliziert mit der Zeitdauer, die die Eingabe diesen Wert innerhalb eines optionalen Zeitfensters hatte, dividiert durch die Fensterdauer oder die Zeit seit der Block gestartet oder zurückgesetzt wurde (je nachdem, welche kleiner ist).
Der Block kann über ein zeitgebundenes Fenster wirken, das im Parameter "Fensterdauer" bestimmt wird. Wenn dieser Parameter nicht angegeben ist, wird ein nicht zeitgebundenes Fenster verwendet. Beim Zurücksetzen wird der Inhalt des Fensters gelöscht. Ausgabe wird erzeugt bei neuen Eingaben oder, wenn der Parameter für den Ausgabeschwellenwert gesetzt ist, nur wenn sich die Ausgabe um mehr als den angegebenen Schwellenwert ändert (dazu zählt auch, wenn keine weitere Eingabe erfolgt oder sich der Wert nur ändert, weil ältere Einträge verfallen). Der Probe-Eingangsport kann verwendet werden, um eine Neubewertung zu erzwingen und den aktuellen Wert zu erzeugen.
Weitere Informationen sowie ein Beispiel zur Ausgabehäufigkeit aus diesem Block und zum Verhalten der Werte in Fenstern finden Sie im Kapitel "Wertetypen" der Dokumentation zu Analytics Builder.
Wenn ein Fenster konfiguriert wird, verwendet der Block einen Satz von 20 Containern, sodass der abgelaufene Wert ungefähr dem Durchschnittswert eines Containers entspricht.
Hinweis: Der Block "Durchschnitt (Mittelwert)" erzeugt den Mittelwert für ein einzelnes Gerät. Wenn die Eingabe von einer Gerätegruppe stammt, werden diese Werte für jedes Gerät in dieser Gruppe einzeln erzeugt. Um aggregierte Werte für die Gruppe als Ganzes (nicht für einzelne Geräte) zu berechnen und zu erzeugen, verwenden Sie den Block "Gruppenstatistik".
Parameter
Name
Beschreibung
Typ
Hinweise
Fensterdauer (Sek.)
Wenn vorhanden, die Zeitdauer (in Sekunden), für die Werte im Fenster bleiben sollen.
Dies muss eine endliche und positive Zahl sein.
float
Optional
Ausgabe-Schwellenwert
Wenn vorhanden, die zu sendende Ausgabe, wenn sie sich um mindestens diesen Wert ändert.
Dies muss eine endliche und positive Zahl sein.
float
Optional
Details zum Eingangsport
Name
Beschreibung
Typ
Wert
Eingabe, für die der Mittelwert berechnet werden soll.
float
Zurücksetzen
Löscht den Inhalt des Fensters.
pulse
Probe
Erzwingt die Neubewertung des aktuellen Mittelwertes und sendet den Ausgabewert.
pulse
Details zum Ausgangsport
Name
Beschreibung
Typ
Durchschnitt
Die Summe des Wertes multipliziert mit der Dauer, wie lange dieser Wert beibehalten wird, dividiert durch die Gesamtzeit.
float