mirror of
https://github.com/fhem/fhem-mirror.git
synced 2025-04-09 01:34:19 +00:00
SVG: german doc by Eberhard
git-svn-id: https://svn.fhem.de/fhem/trunk@4993 2b470e98-0d58-463d-a4d8-8e2adae1ed80
This commit is contained in:
rudolfkoenig
parent
d5f3f62b98
commit
e1ccdf1f95
@ -1774,9 +1774,9 @@ plotAsPng(@)
|
||||
<li>if you want to omit the title for a Diagram label, enter notitle in the
|
||||
input field.</li>
|
||||
<li>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.<br>
|
||||
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.<br>
|
||||
Example:
|
||||
<ul>
|
||||
Enter in the Tics field: ("On" 1, "Off" 0)<br>
|
||||
@ -1790,4 +1790,204 @@ plotAsPng(@)
|
||||
</ul>
|
||||
|
||||
=end html
|
||||
|
||||
=begin html_DE
|
||||
|
||||
<a name="SVG"></a>
|
||||
<h3>SVG</h3>
|
||||
<ul>
|
||||
<a name="SVGlinkdefine"></a>
|
||||
<b>Define</b>
|
||||
<ul>
|
||||
<code>define <name> SVG <logDevice>:<gplotfile>:<logfile></code>
|
||||
<br><br>
|
||||
Dies ist das Zeichenmodul von FHEMWEB, mit dem Vektorgrafiken (SVG) erzeugt
|
||||
werden. <br><br>
|
||||
Beispiel:
|
||||
<ul>
|
||||
<code>define MyPlot SVG inlog:temp4hum4:CURRENT</code><br>
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
Hinweise:
|
||||
<ul>
|
||||
<li>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.</li>
|
||||
|
||||
<li>CURRENT als <logfile> wird immer das aktuelle Logfile
|
||||
benutzen, selbst dann, wenn der Name des Logfiles sich
|
||||
regelmäßig ändert. </li>
|
||||
|
||||
<li>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.</li>
|
||||
|
||||
</ul>
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
<a name="SVGset"></a>
|
||||
<b>Set</b>
|
||||
<ul>
|
||||
<li>copyGplotFile<br>
|
||||
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.</li>
|
||||
|
||||
</ul><br>
|
||||
|
||||
<a name="SVGget"></a>
|
||||
<b>Get</b> <ul>N/A</ul><br>
|
||||
|
||||
<a name="SVGattr"></a>
|
||||
<b>Attribute</b>
|
||||
<ul>
|
||||
<a name="fixedrange"></a>
|
||||
<li>fixedrange [offset]<br>
|
||||
Version 1<br>
|
||||
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.<br><br>
|
||||
|
||||
Version 2<br>
|
||||
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: <code> fixedrange year -1</code>,
|
||||
vorgestern: <code> fixedrange day -2</code>).
|
||||
</li><br>
|
||||
|
||||
<a name="fixedoffset"></a>
|
||||
<li>fixedoffset <nTage><br>
|
||||
Verschiebt den Plot-Offset um einen festen Wert (in Tagen).
|
||||
</li><br>
|
||||
|
||||
<a name="startDate"></a>
|
||||
<li>startDate<br>
|
||||
Setzt das Startdatum für den Plot. Wird für Demo-Installationen
|
||||
verwendet.
|
||||
</li><br>
|
||||
|
||||
<li><a href="#plotsize">plotsize</a></li><br>
|
||||
|
||||
<li><a href="#plotmode">plotmode</a></li><br>
|
||||
|
||||
<a name="label"></a>
|
||||
<li>label<br>
|
||||
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. <br><br>
|
||||
|
||||
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:<br>
|
||||
<ul>
|
||||
<li>Beschriftunng der rechten und linken y-Achse:<br>
|
||||
<ul>
|
||||
<li>Fhem config:<br>
|
||||
<code>attr wl_1 label "Temperature"::"Humidity"</code></li>
|
||||
<li>Eintrag in der .gplot-Datei:<br>
|
||||
<code>set ylabel <L1><br>
|
||||
set y2label <L2></code></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li>Überschrift aus Maximum und dem letzten Wert der ersten
|
||||
Kurve(FileLog)
|
||||
<ul>
|
||||
<li>Fhem config:<br>
|
||||
<code>attr wl_1 label "Max $data{max1}, Current $data{currval1}"</code></li>
|
||||
<li>Eintrag in der .gplot-Datei:<br>
|
||||
<code>set title <L1></code><br></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
|
||||
<a name="title"></a>
|
||||
<li>title<br>
|
||||
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.
|
||||
</li><br>
|
||||
|
||||
<a name="plotfunction"></a>
|
||||
<li>plotfunction<br>
|
||||
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. <br><br>
|
||||
|
||||
<ul><b>Beispiel:</b><br>
|
||||
<li>#FileLog <SPEC1><br>
|
||||
mit:<br>
|
||||
<code>attr <SVGdevice> plotfunction "4:IR\x3a:0:"</code><br>
|
||||
anstelle von:<br>
|
||||
<code>#FileLog 4:IR\x3a:0:</code>
|
||||
</li>
|
||||
<li>#DbLog <SPEC1><br>
|
||||
mit:<br>
|
||||
<code>attr <SVGdevice> plotfunction "Garage_Raumtemp:temperature::"</code><br>
|
||||
anstelle von:<br>
|
||||
<code>#DbLog Garage_Raumtemp:temperature::</code>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
|
||||
<a name="plotEditor"></a>
|
||||
<b>Plot-Editor</b>
|
||||
<ul>
|
||||
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:
|
||||
<li>wenn für ein Diagramm die Überschrift unterdrückt werden
|
||||
soll, muss im Eingabefeld <code>notitle</code> eingetragen werden.
|
||||
</li>
|
||||
|
||||
<li>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.
|
||||
<ul><b>Beispiel:</b><br>
|
||||
Eingabe im Tics-Feld: ("On" 1, "Off" 0)<br>
|
||||
.gplot-Datei speichern<br>
|
||||
"1" als Regexp switch.on und "0" für den Regexp switch.off vom
|
||||
Spalten-Dropdown auswählen (auf die Gänsefüßchen
|
||||
achten!).<br>
|
||||
.gplot-Datei erneut speichern<br>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
<br>
|
||||
</ul>
|
||||
|
||||
=end html_DE
|
||||
|
||||
=cut
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user