Creating Plots - Versionsgeschichte

Mikezulugolf: /* Placeholders */ changed tiny typo

2022-01-19T10:19:46Z

Placeholders: changed tiny typo

← Nächstältere Version		Version vom 19. Januar 2022, 12:19 Uhr
Zeile 18:		Zeile 18:
	* Manual creation is also possible and requires a statement like:		* Manual creation is also possible and requires a statement like:
	<nowiki>		<nowiki>
	define FL_KS550 FileLog /var/log/fhem/KS550_%Y.log KS550:T:.*		define FL_KS550 FileLog /var/log/fhem/KS550_%Y.log KS550:T:.*
	define FileLog_ZwSt_1 FileLog /opt/fhem/var/log/ZwSt_1_%Y.log ZwSt_1		define FileLog_ZwSt_1 FileLog /opt/fhem/var/log/ZwSt_1_%Y.log ZwSt_1
	define FL_ZwSt_ALL FileLog /opt/fhem/var/log/ZwSt_ALL_%Y.log ZwSt_.deviceMsg.BidCoS_RF.*		define FL_ZwSt_ALL FileLog /opt/fhem/var/log/ZwSt_ALL_%Y.log ZwSt_.deviceMsg.BidCoS_RF.*
	</nowiki>		</nowiki>
	* Be it manual or automatic: the definition of a FileLog object determines (through the regular expression) which of the output lines of FHEM end up in the logfile		* Be it manual or automatic: the definition of a FileLog object determines (through the regular expression) which of the output lines of FHEM end up in the logfile

Zeile 40:		Zeile 40:
	* <SIZE>: attr plotsize		* <SIZE>: attr plotsize
	* <TL> : attr title. The attribute is eval'ed by perl at runtime, be careful and protect by double quotes if you just want to enter strings. This gives access to all internal FHEM values, though admittedly not straightforward		* <TL> : attr title. The attribute is eval'ed by perl at runtime, be careful and protect by double quotes if you just want to enter strings. This gives access to all internal FHEM values, though admittedly not straightforward
	* <Ln> : attr label. ~~Lables~~ 1-#n can be specified by a double-colon-separated (::) list, see below. This is also eval'ed at runtime, same precautions apply		* <Ln> : attr label. Labels 1-#n can be specified by a double-colon-separated (::) list, see below. This is also eval'ed at runtime, same precautions apply
	* <IN> :		* <IN> :

Zeile 76:		Zeile 76:

	<nowiki>telnet diskstation 7072		<nowiki>telnet diskstation 7072
	get FileLog_KS550 ?		get FileLog_KS550 ?
	get FileLog_KS550 - - 2012-01-01 2012-12-31 4::</nowiki>		get FileLog_KS550 - - 2012-01-01 2012-12-31 4::</nowiki>
	You should get back the data which you have been asking for, followed by a line holding the .gplot argument. Make sure		You should get back the data which you have been asking for, followed by a line holding the .gplot argument. Make sure

Zeile 94:		Zeile 94:

	<nowiki>set terminal size <SIZE>		<nowiki>set terminal size <SIZE>
	set title '<TL>'		set title '<TL>'
	set ylabel '<L1>'		set ylabel '<L1>'
	set y2label '<L2>'		set y2label '<L2>'
	#FileLog 4:::		#FileLog 4:::
	plot \		plot \
	axes x1y1 title '<L3>' with steps lw 2</nowiki>		axes x1y1 title '<L3>' with steps lw 2</nowiki>
	It implements the placeholders which can be defined by the user through the WebLink attributes later, selects just one column, without regular expression matches, defaults or subsequent data operations and plot is as a steps diagram. In fact even the "axes x1y1" statement could be left out, it would still work.		It implements the placeholders which can be defined by the user through the WebLink attributes later, selects just one column, without regular expression matches, defaults or subsequent data operations and plot is as a steps diagram. In fact even the "axes x1y1" statement could be left out, it would still work.

