Difference between revisions of "PRO Graphs"

From meteobridge
Jump to: navigation, search
(11 intermediate revisions by the same user not shown)
Line 38: Line 38:
 
* '''lang''' defined the language for the chart ("en" is default). Example: "lang de" defines German as the chart language.
 
* '''lang''' defined the language for the chart ("en" is default). Example: "lang de" defines German as the chart language.
 
* '''futuredata''' expands the chart into the future if set to "yes" (default). If set to "no" chart will stop at current date/time.
 
* '''futuredata''' expands the chart into the future if set to "yes" (default). If set to "no" chart will stop at current date/time.
* '''chart''' defines the type of the chart. Currently only "line" (default) is supported.
+
* '''type''' defines the type of the chart. Currently only "line" (default), "step" (stepped line), "column" (vertical bar) and "point" are supported.
* '''dataX''' defines data set "X". "X" should start at 1 and needs to be incremented for each new data set to be used in the chart. Data sets are sensor names as used in template expansions like "th0temp-avg.1" which represents outdoor temperature (th0 sensor) averaged on the chosen resolution and with one decimal precision. Examples: "rain0total-daysum=in.2" represents the cumulated rain fall (rain0 sensor) per day in inch with 2 decimals precision. "rain0total-sum.1" represents the cumulated rainfall in mm over the total selected time period in 1 decimal precision.  
+
* '''typeX''' overwrites chart setting for data set X.
 +
* '''type0''' defines chart type for time line representation in the legend.  
 +
* '''dataX''' defines data set "X". "X" should start at 1 and needs to be incremented for each new data set to be used in the chart. Data sets are sensor names as used in template expansions like "th0temp-avg.1" which represents outdoor temperature (th0 sensor) averaged on the chosen resolution and with one decimal precision. Examples: "rain0total-daysum=in.2" represents the cumulated rain fall (rain0 sensor) per day in inch with 2 decimals precision. "rain0total-allsum.1" represents the cumulated rainfall in mm over the total selected time period in 1 decimal precision.  
 
* '''nameX''' gives dataset X a name to be used in the chart.
 
* '''nameX''' gives dataset X a name to be used in the chart.
 
* '''axisX''' defines if data set X is measured on the "left" (default) or "right" vertical axis. Instead of "left" or "right" there can also be given a reference to an already defined axis which inhibits that the scale in the vertical axis is duplicated. Example "axis3 axis1" tells that data set 3 uses the same vertical axis as data set 1.
 
* '''axisX''' defines if data set X is measured on the "left" (default) or "right" vertical axis. Instead of "left" or "right" there can also be given a reference to an already defined axis which inhibits that the scale in the vertical axis is duplicated. Example "axis3 axis1" tells that data set 3 uses the same vertical axis as data set 1.
Line 48: Line 50:
 
* '''minX''', '''maxX''', '''offsetX''' define the minimum, maximum and offset value for vertical axis representation of data set X.
 
* '''minX''', '''maxX''', '''offsetX''' define the minimum, maximum and offset value for vertical axis representation of data set X.
 
* '''fillX''' defines if the area below the line chart should be filled (default is 0, which does not fill the area). Values can be 0 (no fill) up to 1.0 (complete, not transparent fill).
 
* '''fillX''' defines if the area below the line chart should be filled (default is 0, which does not fill the area). Values can be 0 (no fill) up to 1.0 (complete, not transparent fill).
 +
