Plots erzeugen
Plots erzeugen
.gplot-Editor
Fhem verfügt über einen ".gplot-Editor" (auch als Ploteditor bezeichnet), um die .gplot-Datei zur Erstellung eines Plots menügeführt zu generieren. Ein manuelles Anlegen der .gplot-Datei ist für Spezialisten und normalerweise nicht notwendig. Der .gplot-Editor sollte für Standardfälle grundsätzlich verwendet werden.
Details zum .gplot-Editor können im Ankündigungshinweis im Fhem-Forum nachgelesen werden.
Zur Einarbeitung in die Funktionsweise des .gplot-Editor existieren ausführliche, bebilderte Beispiele:
- Grundlegendes Beispiel zur Erzeugung von Plots:
- Spezielle Erläuterungen zur Erzeugung von Plots mit Stati:
Verhinderung von Perl-Warnungen bei LogFiles mit unterschiedlicher Spaltenanzahl in Log-Zeilen: Thema
Achtung:
Verwenden Sie diesen Editor nicht, wenn das Fhem-Device bereits angelegt ist und Sie für dieses Device ein bestehendes, allgemeines gplot-File verwenden, das auch für andere Devices benutzt wird. Beim Abspeichern wird ein Filter im gplot-File gesetzt, das das gplot-File nur für genau dieses Device verwendbar macht.
Beispiel:
aus
#FileLog 4:::
wird
#FileLog 4:DS2423.energy_a\x3a::
in dem entsprechenden gplot-File.
Die anderen Devices, die evtl. dieses gplot-File verwenden, haben danach keine funktionierende Plot-Anzeige mehr. Bevor also etwas geändert wird, sollte mit
set weblink_irgendwas copyGplotFile
ein Duplikat angelegt werden, das ausschließlich für diesen Plot verwendet wird. Der Befehl kann unterhalb des ersten Kasten per Dropdown ausgewählt werden.
Individuell / Manuell
Vorbemerkungen:
- Fhem bediente sich früher für die Erstellung der Plots des Programms Gnuplot [1]. Hierbei reichen die "einfacheren" Funktionalitäten dieses Programms aus (Gnuplot kann noch viel mehr).
- aktuelle Fhem-Versionen haben die Plot-Funktionen (angelehnt an die Plot-File-Syntax von Gnuplot) integriert.
- die Beispieldateien für die in Fhem integrierten Plots finden Sie in Ihrem Fhem-Programmordner unter www/gplot.
- Angaben wie <SIZE>, <OUT>, <L1>, <IN> usw. im Plot-File sind Platzhalter bzw. Feldbezeichner für Fhem. Diese sind case-sensitive (Groß-/Kleinschreibung beachten).
- Weitere Möglichkeiten Plots anzupassen und zu ergänzen bietet das Fhem-Hilfsmodul logProxy.
Ein Beispiel (temp4hum4.gplot) aus diesem Verzeichnis:
# Attribute 'small' is useful for gnuplot/-scroll only,
# if plotsize is less than 800,400
#set terminal png transparent small size <SIZE> crop
set terminal png transparent size <SIZE> crop
set output '<OUT>.png'
set xdata time
set timefmt "%Y-%m-%d_%H:%M:%S"
set xlabel " "
set ytics nomirror
set y2tics
#set ytics
set title '<L1>'
set grid xtics y2tics
set y2label "Temperature in C"
set ylabel "Humidity (%)"
#FileLog 4:temperature:10:
#FileLog 4:humidity:50:
plot \
"< egrep 'temperature' <IN>"\
using 1:4 axes x1y2 title 'Measured temperature' with lines,\
"< egrep 'humidity' <IN>"\
using 1:4 axes x1y1 title 'Humidity (%)' with lines\
Die Zeilen, die mit set beginnen, beeinflussen wesentlich das Erscheinungsbild und Aussehen Ihrer Plots (Achsenbeschriftungen, Skalen usw.). Dabei sollten Sie die Zeilen, die eine Angabe zwischen "<" und ">" enthalten, zunächst unverändert lassen. Weitere (ausführliche) Hinweise (zu Gnuplot!) finden Sie in einer PDF-Datei. Eingeschränktere, aber für die meisten Belange von Fhem ausreichende Infos finden Sie auf dieser Web-Seite.
Benutzung der Variablen
| Variable | Nutzung in gplot-File | Füllung mit inhalt in fhem.cfg |
|---|---|---|
| <TL> | set title '<TL>' | attr weblink title "Dies füllt den Platzhalter <TL>" |
| <L1> | set xlabel '<L1>' | attr weblink label "Dies füllt das Label <L1>" |
| <L2> | set title '<L2>' | attr weblink label "Dies füllt das Label <L1>"::"Dies füllt das Label <L2>" |
Welche Daten werden dargestellt
Die Zeilen
#FileLog 5::0: #FileLog 14::0:
in einer gplot-Datei tragen zwar zu Beginn das Kommentarzeichen "#", jedoch handelt es sich durchaus nicht um solche. Vielmehr trifft man mit den Werten hinter FileLog Vorgaben, welche Werte wie von Fhem an gnuplot zwecks grafischer Darstellung übergeben werden.
Im o.a. Beispiel werden das 5. und das 14. Wertfeld (voneinander getrennt durch ein Leerzeichen (Blank)) an gnuplot weiter gegeben.
Eine dazu passende Log-Dateizeile könnte beispielsweise so aussehen
2013-11-14_17:32:00 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200
----1. Feld-------- --2. Feld-- --3.---- -4.- -5. -6. 7. 8. -9. 10. 11 12 --13.- --14.---
^ ^
werden ausgewertet --| --|
Diese Parameter können auch als Attribut übergeben werden:
attr weblink plotfunction "FileLog 5::0:"
Anhand der Anmerkungen wird hoffentlich die Wirkungsweise deutlich. Zu den restlichen - optionalen - Parametern hinter FileLog wird zunächst auf die commandref verwiesen.
Datum und Zeit
Anmerkungen / Hinweise:
Fhem erwartet das Datum und die Uhrzeit der Log-Dateieinträge zwingend an erster Stelle der Datenzeile und zwar im Format
JJJJ-MM-TT_SS:mm:ss
wobei
- JJJJ die 4-stellige Jahreszahl
- MM der 2-stellige Monat (ggfls. mit Vornull)
- TT der 2-stellige Tag (ggfls. mit Vornull)
- SS die 2-stellige Stunde (ggfls. mit Vornull)
- mm die 2-stellige Minute (ggfls. mit Vornull)
- ss die 2-stellige Sekunde (ggfls. mit Vornull)
bedeutet. Bitte beachten Sie auch die Stelle der Zeichen "-", "_" und ":". Stehen diese nicht an den angegebenen Stellen, wird die entsprechende Zeile beim Erzeugen des Plots nicht beachtet. Ggfls. wird gar kein Plot angezeigt.
Eine Änderung/Anpassung der *.gplot-Datei in der Zeile
set timefmt "..."
hat auf dieses Verhalten von Fhem keine Auswirkungen, sondern nur auf die Darstellung von Datum und Zeit durch Gnuplot .
Dazu ein Beispiel:
Mit
2013-11-14_17:32:00 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200
kann Fhem etwas anfangen. Mit
20131114173200 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200
oder
14.11.2013 17:32 2013-Nov-14 17:32:00 17.9 5.8 4.9 58 94 0.0 0.0 N 5.8 572.91 1015.200
dagegen nicht.
Im ersten Fehler-Beispiel fehlen die notwendigen Trennzeichen, im zweiten Fehler-Beispiel ist die Reihenfolge im Datum verkehrt, außerdem werden die falschen Trenner verwendet. Zudem fehlen die Sekunden.
Plot der letzten 24 Stunden statt des aktuellen Tages
Hierzu kann man in der Fhem.cfg für die Einträge
define WEB FHEMWEB 8083 global
das Attribut
attr WEB endPlotNow 1
setzen. Gleiches geht auch für WEBphone und WEBtablet. Da muss es dann lauten
attr WEBphone endPlotNow 1
bzw.
attr WEBtablet endPlotNow 1
Das Attribut gilt dann aber für alle Plots der jeweiligen Ansichten. Wenn man wieder zurück zu den Plots ab jeweils 00:00 Uhr des aktuellen Tages möchte, löscht man dieses Attribut wieder bzw. setzt es auf den Wert "0".
Legende links platzieren
Gerade im Verbund mit dem Attribut endPlotNow macht das seit dem 11.01.2015 neue Attribut captionLeft Sinn, da dann die Legende nicht mehr rechts oben, sondern links oben im Plot erscheint. Dadurch wird die Sichtbarkeit der aktuellen Werte verbessert.
Links / Beispiele
Hier finden sich weitere Beispiele zur Plot-Erstellung: