diff --git a/fhem/docs/HOWTO.html b/fhem/docs/HOWTO.html index 1e271be3a..a72884ccb 100644 --- a/fhem/docs/HOWTO.html +++ b/fhem/docs/HOWTO.html @@ -203,17 +203,20 @@ logtype attribute of the corresponding FileLog. Take a look at the available gnuplot files in the "Edit files" section, they contain the corresponding FileLog definition - example.

+ example.
+ Note that the .gplot files are also used if you use SVG output and + not the gnuplot backend!

+ When displaying the plot, you can convert it into a "weblink", which can - in turn have a room attribute, to group more than one Plot together. If + in turn have a room attribute to group more than one Plot together. If the weblink refers to the current logfile, then it will be stored as a CURRENT weblink, and it will always display the most recent log (you do not have to redefine it if the logfile changes due to year/month/date parameters in its name). -

+ The logs can be converted to a plot either with gnuplot (which must be installed and in your PATH), or via the builtin SVG module, in this case your internet browser must support SVG. Firefox, opera and the @@ -221,6 +224,32 @@ it via the Adobe "SVG viewer" plugin. To use SVG graphics, set the plotmode attribute to SVG.

+ In order to look at historic data, you can either convert at the + archive entries to weblink in "plotmode=gnuplot" mode, or use the + "plotmode=gnuplot-scroll" or "plotmode=SVG" modes. In the latter case + you'll get the possibility to zoom or scroll in the plot.

+ + Use the zoom and scroll icons at the top of the page.

+ + The current time scope (day, week, month..) set at the overview + page (containing weblinks) will also be used for graphics you open via + links (current log or archive) - there are no zoom and scroll icons + there.

+ + Note: the gnuplot files must have #FileLog entries in order to be + useable with scrolling, as the filtering happens with the FileLog get + function, see the supplied gnuplot files for an example.

+ + The order of the #FileLog lines need to match the corresponding + 'awk'-(double-)lines!

+ + It make sense to build large logfiles for scrolling in them (year + resolution), or smaller ones if you do not want to use the zoom/scroll + feature. The size of the logfiles will be determined by its wildcard + characters (year/month/week/day), look at the FileLog definition. + Don't forget to enable archiving with the archivedir or archivecmd + attributes.

+ To zoom in the log you have to set plotmode to gnuplot-scroll or SVG. The gnuplot files must have #FileLog entries in order to be useable with scrolling, see the supplied gnuplot files for an example.

@@ -269,9 +298,12 @@ configure a fake logfile with the correct filename and an unused regexp, e.g.
       define messages FileLog /var/log/messages fakelog
+ +
+

Complex structures