* '''bgcolor''' defines background color of the chart (default is white "#FFFFFF".
 +
* '''fgcolor''' defines foreground color of the chart (default is black "#000000".
  
Example of a meta chart that displays outdoor temp, humidity, dew point and sea level pressure. Dew point and sea level pressure are disabled Temperature and Dew point share the same vertical axis (axis1), humidity axis is scaled from 0 to 100 and vertical axis for data set 4 is moved 40px to the left to avoid overlapping with labeling of vertical axis for data set 2 (humidity).
+
Example of a meta chart that displays outdoor temp, humidity, dew point, sea level pressure, precipitation, gust and wind direction. Initially only temperature and humidity are enabled. Left vertical axis shows temperature in degrees Fahrenheit, rainfall in inch, and wind direction in degrees. Right vertical axis shows relative humidity, pressure in inHg and wind speed in mph. While default chart type is a line graph, gust speed is displayed as filled bars, precipitation as a stepped line semi transparently filled underneath and wind direction is represented as points. Labels on the vertical axes are moved by appropriate offsets inwards to reduce overlapping. Don't be confused by the appearance of this busy chart, it is not meant as a design pattern but as a show case how all the features can be applied.
<pre># meta chart test
+
 +
[[File:page8b.png|685px|right]]<pre># meta chart test
 
#
 
#
 
title My Sensor Data
 
title My Sensor Data
 +
width 100%
 +
height 450px
 
futuredata yes
 
futuredata yes
chart line
+
type line
 +
type5 step
 +
type6 column
 +
type7 point
 +
legend 1
 
data1 th0temp-avg=F.1
 
data1 th0temp-avg=F.1
 
data2 th0hum-avg.0
 
data2 th0hum-avg.0
 
data3 th0dew-avg=F.1
 
data3 th0dew-avg=F.1
 
data4 thb0seapress-avg=inhg.2
 
data4 thb0seapress-avg=inhg.2
name1 Temperatur
+
data5 rain0total-allsum=in.2
name2 Luftfeuchte
+
data6 wind0wind-max=mph.1
name3 Taupunkt
+
data7 wind0dir-avg.0
name4 Luftdruck
+
name1 Temperature
 +
name2 Humidity
 +
name3 Dewpoint
 +
name4 Pressure
 +
name5 Precipitation
 +
name6 Gust
 +
name7 Direction
 
axis1 left
 
axis1 left
 
axis2 right
 
axis2 right
 
axis3 axis1
 
axis3 axis1
 
axis4 right
 
axis4 right
 +
axis5 left
 +
axis6 right
 +
axis7 left
 
active1 yes
 
active1 yes
 
active2 yes
 
active2 yes
 
active3 no
 
active3 no
 
active4 no
 
active4 no
 +
active5 no
 +
active6 no
 +
active7 no
 
unit1 °F
 
unit1 °F
 
unit2 %
 
unit2 %
 
unit3 °F
 
unit3 °F
 
unit4 inHg
 
unit4 inHg
 +
unit5 in
 +
unit6 mph
 +
unit7 °
 
color1 #10E010
 
color1 #10E010
 
color2 #4430FF
 
color2 #4430FF
 
color3 #E01010
 
color3 #E01010
legend 1
 
 
min2 0
 
min2 0
 +
min6 0
 +
min7 0
 
max2 100
 
max2 100
 +
max7 360
 
offset2 0
 
offset2 0
offset4 -40</pre>
+
offset4 -40
 +
offset5 -40
 +
offset6 -80
 +
offset7 -80
 +
fill5 0.1
 +
fill6 1.0</pre>
  
  

Revision as of 20:22, 20 August 2019

<languages /><translate>


One of the features that sets Meteobridge PRO and NANO SD apart from the regular Meteobridges is the ability to generate interactive Charts. You can select one of the predefined Chart templates, select the time period you are interested in, selcts a time resolution, and the languge. Having done that, press "save" and the chart will be genertead and displayed. Meteobridge does also provide you a URL you can use locally or from the internet (when remote login is enabled) to generate the chart.

Page8.png

Time Period

Page8a.png
Meteobridge provides the following predefined time periods to select from:
  • last 24h
  • today
  • yesterday
  • last 2 days
  • last 7 weeks
  • this week (start Sunday)
  • this week (start Monday)
  • last week (start Sunday)
  • last week (start Monday)
  • last 2 weeks (start Sunday)
  • last 2 weeks (start Monday)
  • last 4 weeks (start Sunday)
  • last 4 weeks (start Monday)
  • this month
  • last month
  • this quarter
  • last quarter

URL selector

When calling a chart by an URL the time frame is controlled by the arguments "start" and "stop" which determine the interval to be displayed. "start" and "stop" can be

  • a distinct time stamp in "YYYYMMDDhhmm" notation like "201901010000" for 00:00 on Jan 1, 2019. Depending on the chooses time resolution minutes and hours can be omitted.
  • a relative time stamp like "Yn" (year), "Mn" (month), "Wn" (week), "Dn" (day), "Hn" (hour), where the first letter indicates the time scale (year, month, week, day, hour) and the consecutive number indicates how many steps to go into the past. Example: "M0" indicates the current month, M1 last month, M2 month before last month, etc. To show data of the current month the URL looks like "&start=M1&end=M0"

Chart Type

Meteobridge has a number of charts predefined. You can simply select those with the drop-down menu. The charts are located on the internal storage and can be access as a PC network drive in forder "templates". All charts have extension ".chart" or ".metachart". While ".chart" definitions are hand-crafted the ".metachart" files just contain some definitions which are used to build an individual chart when called. When you want to build charts yourself, please create ".metachart" files.

Meta Chart Definition

A meta chart is a simple text file with extension ".metachart" located in "templates" folder. Lines with a preceding "#" are viewed as comments and are not evaluated. Each non-comment line in the file represents a name-value pair. first word in a line is the name, following words until end of the line are handled as the value corresponding to the name. These names are defined:

  • title defines the name of the chart. Example "title Temperature" sets "Temperature" as the chart title.
  • lang defined the language for the chart ("en" is default). Example: "lang de" defines German as the chart language.
  • futuredata expands the chart into the future if set to "yes" (default). If set to "no" chart will stop at current date/time.
  • type defines the type of the chart. Currently only "line" (default), "step" (stepped line), "column" (vertical bar) and "point" are supported.
  • typeX overwrites chart setting for data set X.
  • type0 defines chart type for time line representation in the legend.
  • dataX defines data set "X". "X" should start at 1 and needs to be incremented for each new data set to be used in the chart. Data sets are sensor names as used in template expansions like "th0temp-avg.1" which represents outdoor temperature (th0 sensor) averaged on the chosen resolution and with one decimal precision. Examples: "rain0total-daysum=in.2" represents the cumulated rain fall (rain0 sensor) per day in inch with 2 decimals precision. "rain0total-allsum.1" represents the cumulated rainfall in mm over the total selected time period in 1 decimal precision.
  • nameX gives dataset X a name to be used in the chart.
  • axisX defines if data set X is measured on the "left" (default) or "right" vertical axis. Instead of "left" or "right" there can also be given a reference to an already defined axis which inhibits that the scale in the vertical axis is duplicated. Example "axis3 axis1" tells that data set 3 uses the same vertical axis as data set 1.
  • unitX defines the unit string to be used for dataset X in the chart. Example: "unit1 °C" defines data set 1 is annotated as °C in the chart.
  • colorX defines the color to be used for data set X in the chart. Example: "color2 #000000" defines black color for data set 2. If no color is selected Mateobridge uses one of eight default colors.
  • activeX defines if the data set X is shown when displaying the chart. If set to "no" it needs a click to the data set in the chart to make it visible. Default is "yes".
  • legendX defined which data set to be used as reference in the time line of the chart. Default is data set 1.
  • minX, maxX, offsetX define the minimum, maximum and offset value for vertical axis representation of data set X.
  • fillX defines if the area below the line chart should be filled (default is 0, which does not fill the area). Values can be 0 (no fill) up to 1.0 (complete, not transparent fill).
  • bgcolor defines background color of the chart (default is white "#FFFFFF".
  • fgcolor defines foreground color of the chart (default is black "#000000".

Example of a meta chart that displays outdoor temp, humidity, dew point, sea level pressure, precipitation, gust and wind direction. Initially only temperature and humidity are enabled. Left vertical axis shows temperature in degrees Fahrenheit, rainfall in inch, and wind direction in degrees. Right vertical axis shows relative humidity, pressure in inHg and wind speed in mph. While default chart type is a line graph, gust speed is displayed as filled bars, precipitation as a stepped line semi transparently filled underneath and wind direction is represented as points. Labels on the vertical axes are moved by appropriate offsets inwards to reduce overlapping. Don't be confused by the appearance of this busy chart, it is not meant as a design pattern but as a show case how all the features can be applied.

Page8b.png
# meta chart test
#
title My Sensor Data
width 100%
height 450px
futuredata yes
type line
type5 step
type6 column
type7 point
legend 1
data1 th0temp-avg=F.1
data2 th0hum-avg.0
data3 th0dew-avg=F.1
data4 thb0seapress-avg=inhg.2
data5 rain0total-allsum=in.2
data6 wind0wind-max=mph.1
data7 wind0dir-avg.0
name1 Temperature
name2 Humidity
name3 Dewpoint
name4 Pressure
name5 Precipitation
name6 Gust
name7 Direction
axis1 left
axis2 right
axis3 axis1
axis4 right
axis5 left
axis6 right
axis7 left
active1 yes
active2 yes
active3 no
active4 no
active5 no
active6 no
active7 no
unit1 °F
unit2 %
unit3 °F
unit4 inHg
unit5 in
unit6 mph
unit7 °
color1 #10E010
color2 #4430FF
color3 #E01010
min2 0
min6 0
min7 0
max2 100
max7 360
offset2 0
offset4 -40
offset5 -40
offset6 -80
offset7 -80
fill5 0.1
fill6 1.0


Time Resolution

Meteobridge provides data in yearly, monhtly, daily, hourly, and for the last 3 days also in per minute resolution. You can select the desired resolution per drop-down menu.

Language

Charts can be made in different languages. This has an effect on the ".charts" as it makes use of the language specific names for the sensors and it also has an impact on the time line. These languages are available:

  • English
  • German
  • Dutch
  • French
  • Italian
  • Spanish

External Use

To make external use of a defined chart Meteobridge provides a local and a remote link. This link contains all the made choice as URL parameters. Example: The chart shown on the top of the page can be directly accessed by the URL "http://ip-of-your-meteohub/public/chart.cgi?chart=allinone-iso.chart&res=hour&lang=en&start=D2&stop=D1"


</translate>