From e1ccdf1f95a2f64aac4b125b4840c7259ee8820d Mon Sep 17 00:00:00 2001
From: rudolfkoenig <>
Date: Wed, 19 Feb 2014 20:34:02 +0000
Subject: [PATCH] SVG: german doc by Eberhard
git-svn-id: https://svn.fhem.de/fhem/trunk@4993 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
fhem/FHEM/98_SVG.pm | 206 +++++++++++++++++++++++++++++++++++++++++++-
1 file changed, 203 insertions(+), 3 deletions(-)
diff --git a/fhem/FHEM/98_SVG.pm b/fhem/FHEM/98_SVG.pm
index 32670a051..75f551f11 100755
--- a/fhem/FHEM/98_SVG.pm
+++ b/fhem/FHEM/98_SVG.pm
@@ -1774,9 +1774,9 @@ plotAsPng(@)
if you want to omit the title for a Diagram label, enter notitle in the
input field.
if you want to specify a fixed value (not taken from a column) if a
- string found (e.g. 1 of the FS20 switch is on 0 if it off), then you have
- to specify the Tics first, and write the .gplot file, before you can
- select this value from the dropdown.
+ string found (e.g. 1 if the FS20 switch is on and 0 if it is off), then
+ you have to specify the Tics first, and write the .gplot file, before you
+ can select this value from the dropdown.
Example:
Enter in the Tics field: ("On" 1, "Off" 0)
@@ -1790,4 +1790,204 @@ plotAsPng(@)
=end html
+
+=begin html_DE
+
+
+SVG
+
+
+ Define
+
+ define <name> SVG <logDevice>:<gplotfile>:<logfile>
+
+ Dies ist das Zeichenmodul von FHEMWEB, mit dem Vektorgrafiken (SVG) erzeugt
+ werden.
+ Beispiel:
+
+ define MyPlot SVG inlog:temp4hum4:CURRENT
+
+
+
+ Hinweise:
+
+ - Normalerweise müssen SVG-Geräte nicht manuell erzeugt
+ werden, da FHEMWEB es für den Nutzer einfach macht: man muss in
+ der Detailansicht eines FileLogs wechseln und auf "Create SVG instance"
+ klicken.
+
+ - CURRENT als <logfile> wird immer das aktuelle Logfile
+ benutzen, selbst dann, wenn der Name des Logfiles sich
+ regelmäßig ändert.
+
+ - Aus historischen Gründen benötigt jede SVG-Instanz eine
+ sog. .gplot Datei, die auch als Input für das gnuplot Programm
+ verwendet werden kann. Einige besondere Zeilen (welche mit #FileLog
+ oder #DbLog beginnen) werden zusätzlich benutzt, diese werden von
+ gnuplot als Kommentar betrachtet. Auf der anderen Seite implementiert
+ dieses Modul nicht alle gnuplot-Attribute.
+
+
+
+
+
+
+ Set
+
+ - copyGplotFile
+ Kopiert die aktuell ausgewählte .gplot Datei in eine neue Datei, die
+ den Namen der SVG Instanz trägt; bereits bestehende Dateien mit
+ gleichem Namen werden überschrieben. Diese Vorgehensweise ist
+ notwendig, wenn man den Ploteditor benutzt. Erzeugt man aus der
+ Detailansicht des FileLogs die SVG Instanz, wird eine eindeutige
+ .gplot-Datei erzeugt. In diesem Fall ist dieses Befehl nicht
+ erforderlich.
+
+
+
+
+ Get
+
+
+ Attribute
+
+
+ - fixedrange [offset]
+ Version 1
+ Enthält zwei Zeit-Spezifikationen in der Schreibweise YYYY-MM-DD,
+ getrennt durch ein Leerzeichen. Im Plotmodus gnuplot-Scroll oder SVG wird
+ das vorgegebene Intervall verwendet und ein Scrolling der Zeitachse ist
+ nicht möglich. Dies wird z.B. verwendet, um sich die Daten des
+ vergangenen Jahres ohne Scrollen anzusehen.
+
+ Version 2
+ Wenn der Wert entweder Tag, <N>Tage, Woche, Monat oder Jahr lautet,
+ kann der Zoom-Level für dieses SVG unabhängig vom
+ User-spezifischen Zoom eingestellt werden. Diese Einstellung ist
+ nützlich für mehrere Plots auf einer Seite: Eine Grafik ist mit
+ dem Standard-Zoom am aussagekräftigsten, die anderen mit einem Zoom
+ über eine Woche.
+ Der optionale ganzzahlige Parameter [offset] setzt ein anderes
+ Zeitintervall (z.B. letztes Jahr: fixedrange year -1,
+ vorgestern: fixedrange day -2).
+
+
+
+ - fixedoffset <nTage>
+ Verschiebt den Plot-Offset um einen festen Wert (in Tagen).
+
+
+
+ - startDate
+ Setzt das Startdatum für den Plot. Wird für Demo-Installationen
+ verwendet.
+
+
+ - plotsize
+
+ - plotmode
+
+
+ - label
+ Eine Liste, bei der die einzelnen Werte mit einem zweifachen Doppelpunkt
+ voneinander getrennt werden. Diese Liste wird verwendet um die <L#>
+ Zeichenfolgen in der .gplot-Datei zu ersetzen. Dabei steht das # für
+ eine laufende Ziffer beginnend mit 1 (<L1>, <L2>, usw.).
+ Jeder Wert wird als Perl-Ausdruck bewertet, deshalb hat man Zugriff z.B.
+ auf die hinterlegten Funktionen.
+
+ Egal, ob es sich bei der Plotart um gnuplot-scroll oder SVG handelt, es
+ können ebenfalls die Werte der individuellen Kurve für min,
+ max, avg, cnt, sum, currval (letzter Wert) und currdate (letztes Datum)
+ durch Zugriff der entsprechenden Werte über das DataHash verwendet
+ werden. Siehe untenstehendes Beispiel:
+
+ - Beschriftunng der rechten und linken y-Achse:
+
+ - Fhem config:
+ attr wl_1 label "Temperature"::"Humidity"
+ - Eintrag in der .gplot-Datei:
+ set ylabel <L1>
+ set y2label <L2>
+
+
+ - Überschrift aus Maximum und dem letzten Wert der ersten
+ Kurve(FileLog)
+
+ - Fhem config:
+ attr wl_1 label "Max $data{max1}, Current $data{currval1}"
+ - Eintrag in der .gplot-Datei:
+ set title <L1>
+
+
+
+
+
+
+ - title
+ Eine besondere Form der Überschrift (siehe oben), bei der die
+ Zeichenfolge <TL> in der .gplot-Datei ersetzt wird.
+ Standardmäßig wird als <TL> der Dateiname des Logfiles
+ eingesetzt.
+
+
+
+ - plotfunction
+ Eine Liste, deren Werte durch Leerzeichen voneinander getrennt sind.
+ Diese Liste wird verwendet um die <SPEC#> Zeichenfolgen in der
+ .gplot-Datei zu ersetzen. Dabei steht das # für eine laufende Ziffer
+ beginnend mit 1 (<SPEC1>, <SPEC2>, usw.) in der #FileLog oder
+ #DBLog Anweisung. Mit diesem Attrbute ist es möglich eine
+ .gplot-Datei für mehrere Geräte mit einem einzigen logdevice zu
+ verwenden.
+
+ Beispiel:
+ - #FileLog <SPEC1>
+ mit:
+ attr <SVGdevice> plotfunction "4:IR\x3a:0:"
+ anstelle von:
+ #FileLog 4:IR\x3a:0:
+
+ - #DbLog <SPEC1>
+ mit:
+ attr <SVGdevice> plotfunction "Garage_Raumtemp:temperature::"
+ anstelle von:
+ #DbLog Garage_Raumtemp:temperature::
+
+
+
+
+
+
+
+ Plot-Editor
+
+ Dieser Editor ist in der Detailansicht der SVG-Instanz zu sehen. Die
+ meisten Features sind hier einleuchtend und bekannt, es gibt aber auch
+ einige Ausnahmen:
+ - wenn für ein Diagramm die Überschrift unterdrückt werden
+ soll, muss im Eingabefeld
notitle eingetragen werden.
+
+
+ - wenn ein fester Wert (nicht aus einer Wertespalte) definiert werden
+ soll, für den Fall, das eine Zeichenfoge gefunden wurde (z.B. 1
+ für eine FS20 Schalter, der AN ist und 0 für den AUS-Zustand),
+ muss zuerst das Tics-Feld gefüllt, und die .gplot-Datei
+ gespeichert werden, bevor der Wert über die Dropdownliste erreichbar
+ ist.
+
Beispiel:
+ Eingabe im Tics-Feld: ("On" 1, "Off" 0)
+ .gplot-Datei speichern
+ "1" als Regexp switch.on und "0" für den Regexp switch.off vom
+ Spalten-Dropdown auswählen (auf die Gänsefüßchen
+ achten!).
+ .gplot-Datei erneut speichern
+
+
+
+
+
+
+=end html_DE
+
=cut