Zeile 107:		Zeile 107:

	<nowiki>text { font-family:Arial, Helvetica, sans-serif; font-size:12px; fill:#xxxxxx;}		<nowiki>text { font-family:Arial, Helvetica, sans-serif; font-size:12px; fill:#xxxxxx;}
	text.title {font-family:Arial, Helvetica, sans-serif; font-size:16px; fill:#xxxxxx;}</nowiki>		text.title {font-family:Arial, Helvetica, sans-serif; font-size:16px; fill:#xxxxxx;}</nowiki>

	where #xxxxxx is the color.		where #xxxxxx is the color.
Zeile 134:		Zeile 134:

	<nowiki>XML Parsing Error: mismatched tag. Expected: </L1>.		<nowiki>XML Parsing Error: mismatched tag. Expected: </L1>.
	...		...
	Line Number 51, Column 95:<text x="12" y="80" text-anchor="middle" class="ylabel" transform="rotate(270,12,80)">'<L1>'</text></nowiki>		Line Number 51, Column 95:<text x="12" y="80" text-anchor="middle" class="ylabel" transform="rotate(270,12,80)">'<L1>'</text></nowiki>
	you can safely ignore it. This is due to the fact, that you are using placeholders in the .gplot definition (which is good, because it favors reuseability) but have not yet defined the corresponding attributes. While annoying, this is not your fault: you can only define attributes once you have a weblink. So click on create weblink and define the attributes you have been using placeholders for. The error message should go away.		you can safely ignore it. This is due to the fact, that you are using placeholders in the .gplot definition (which is good, because it favors reuseability) but have not yet defined the corresponding attributes. While annoying, this is not your fault: you can only define attributes once you have a weblink. So click on create weblink and define the attributes you have been using placeholders for. The error message should go away.

Zeile 155:		Zeile 155:
	* Be careful when specifying the regular expression which filters the lines for a given logfile. While often it is sufficient to not specify a specific one at all, consider the following case from the Homematic world, where one action results in 4 lines of FHEM output. The switch communicates not only with the CCU, but also with the remote control, issuing 2 lines for each action:		* Be careful when specifying the regular expression which filters the lines for a given logfile. While often it is sufficient to not specify a specific one at all, consider the following case from the Homematic world, where one action results in 4 lines of FHEM output. The switch communicates not only with the CCU, but also with the remote control, issuing 2 lines for each action:
	<nowiki>2012-01-01_07:40:23 ZwSt_3 deviceMsg: on (to Dev.WDisp.Kueche)		<nowiki>2012-01-01_07:40:23 ZwSt_3 deviceMsg: on (to Dev.WDisp.Kueche)
	2012-01-01_07:40:23 ZwSt_3 on		2012-01-01_07:40:23 ZwSt_3 on
	2012-01-01_07:40:26 ZwSt_3 deviceMsg: on (to BidCoS_RF)		2012-01-01_07:40:26 ZwSt_3 deviceMsg: on (to BidCoS_RF)
	2012-01-01_07:40:26 ZwSt_3 on</nowiki>		2012-01-01_07:40:26 ZwSt_3 on</nowiki>
	* Why one needs to specify a logtype (which is nothing else than a plot definition) for the FileLog has always been a mystery to me. It holds no useful information to the object itself and does not influence the way data is written to the associated logfile. Sure, plots need FileLogs, but not the other way round. And since the WebLink contains (again) the name of the plot definition file, the need to define the logtype attribute seems odd. The master himself says regarding this topic: "Ist eine Eigenschaft, die beschreibt, auf welche Art die Daten angezeigt werden koennen. Steht damit direkt neben den Daten, also da wo ich zuerst suchen wuerde. Ist nicht notwendig, aber so kann FHEMWEB ein 'create weblink' anbieten." I have to admit that this link is useful and I use to use it :-)		* Why one needs to specify a logtype (which is nothing else than a plot definition) for the FileLog has always been a mystery to me. It holds no useful information to the object itself and does not influence the way data is written to the associated logfile. Sure, plots need FileLogs, but not the other way round. And since the WebLink contains (again) the name of the plot definition file, the need to define the logtype attribute seems odd. The master himself says regarding this topic: "Ist eine Eigenschaft, die beschreibt, auf welche Art die Daten angezeigt werden koennen. Steht damit direkt neben den Daten, also da wo ich zuerst suchen wuerde. Ist nicht notwendig, aber so kann FHEMWEB ein 'create weblink' anbieten." I have to admit that this link is useful and I use to use it :-)
	* If you meet on your way PERL-code snippets in the .gplot files, you can just ignore them safely. They are only used in the gnuplot world, not in SVG anymore. Now you may ask, where you find the corresponding features in SVG? They are hidden in functions defined in the FileLog "get" primitive.		* If you meet on your way PERL-code snippets in the .gplot files, you can just ignore them safely. They are only used in the gnuplot world, not in SVG anymore. Now you may ask, where you find the corresponding features in SVG? They are hidden in functions defined in the FileLog "get" primitive.
