Durchschnitt (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-Schwellen-wert | 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 |