Statistics: Unterschied zwischen den Versionen
Topos (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
| Zeile 9: | Zeile 9: | ||
|ModOwner=tupol ({{Link2FU|5432|Forum}}) | |ModOwner=tupol ({{Link2FU|5432|Forum}}) | ||
}} | }} | ||
Das Modul statistics ist zur Erzeugung von diversen Statistiken gedacht. Es muss nur einmal definiert werden und kann mithilfe von Regexp auf beliebig viele Devices angewendet werden. Die Ergebnisse dieser Statistiken werden nicht im Modul selbst dargestellt, sondern den jeweiligen Devices als zusätzliches Reading hinzugefügt. | |||
== define == | |||
Bei der Definition werden die gewünschten Geräte angegeben, von denen das Modul statistiken bilden soll. | |||
<nowiki>define myStatDevice statistics Wetterstation|Stromzaehler|Thermometer_.* </nowiki> | |||
Optional ist noch die Angabe eines Prefixes möglich, wenn man nicht möchte, dass die Reading stat<ReadingName> heissen. | |||
== Attribute == | |||
Die Attribute sind soweit gut in der Commandref dokumentiert. | |||
=== singularReadings === | |||
Bei Verwendung von singularReadings ist darauf zu achten, dass für das entsprechende Device die entsprechende Statistik entweder durch die standardmäßig vorgegebenen Gerätewerte oder durch durationReadings,deltaReadings,minAvgMaxReadings oder tendencyReadings definiert ist. Anderenfalls werden die singularReadings weder angelegt, noch mit Daten gefüllt. | |||
Um vom Reading Stromzaehler:total_energy singularReadings anzulegen, muss folgendes definiert werden. Dabei ist darauf zu achten, dass bei singularReadings an keiner Stelle ein Leerzeichen steht: | |||
<nowiki>attr myStatDevice deltaReadings total_energy | |||
attr myStatDevice singularReadings Stromzaehler:total_energy:Delta:Hour|Stromzaehler:total_energy:Delta:Day|Stromzaehler:total_energy:Delta:Month|Stromzaehler:total_energy:Delta:Year</nowiki> | |||
=== ignoreDefaultAssignments | |||
Mit diesem Attribut kann die Erkennung und Verwendung der standardmäßig eingebauten Readings unterdrückt werden. Zur Funktion ist es in diesem Fall notwendig, selbst Readings zu definieren. | |||
== FAQ == | |||
Durch das Modul erzeugte Readings können durch den fhem-Befehl | Durch das Modul erzeugte Readings können durch den fhem-Befehl | ||
| Zeile 14: | Zeile 39: | ||
wieder entfernt werden. | wieder entfernt werden. | ||
monitoredDevicesUnsupported | monitoredDevicesUnsupported zeigt die Devices, in denen die bei statistics vordefinierten Readings nicht auftauchen. In diesem Fall müssen die entsprechenden Readings per durationReadings,deltaReadings oder minAvgMaxReadings angelegt werden. | ||
Version vom 2. November 2016, 17:48 Uhr
| statistics | |
|---|---|
| Zweck / Funktion | |
| xxx | |
| Allgemein | |
| Typ | Hilfsmodul |
| Details | |
| Dokumentation | EN / DE |
| Support (Forum) | Unterstützende Dienste |
| Modulname | 98_statistics.pm |
| Ersteller | tupol (Forum ) |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
Das Modul statistics ist zur Erzeugung von diversen Statistiken gedacht. Es muss nur einmal definiert werden und kann mithilfe von Regexp auf beliebig viele Devices angewendet werden. Die Ergebnisse dieser Statistiken werden nicht im Modul selbst dargestellt, sondern den jeweiligen Devices als zusätzliches Reading hinzugefügt.
define
Bei der Definition werden die gewünschten Geräte angegeben, von denen das Modul statistiken bilden soll.
define myStatDevice statistics Wetterstation|Stromzaehler|Thermometer_.*
Optional ist noch die Angabe eines Prefixes möglich, wenn man nicht möchte, dass die Reading stat<ReadingName> heissen.
Attribute
Die Attribute sind soweit gut in der Commandref dokumentiert.
singularReadings
Bei Verwendung von singularReadings ist darauf zu achten, dass für das entsprechende Device die entsprechende Statistik entweder durch die standardmäßig vorgegebenen Gerätewerte oder durch durationReadings,deltaReadings,minAvgMaxReadings oder tendencyReadings definiert ist. Anderenfalls werden die singularReadings weder angelegt, noch mit Daten gefüllt. Um vom Reading Stromzaehler:total_energy singularReadings anzulegen, muss folgendes definiert werden. Dabei ist darauf zu achten, dass bei singularReadings an keiner Stelle ein Leerzeichen steht:
attr myStatDevice deltaReadings total_energy attr myStatDevice singularReadings Stromzaehler:total_energy:Delta:Hour|Stromzaehler:total_energy:Delta:Day|Stromzaehler:total_energy:Delta:Month|Stromzaehler:total_energy:Delta:Year
=== ignoreDefaultAssignments Mit diesem Attribut kann die Erkennung und Verwendung der standardmäßig eingebauten Readings unterdrückt werden. Zur Funktion ist es in diesem Fall notwendig, selbst Readings zu definieren.
FAQ
Durch das Modul erzeugte Readings können durch den fhem-Befehl
deleteReading <device> <reading>
wieder entfernt werden.
monitoredDevicesUnsupported zeigt die Devices, in denen die bei statistics vordefinierten Readings nicht auftauchen. In diesem Fall müssen die entsprechenden Readings per durationReadings,deltaReadings oder minAvgMaxReadings angelegt werden.