Zeile 166:		Zeile 166:
	Documentation can be found in several places, it is not complete and you need to piece it together:		Documentation can be found in several places, it is not complete and you need to piece it together:

	* [http://fhem.de/HOWTO.html#plotting ~~http://fhem.de/HOWTO.html#plotting]~~		* http://fhem.de/HOWTO.html#plotting
	* ~~[http://fhem.de/commandref.html#FileLogget~~ http://fhem.de/commandref.html#FileLogget]		* http://fhem.de/commandref.html#FileLogget
	* ~~[http://fhem.de/commandref.html#label~~ http://fhem.de/commandref.html#label]		* http://fhem.de/commandref.html#label


	[[Kategorie:HOWTOS]]		[[Kategorie:HOWTOS]]

Beta-User: add link to SVG plotreplace examples, translate and change info box

2020-08-27T08:29:27Z

add link to SVG plotreplace examples, translate and change info box

← Nächstältere Version		Version vom 27. August 2020, 10:29 Uhr
Zeile 1:		Zeile 1:
	{{Randnotiz\|RNTyp=[g\|Info]\|RNText=~~Hier wird das Anlegen per Hand beschrieben, was für Ungeübte umständlich und nicht empfehlenswert ist.~~		{{Randnotiz\|RNTyp=[g\|Info]\|RNText=Note: "Create SVG Plot" in detail view of ''FileLog'' type devices allows direct configuration in FHEMWEB frontend. This is in more detail described in [[Plots_erzeugen\|.gplot editor]] (german) and might be helpfull for learning the syntax. For more advanced options and generalized syntax, you'll have to directly edit the files as described here.}}
	~~Mit~~ "Create SVG Plot" in ~~der~~ FileLog~~-Detail-Ansicht steht inzwischen zur Vereinfachung ein Konfigurations-Frontend zur Verfügung:~~ [[Plots_erzeugen\|.gplot~~-Editor~~]].}}
	= Howto create a PGM2/SVG plot - Introduction =		= Howto create a PGM2/SVG plot - Introduction =
	Output using the PGM2 engine is generated through .gplot files. The name is historical and today files can be generated using gnuplot or SVG graphics. This howto lists the most important aspects of generating a SVG configuration file.		Output using the PGM2 engine is generated through .gplot files. The name is historical and today files can be generated using gnuplot or SVG graphics. This howto lists the most important aspects of generating a SVG configuration file.
Zeile 45:		Zeile 44:

	In general this is good practice and you should especially consider it if you plan to distribute your .gplot files. Using placeholders f.ex. for the title and all the labels and curve descriptors gives other users the possibility to change them without having to touch the .gplot code.		In general this is good practice and you should especially consider it if you plan to distribute your .gplot files. Using placeholders f.ex. for the title and all the labels and curve descriptors gives other users the possibility to change them without having to touch the .gplot code.

			For extended use of placeholder fuctionality have a closer look on the ''plotreplace'' attribute. Some insctructable examples can be found [[SVG#Beispiele\|here]].

	== Data Extraction ==		== Data Extraction ==
Zeile 69:		Zeile 70:
	* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.		* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.

	For even more details see ~~[http://fhem.de/commandref.html#~~FileLog ~~http://fhem.de/commandref.html#FileLog]~~ or the module 92_FileLog.pm.		For even more details see {{Link2CmdRef\|Anker=FileLog}} or the module 92_FileLog.pm.

	== Debugging Data Extraction ==		== Debugging Data Extraction ==

Kaihs: Änderung 28905 von Kaihs (Diskussion) rückgängig gemacht.

2019-01-01T20:14:25Z

Änderung 28905 von Kaihs (Diskussion) rückgängig gemacht.

← Nächstältere Version		Version vom 1. Januar 2019, 22:14 Uhr
Zeile 69:		Zeile 69:
	* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.		* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.

	For even more details see [http://fhem.de/commandref.html#~~FileLogger~~ http://fhem.de/commandref.html#~~FileLogget~~] or the module 92_FileLog.pm.		For even more details see [http://fhem.de/commandref.html#FileLog http://fhem.de/commandref.html#FileLog] or the module 92_FileLog.pm.

	== Debugging Data Extraction ==		== Debugging Data Extraction ==

Kaihs: Änderung 28904 von Kaihs (Diskussion) rückgängig gemacht.

2019-01-01T20:13:53Z

Änderung 28904 von Kaihs (Diskussion) rückgängig gemacht.

← Nächstältere Version		Version vom 1. Januar 2019, 22:13 Uhr
Zeile 69:		Zeile 69:
	* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.		* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.

	For even more details see [http://fhem.de/commandref.html#~~FileLog~~ http://fhem.de/commandref.html#~~FileLog~~] or the module 92_FileLog.pm.		For even more details see [http://fhem.de/commandref.html#FileLogger http://fhem.de/commandref.html#FileLogget] or the module 92_FileLog.pm.

	== Debugging Data Extraction ==		== Debugging Data Extraction ==

Kaihs: /* Data Extraction */ Typo

2019-01-01T20:10:58Z

Data Extraction: Typo

← Nächstältere Version		Version vom 1. Januar 2019, 22:10 Uhr
Zeile 69:		Zeile 69:
	* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.		* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.

	For even more details see [http://fhem.de/commandref.html#~~FileLogger~~ http://fhem.de/commandref.html#~~FileLogget~~] or the module 92_FileLog.pm.		For even more details see [http://fhem.de/commandref.html#FileLog http://fhem.de/commandref.html#FileLog] or the module 92_FileLog.pm.

	== Debugging Data Extraction ==		== Debugging Data Extraction ==

Kaihs: /* Data Extraction */ Typo

2019-01-01T20:09:26Z

Data Extraction: Typo

← Nächstältere Version		Version vom 1. Januar 2019, 22:09 Uhr
Zeile 69:		Zeile 69:
	* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.		* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.

	For even more details see [http://fhem.de/commandref.html#~~FileLogget~~ http://fhem.de/commandref.html#FileLogget] or the module 92_FileLog.pm.		For even more details see [http://fhem.de/commandref.html#FileLogger http://fhem.de/commandref.html#FileLogget] or the module 92_FileLog.pm.

	== Debugging Data Extraction ==		== Debugging Data Extraction ==

Zevnik am 16. September 2017 um 21:58 Uhr

2017-09-16T21:58:13Z

← Nächstältere Version		Version vom 16. September 2017, 23:58 Uhr
Zeile 67:		Zeile 67:
	* int (to cut off % from a number, as for the actuator)		* int (to cut off % from a number, as for the actuator)
	* delta-h / delta-d to get rain/h and rain/d values from continuous data		* delta-h / delta-d to get rain/h and rain/d values from continuous data
	* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.		* And then there is this: the string is evaluated as a perl expression. @fld is the current line splitted by spaces (0-based). So you can do something like $fld[3]/1000 to plot values divided by 1000 or $fld[3]=~"on"?0.9:0.8 to map the 4th field which contains an on/off information into numerical values to be plotted in a graph. Be warned though: this string/perl expression cannot (!) contain any spaces.

	For even more details see [http://fhem.de/commandref.html#FileLogget http://fhem.de/commandref.html#FileLogget] or the module 92_FileLog.pm.		For even more details see [http://fhem.de/commandref.html#FileLogget http://fhem.de/commandref.html#FileLogget] or the module 92_FileLog.pm.

JoWiemann am 14. Januar 2016 um 18:21 Uhr

2016-01-14T18:21:25Z

← Nächstältere Version		Version vom 14. Januar 2016, 20:21 Uhr
Zeile 100:		Zeile 100:
	axes x1y1 title '<L3>' with steps lw 2</nowiki>		axes x1y1 title '<L3>' with steps lw 2</nowiki>
	It implements the placeholders which can be defined by the user through the WebLink attributes later, selects just one column, without regular expression matches, defaults or subsequent data operations and plot is as a steps diagram. In fact even the "axes x1y1" statement could be left out, it would still work.		It implements the placeholders which can be defined by the user through the WebLink attributes later, selects just one column, without regular expression matches, defaults or subsequent data operations and plot is as a steps diagram. In fact even the "axes x1y1" statement could be left out, it would still work.

			== Changing text style ==
			If you need a text style that is different from the style definition in fhemweb:
			Add

			<nowiki>text { font-family:Arial, Helvetica, sans-serif; font-size:12px; fill:#xxxxxx;}
			text.title {font-family:Arial, Helvetica, sans-serif; font-size:16px; fill:#xxxxxx;}</nowiki>

			where #xxxxxx is the color.

	== Transparent plots ==		== Transparent plots ==

Justme: /* Data Extraction */

2015-05-10T20:42:55Z

Data Extraction

← Nächstältere Version		Version vom 10. Mai 2015, 22:42 Uhr
Zeile 57:		Zeile 57:

	* min<x>, max<x>		* min<x>, max<x>
			* mindate<x>, maxdate<x>
	* avg<x>, cnt<x>		* avg<x>, cnt<x>
	* sum<x>		* sum<x>

Krikan: Namensangleichung .gplot-Editor

2014-08-12T21:29:15Z

Namensangleichung .gplot-Editor

← Nächstältere Version		Version vom 12. August 2014, 23:29 Uhr
Zeile 1:		Zeile 1:
	{{Randnotiz\|RNTyp=[g\|Info]\|RNText=Hier wird das Anlegen per Hand beschrieben, was für Ungeübte umständlich und nicht empfehlenswert ist.		{{Randnotiz\|RNTyp=[g\|Info]\|RNText=Hier wird das Anlegen per Hand beschrieben, was für Ungeübte umständlich und nicht empfehlenswert ist.
	Mit "Create SVG Plot" in der FileLog-Detail-Ansicht steht inzwischen zur Vereinfachung ein Konfigurations-Frontend zur Verfügung: [[Plots_erzeugen\|~~Ploteditor~~]].}}		Mit "Create SVG Plot" in der FileLog-Detail-Ansicht steht inzwischen zur Vereinfachung ein Konfigurations-Frontend zur Verfügung: [[Plots_erzeugen\|.gplot-Editor]].}}
	= Howto create a PGM2/SVG plot - Introduction =		= Howto create a PGM2/SVG plot - Introduction =
	Output using the PGM2 engine is generated through .gplot files. The name is historical and today files can be generated using gnuplot or SVG graphics. This howto lists the most important aspects of generating a SVG configuration file.		Output using the PGM2 engine is generated through .gplot files. The name is historical and today files can be generated using gnuplot or SVG graphics. This howto lists the most important aspects of generating a SVG configuration file.