View source

Generating graphs and displays in Meteoplug is probably one of the most exciting things as it gives you a lot of freedom to present your weather data. Meteoplug makes use of [http://amcharts.com amcharts] for interactive graphing and [http://www.fusioncharts.com/widgets/Gallery.asp fusionwidgets] for live displays with meters and gauges. Both are based on recent Flash technology. In addition to that a classical graphing based on [http://gnuplot.info gnuplot] can also be used for line graphs. This section explains what kind of charts you can make use of an how to configure these. We differentate between graphs, which show the development of weather condition over a choosen period of time, and displays, which show near real-time weather conditions. As these two types do have different requirements, they are handled in separate sections. 

==Definition of a Graph or Display==
When you enter Meteoplug's "Define Chart" page you see an empty page you can put your graphing or display commands into. 

<center>[[File:mp-define-chart.png]]</center>

When you want to edit an existing chart or display, you can select one from the drop-down menu at the top. There are a couple of predefined charts. These are listed beginning with an underscore "_". 

When you want to store a chart definition you have to enter a name for your chart next to "Save as" button. When you press "Save as" chart definition will be stored. If a chart definition with this name already exists it will be overwritten without warning. Saved charts will be added to the ones in the drop-down list. This allows you to build your personal library of definitions over time. Chart names should not include spaces or special characters and they cannot start with an underscore "_", because chart names starting with underscores are reserved for predefined charts. Predefined charts cannot be deleted or altered.

When you want to test a loaded chart definition, simply press "Display" button. A separate Window will pop-up and will show your chart. If the chart definition is wrong, an error message will appear instead. Please make sure that your browser doesn't block pop-ups from "www.meteoplug.com". JavaScript and FLASH also need to be enabled in your browser.

To delete a saved chart definition select the cart in the drop-down list and press "Delete". A warning will appear asking you if you really want to delete. Press "OK" to make the delete happen. When you abort, nothing will be deleted.

==Graphing Language==
Graphing language used in Meteoplug is derived from a subset of amcharts options. It can be easily used and provides quite some capabilities to adapt graphs to your needs. Chart commands are represented as name-value pairs separated by "=". No spaces are allowed between name, "=" and value. Name-value pairs are separated by white space characters (blanks and/or new lines). As a result you can place each name value pair into a new line or you can define multiple name-value pairs in one line separated by white spaces. 

When value should include a space character (might be useful for sensor names), you have to use underscore "_" instead of space. Underscores will be converted back to spaces when being displayed. When you need a underscore "_" not to be converted into space, type two underscores "__", which will be converted to one underscore "_". If you need a line feed character in the string, use vertical bar character "&#124;" instead.  

You can add comments to the chart definition. When Meteoplug hits a "#" when it expects a new name value pair, then rest of current line will be skipped and not evaluated. This allows you to type any text you like after comment character "#". As you can see, example below makes heavy use of commenting.

When you specify numbers the decimal separator is "." regardless what language you might have selected.

===Graphing Example===
Before graphing language is explained in detail, you might have a look at chart definition below as an example. This chart defines a graph that displays monthly rainfall and number of days with rain per month for the last 3 years (including actual year). Rainfall is displayed as blue bars, number of days with rain is displayed as a smoothed red line.

<center>[[File:mp-chartxxx-rain1year.png]]</center>

Applied to my rain data the result looks like displayed above. It is a snapshot where the interactive cursor points to November 2009. To give a idea how graphing in Meteoplug does work, I will try to explain this graph definition, line by line. 

Chart commands: 
* <code>timeframe=3Y</code> tells Meteoplug that time frame to use is last threes years (including actual year)
* <code>zoom=1Y</code> sets display mode when initially showing the graph to 1 year. By pressing another zoom button or moving the scroller this can be changed interactively when graph is displayed.
* <code>res=month1</code> sets resolution of data to one month. Meteoplug provides data at various time resolutions you can choose from.

Graph commands:
* <code>gtitle=Rain</code> sets the title "Rain" to the top left of the graph.
* <code>gheight=400</code> defines height of graph to be 400 pixel.
* <code>gwidth=550</code> defines width of graph to be 550 pixel.
* <code>glunit=mm</code> defines unit for left y-axis to be "mm".
* <code>grunit=days</code> defines unit of right y-axis to be "days".
* <code>gtype=step</code> defines standard display type of graph to be a stepped line.
* <code>gtrim=1</code> defines that left and right end of time frame to be adapted to existing data. As data for 2010 is just covering January and February, graph does strip empty months of 2010 from graph.

Sensor commands:
* <code>sid0=rain0 scolor0=AADDFF  sfill0=50 sline0=100 sname0=rain_fall ssel0=total</code> selects sensor "rain0" for display. Data field to be displayed is "total", which represents total rain fall. color of graph is "AADDFF" (light blue), line has 100% color coverage, fill area has just 50% color coverage, name of sensor is "rain fall". 
* <code>sid1=rain0 ssmooth1=1 stype1=line syaxis1=r sname1=days_with_rain ssel1=days</code> selects sensor "rain0" for display. Data field to be displayed is "days", which represents number of days with rain fall, graph type is "line" with attribute "smoothed", sensor is measured on right y-axis, name of sensor is "days with rain".

===Chart Settings===
A chart definition should start with settings that are valid for all graphs in the chart and all sensors in the chart's graphs. Meteoplug provides these name-value pairs to define chart settings

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory [Applicable]''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|-
| timeframe|| yes [LJRTCGED] || see section "time ranges"|| none || defines start and end time to be considered. This parameter can be overwritten by an URL parameter in same notation to allow change of time frame when displaying the graph.  || timeframe=1Y (actual year)<br>timeframe=-1D (yesterday)<br>timeframe=20091201000000<br>-20091231235959 (December 2009)
|-
| res|| no [LJRTCGED]|| see section "time resolution"|| depends on timeframe|| defines resolution of data to be taken for graphing. This can be overwritten by an URL parameter called "resolution". || res=month1 (monthly data)<br>res=min5 (data from 5 minute buckets)<br>res=hour1 (hourly data)
|-
| zoom|| no [LJM]|| see section "chart zoom" or "maps" || depends on timeframe|| defines initial subset of data (or map) to be displayed. || zoom=1D (current day)<br>zoom=YTD (data since beginning of year until now)<br>zoom=MAX (all data of selected time range)<br>zoom=4 (show about one continent on map)
|-
| monlist, monlistlong|| no [LJ]|| list of 12 month names separated by ",". monlistlong can provide full month names instead of abbreviations (JS only) || jan,feb,mar, apr,may,jun, jul,aug,sep, oct,nov,dec || defines strings to be taken for display of months || monlist=jan,feb,mar,api,jun, jul,aug,sep,okt,nov,dez
|-
| daylist, daylistlong|| no [LJ]|| list of 7 day names separated by ",". daylistlong can provide full day names instead of abbreviations (JS only) || sun,mon,tue, wed,thu,fri,sat || defines strings to be taken for display of day names || daylist=so,mo,di,mi,do,fr,sa
|-
| dirlist|| no [TRX]|| list of 16 compass direction names separated by "," || N,NNE,NE,ENE, E,ESE,SE,SSE, S,SSW,SW,WSW, W,WNW,W,NNW || defines strings to be taken for display of compass directions || dirlist=N,NNO,NO,ONO,<BR>O,OSO,SO,SSW,S,SSW,<BR>SW,WSW,W,WNW,W,NNW
|-
| phasetextlist|| no [TX]|| list names of 8 lunar phases separated by "," || New_Moon, Waxing_Crescent, First_Quarter, Waxing_Gibbous, Full_Moon, Waning_Gibbous, Last_Quarter, Waning_Cresent || defines strings to be taken for display of lunar phases || phasetextlist=1/8,2/8,3/8,4/8,<BR>5/8,6/8,7/8,8/8
|-
| phaseiconlist|| no [TX]|| list URLs for display of lunar phases separated by "," || mp0.png, mp1.txt, ... || defines URLs to be taken for display of lunar phase icons || phaseiconlist=<BR><nowiki>http://www.meteoplug.com/mp0.png</nowiki>,...
|-
| fctextlist|| no [TX]|| list names of 9 forecast situations, separated by "," || Rainy, Cloudy, Half Cloudy, Sunny, Snowy, Half-Cloudy Night, Clear Night, Light Rainy, Light Snowy || defines strings to be taken for display of forecast values || fctextlist=Regen, Bewölkung, leichte_Bewölkung, Sonne,Schnee, leicht_bewölkte_Nacht, klare_Nacht,l eichter_Regen, leichter_Schneefall
|-
| fciconlist|| no [TX]|| list URLs for display of 9 forecast situations, separated by "," || fc0.png, fc1.txt, ... || defines URLs to be taken for display of forecast icons || fciconlist=<BR><nowiki>http://www.meteoplug.com/fc0.png</nowiki>,...
|-
| periodm, periodh, periodD, periodM, periodY || no [LJ]|| date format string for x-axis depending on time scale || see examples || provides a format template for time scales: minutes (m), hours (h), days (D), months (M), years (Y) as outlined [http://amcharts.com/docs/v.1/stock/settings/settings_reference#date_formats here] (flash) and [http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/mx/formatters/DateFormatter.html here] (JS) || periodm=J:NN\nEEE_DD.MM. (standard for JS), periodm=hh:mm\nWW_DD.MM. (standard for flash)
|-
| legendm, legendh, legendD, legendW, legendM, legendY || no [L]|| date format string for legend depending on time scale || see examples || provides a format template for time scales: minutes (m), hours (h), days (D), weeks (W), months (M), years (Y) as outlined [http://amcharts.com/docs/v.1/stock/settings/settings_reference#date_formats here] (flash) and [http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/mx/formatters/DateFormatter.html here] (JS) || legendh=YYYY-MM-DD_hh:mm (standard for flash)
|-
| legendpos|| no [LJ]|| top, left, right || top || defines position of legend relative to graphs || legendpos=left (legend is positioned at left side of graph and organized vertically)
|-
| legendwidth|| no [LJ]|| positive number of pixels || unknown|| defines width of legend in pixels. Needed when legendpos is left or right. Specifies size of value display in legend when used with JS|| legendwidth=100
|-
| decimalsep|| no [LJ]|| character used for separating decimals || "." (point) || Defines character to be used to separate decimals || decimalsep=, (comma)
|-
| thousandsep|| no [LJ]|| character used for separating thousands || " " (blank) || Defines character to be used to separate thousands || thousandsep=_ (blank)
|-
| xymode|| no [D]|| specifies distribution chart || 0 (no distribution chart) || Sets chart mode to type "distribution" where x-axis is not time axis but shows distribution of weather data. Number specifies how many buckets should be used. || xymode=20 (sets distribution chart, 20 buckets to use)
|-
| xstart || no [D]|| specifies first value to start with || 0.0 || Sets starting point for value iteration of distribution chart. || xstart=0.0 (sets lower bound of first buckets to 0.0, xfactor and xoffset are not applied here)
|-
| xinc || no [D]|| specifies increment value to separate buckets || 1.0 || Increment value used for computation of lower bound of next bucket. Upper bound is lower bound of next bucket. || xinc=1.0 (sets bucket size and increment between buckets to 1.0, xoffset and xfactor are not applied here)
|-
| xoffset || no [D]|| specifies offset to be applied to bucket value.  || 0.0 || Offset value used when displaying bucket ranges. This can be used to make a distribution graph that lists temperature durations segmented by °F instead of °C. || xoffset=0.0 (sets bucket value offset to zero)
|-
| xfactor || no [D]|| specifies factor to be applied to bucket value.  || 1.0 || Factor used when displaying bucket ranges. This can be used to make a Weibull wind speed distribution graph that lists wind speed durations segmented by mp/h instead of m/s. || xfactor=3.6 (Converts bucket values on x-axis from m/s to km/h)
|- 
| restrictip || no [LJRTCGEXD] || WAN IP of requesting computer || none || restricts access to the chart to a certain requesting IP. When requesting IP does not match an error is displayed.  || restrictip=81.123.23.77 (restricts access to given IP)
|- 
| periodselector|| no [LJM] || defines if period selector below scroll bar should be displayed || 1 (yes) || This allows to make interactive chart a less bit high, by stripping off the period selector at the bottom. || periodselector=0 (don't use period selector)
|-
| scrollerselector|| no [LJM] || defines if scroller below graphs should be displayed || 1 (yes) || This allows to make interactive chart a less bit high, by stripping off the acroller at the bottom. In JavaScript charts this also controls if chart can be panned (scrollerselector=0) or zoomed (scrollerselector=1) with the cursor. || scrollerselector=0 (don't use scroller)
|-
| textcolor || no<br>[LJRCD] || string || black || Specifies text color in RGB style || textcolor=#0000FF (blue)
|-
| gridcolor || no<br>[LJRCD] || string  || black || Defines color of grid lines in a chart's graph in RGB style || ggridcolor=#FF0000 (red)
|-
| gridalpha || no<br>[LJRCD] || 0-100 || 15 (dark gray) || Defines intensity of grid lines in a chart's graphs || ggridalpha=100 (no transparency)
|-
| bgcolor || no<br>[LJRCD] || string || white || Specifies background color in RGB style || bgcolor=#0000FF (blue)
|-
| bgalpha || no<br>[LJRCD] || 0-100 || 100 || Specifies intensity (alpha) of background color in percent || bgalpha=50 (50% intensity)
|-
| title || no<br>[LJTRCD] || string (blank chars replaced with "_")  || "Meteoplug_Chart" || Defines HTML title of the chart || title=temp_of_today
|-
| engine|| no<br>[LJGT] || "flash", "javascript", "gnuplot" || "flash" || Selects which charting engine to be used. Default is flash,  but you can also use javascript and gnuplot || engine=javascript
|} 
<font size=1>Letter in brackets indicate applicability: [L] = flash line or bar graphs; [J] = JavaSrcipt line or bar graphs; [T] = HTML tables; [R] = radar charts; [C] = color maps; [G] = GPline/step/bar/needle/point; [E] = csv export; [X] = template replacement; [D] = distribution chart; [M] = map</font>

====Time Ranges====
Meteoplug supports absolute and relative time ranges. Notations are as follows:
* "'''YYYYMMDDhhmmss-YYYYMMDDhhmmss'''" defines a absolute range in time defined by a starting point and a end point, which are in a notation where year is given by 4 digits (YYYY), followed by a 2-digit month (MM), a 2-digit day (DD), a 2-digit hour (hh), a 2-digit minute (mm) and a 2-digit second (ss). Timestamps that exactly match a starting or end point are part of the time range. 
* An integer number followed by a alpha character defines a relative range in time. Examples assume that current time is 20100130175213 (2010-01-30 17:52:13). 
** "x'''s'''" sets starting point x seconds in the past and end point to actual time (example: "60s" is mapped to 20100130175113-20100130175213).
** "x'''m'''" sets starting point x minutes in the past. End point is set to actual time (example: "5m" is mapped to 20100130174713-20100130175213).
** "x'''h'''" sets starting point x hours in the past. End point is set to actual time (example: "3h" is mapped to 20100130145213-20100130175213).
** "x'''H'''" sets starting point to the beginning of the hour, x-1 hours ago. End point is set to end of current hour (example: "3H" is mapped to 20100130150000-20100130175959). 
** "x'''d'''" sets starting point x days in the past. End point is set to actual time (example: "3d" is mapped to 20100127175213-20100130175213).
** "x'''D'''" sets starting point to the beginning of the day, x-1 days ago. End point is set to end of current day (example: "3D" is mapped to 20100128000000-20100130235959).
** "x'''W'''y" sets starting point to the beginning of the week, x-1 weeks ago. y controls what days is first day of week (0=Sun, 1=Mon, 2=Tue, 3=Wed, 4=Thu, 5=Fri, 6=Sat). End point is set to end of current week (example: "3W1" is mapped to 20100111000000-20100131235959).
** "x'''M'''" sets starting point to the beginning of the month, x-1 months ago. End point is set to end of current month (example: "3M" is mapped to 20091101000000-20100131235959).
** "x'''Y'''" sets starting point to the beginning of the year, x-1 years ago. End point is set to end of current year (example: "1Y" is mapped to 20100101000000-20101231235959).
* When relative time ranges are preceded by a minus sign ("'''-'''"), end point for capital letter operations (H, D, M, Y) is set to end of previous hour, day, month or year (depending on choosen operation).

====Time Resolution====
Meteoplug supports good details for graphing. If no resolution is specified Meteoplug will compute a suitable resolution for given time frame without grabbing too much data which will overcrowd graphs and will explode loading times. While Meteoplug's computation of resolution is probably fine for many graphing purposes, there are situations where you want control level of detail. When you are planing to make a graph that displays rain fall per day, time resolution should be a day, as you are looking for exactly that data. In situations like this, a explicit resolution definition will be necessary. Meteoplug will not allow to select a resolution that forces a too big amount of data and will automatically switch to be lower resolution for sake of load time.

Defined resolutions are:
* '''min5''' (data assigned to 5 minute buckets)
* '''min10''' (data assigned to 10 minute buckets)
* '''min30''' (data assigned to 30 minute buckets)
* '''hour1''' (data assigned to hourly buckets)
* '''hour6''' (data assigned to 6 hour buckets)
* '''day1''' (data assigned to days)
* '''month1''' (data assigned to months)
* '''year1''' (data assigned to years)
* '''alltime''' (all data assigned to just one bucket, useful to select all time min/max/average values)

====Chart Zoom====
When chart is displayed it starts with an initial zoom setting you can control. Available zoom settings are:
* '''1D''' (last day of selected time range)
* '''10D''' (last 10 days of selected time range)
* '''1M''' (last month of selected time range)
* '''3M''' (last 3 months of selected time range)
* '''1Y''' (last 12 months of selected time range)
* '''YTD''' (last year of selected time range)
* '''MAX''' (complete time range)

===Graph Settings===
A Meteoplug chart can be made out of several graphs. At the moment Meteoplug just supports one graph per chart. Graph settings are always starting with a "g". These settings are valid for graphs:

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory [Applicable]''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| gtitle|| yes<br>[LJTRCGEM] || string (blank chars replaced with "_") || none || Defines title to be displayed in graph's legend. || gtitle=Todays_Outdoor_Temperature
|-
| gtype|| yes<br>[LJTRCGEDM]|| see section "graph types"|| none || Defines overall type of graph. Setting can be overwritten by a sensor definition. Once a charting engine is selected (by graph type name or engine tag) only graph types of that charting engine can be used. || gtype=line (line chart)<br>gtype=bar (chart with bars)
|-
| gfont || no<br>[LJRCG] || string  || arial (gnuplot), Tahoma (flash), Verdana (javascript) || Defines font to use for display of numbers and text || gfont=cour (select Courier as font, valid for gpline)
|-
| gfontsize || no<br>[LJRCG] || number  || 9 (gpline), 11 (other) || Defines font size to use for display of numbers and text || gfontsize=12 (selects 12pt font)
|-
| ggridcolor || no<br>[LJRCD] || string  || black || Defines color of grid lines in graph in RGB style, overrides gridcolor defined on chart level || ggridcolor=#FF0000 (red)
|-
| ggridalpha || no<br>[LJRCD] || 0-100 || 15 (dark gray) || Defines intensity of grid lines in graph, overrides gridalpha defined on chart level || ggridalpha=100 (no transparency)
|-
| glunit || no<br>[LJTRCGED] || string  || empty string || Defines what physical unit should be added to the right of numbers of left y-axis. When set to "none", left y-axis is not displayed. Has special meaning as header of first column in table mode and as delimiter string in export mode. Is added to values when displayed as balloon in color map mode. || glunit=°C (unit is defined as degrees Celsius)
|-
| glmin || no<br>[LJRCGD] || number|| none|| Defines minimum value to be displayed on left y-axis. Specifies minimum value to be expected in chart and maps this value (and values below) to color defined in "grmin" when used in color map mode. || glmin=-0.5
|-
| glmax || no<br>[LJRCGD] || number|| none|| Defines maximum value to be displayed on left y-axis. Specifies maximum value to be expected in chart and maps this value (and values above) to color defined in "grmax" when used in color map mode. || glmax=40
|-
| grunit || no<br>[LJTCGED] || string  || empty string || Defines what physical unit should be added to the right of numbers of right y-axis. When set to "none", righty-axis is not displayed. Has special meaning (format string for time stamps) in table and export mode. In color map mode it specifies a color (in 6-digit hex RGB) used for map positions where no data is present. Defines format string for x-value in distribution charts. || grunit=hPa (unit is defined as hecto pascal)<br>grunit=#EEEEEE (defines a light grey for missing data in color map mode)
|-
| grmin || no<br>[LJCG] || number|| none|| Defines minimum value to be displayed on right y-axis. Defines color for minimum value (as defined in "glmin") in 6-digit hex RGB. || grmin=-0.5<br>gr=#0022FF (defines a strong blue as color for minimum values in color map mode)
|-
| grmax || no<br>[LJCGD] || number|| none|| Defines maximum value to be displayed on right y-axis. Defines color for minimum value (as defined in "glmin") in 6-digit hex RGB. || grmax=40<br>gr=#FF0000 (defines red as color for maximum values in color map mode)
|-
| gtrim || no<br>[LJTRCGE] || number|| 1 || Specifies if time range should be trimmed to available data in the time range. In distribution mode setting trim will purge all buckets with zero count. || gtrim=1 (trimming is on)
|-
| gbgcolor || no<br>[LJRCD] || string || white || Specifies background color in RGB style, overrides background color defined on chart level || gbgcolor=#0000FF (blue)
|-
| gbgalpha || no<br>[LJRCD] || 0-100 || 100 || Specifies intensity (alpha) of background color in percent, overrides background color intensity defined on chart level || gbgalpha=50 (50% intensity)
|-
| gnightcolor || no<br>[J] || string || values defined for "gbgcolor" || Specifies background color of chart between sunset and sunrise in RGB style. || gnightcolor=#000077 (dark blue)
|-
| gnightalpha || no<br>[J] || 0-100 || 100 (when gnightcolor defined, else 0 || Specifies intensity (alpha) of nightcolor overlay in percent. || gnightalpha=10 (10% intensity)
|-
| gscroller || no<br>[LJ] || number|| 0 || Specifies sensor to be used for display as timeline scroller.  || gscroller=1 (takes data from sensor 1 for display of scroller)
|-
| gcolwidth || no<br>[LD] || number 0-100|| depends on graph type || Specifies width of bars and needles in percent.  || gcolwidth=50 (bars and spaces between bars are of equal size)
|-
| gheight|| no<br>[LJTRCGDM] || number|| 400 || Specifies height of graph.  || gheight=450 (graph is 450 pixel high)
|-
| gwidth|| no<br>[LJTRCGDM] || number|| 600 || Specifies width of graph. In color map mode width will be adapted to graph size. || gwidth=550 (graph is 550 pixel wide)
|-
| gtablestyle|| no<br>[TD] || string|| empty string || Specifies style information for HTML tables.  || gtablestyle=style="background-color:#fafafa;" (sets table background color to a light grey)
|-
| gtrheadstyle|| no<br>[TD] || string|| empty string || Specifies style information for HTML table head rows.  || gtrheadstyle=style="font-family:Verdana;font-weight:bold;" (sets font for table head line row as Verdana bold)
|-
| gtdheadstyle|| no<br>[TD] || string|| empty string || Specifies style information for HTML table heads cells.  || gtdheadstyle=style="font-size:12px;" (sets font size for table head line cells to 12px)
|-
| gtrstyle|| n<br>[TD]o || string|| empty string || Specifies style information for HTML table rows.  || gtrstyle=style="font-family:Verdana;font-weight:bold;" (sets font for table rows as Verdana bold)
|-
| gtdstyle|| no<br>[TD] || string|| empty string || Specifies style information for HTML table cells.  || gtdstyle=style="font-size:12px;" (sets font size for table cells to 12px)
|-
| ggpformat || no<br>[G] || string|| empty string || Specifies additional format information for "gpline" graphs. Linefeed is represented as "&#124;", "_" stands for blank character and "__" is converted to a single "_".  || ggpformat=set_locale_"de__DE" (sets date format to German)
|-
|}
<font size=1>Use with: [L] = line/step/bar graphs; [J] = javascript graphs; [T] = HTML tables; [R] = radar charts; [C] = color maps; [G] = GPline/GPstep/GPbar/GPneedle/GPpoint; [E] = cvs export; [D] = distribution chart; [M] = map</font>

====Graph Types====
Meteoplug supports different types of graphs. Letters in brackets do indicate which charting engine does support this type of graph: [F] = flash, [J] = javascript, [G] = gnuplot

=====Interactive Graphs=====
* '''Line''' [FJG]: Interactive line graph where all data point are connected by a straight line. Gaps in data ore omitted, no lines are drawn to fill gaps. 
* '''Minmax''' [FJ]: Interactive bar graph where top and bottom of bar represent a minimum and maximum value.
* '''Step''' [FJG]: Interactive line graph were connection of data points is done by vertical steps. Gaps in data are omitted, no lines are drawn to fill gaps.
* '''Bar''' [FJG]: Interactive bar graph
* '''Needle''' [FJG]: Interactive needle graph, width of needles is controlled by "swidth" setting.
* '''Radar''' [F]: Interactive radar chart
* '''Radar%''' [F]: Interactive radar chart that shows percentual distribution of values 
* '''Colormap''' [FJ]: Interactive two dimensional representation, where columns represent days, rows represent hour of day and color represents values of sensor. In color map mode these settings have a special meaning:
** ''glmin'' defines lower boundary of values expected. Values less or equal "glmin" will be displayed with color defined by "grmin".
** ''glmax'' defines upper boundary of values expected. Values greater or equal "glmax" will be displayed with color defined by "grmax".
** ''glmin'' defines lower boundary color as 6-digit hex RGB value.
** ''glmax'' defines upper boundary color as 6-digit hex RGB value. Depending on distance of a value to "glim" and "glmax" a color will be picked from line in HSV color space between colors "glmin" and "glmax".
** grunit defines 6-digit hex RGB value for points in time where no data available.
** ''res'' can be any valid specifier between "min5" and "day1". In most cases "hour1" will be suitable as it decomposes values of a day into a column with 24 stacked colors, each color representing value for that particular hour of the day. According to selected time frame, a number of additional columns is added to the right for following days.
** ''balloon'' must be set to 1 when using JavaScript to make mouse-over balloons appear.

When choosing distribution mode for charts with "xymode" setting, only these charts can be used: Line, Bar, Needle. All other interactive graphs cannot be used in distribution mode.

=====Non-Interactive Graphs=====
* '''GPline''' [G]: Non-interactive line graph which is generated by Gnuplot and delivered as ".png" image.
* '''GPstep''' [G]: Non-interactive line step graph which is generated by Gnuplot and delivered as ".png" image.
* '''GPbar''' [G]: Non-interactive bar graph which is generated by Gnuplot and delivered as ".png" image.
* '''GPneedle''' [G]: Non-interactive needle graph which is generated by Gnuplot and delivered as ".png" image.
* '''GPpoint''' [G]: Non-interactive point graph which is generated by Gnuplot and delivered as ".png" image.

Following fonts can be selected for GP graph types listed above. These fonts are provided by Meteoplug server to render a graph as ".png" picture: 
* andalemo
* arial, arialbd, arialbi, ariali, ariblk 
* comic, comicbd
* cour, courbd, courbi, couri, 
* georgia, georgiab, georgiai, georgiaz, 
* impact
* luximb, luximbi, luximr, luximri, luxirb, luxirbi, luxirr, luxirri, luxisb, luxisbi, luxisr, luxisri
* times, timesbd, timesbi, timesi
* trebuc, trebucbd, trebucbi, trebucit
* verdana, verdanab, verdanai, verdanaz
* webdings

Non-interactive graphs cannot be used in distribution mode (xymode setting).

=====HTML Tables=====
* '''Table''': HTML table, where each sensor is represented as a column and time stamped data sets are represented as rows. There are a couple of special settings for tables:
** ''gtablestyle'' defines table style.
** ''gtrheadstyle'' defines style of head line row.
** ''gtdheadstyle'' defines style of head line cells.
** ''gtrstyle'' defines style of rows.
** ''gtdstyle'' defines style of cells.
** ''glunit'' defines text to be displayed on time stamp column.
** ''grunit'' defines time stamp format in a notation used with gnu c function "strftime" ([http://www.kernel.org/doc/man-pages/online/pages/man3/strftime.3.html see manual]). Is used as format string for "x-value" in distribution mode charts.

HTML-Tables can be used in distribution mode (xymode set to a non-null value). As distribution charts are not showing data in respect to a time line, ''grunit'' has a slightly different meaning. ''grunit'' is used as a format string (linke in printf statements in language c). Format string can contain information how to format the floating point number that defines the buckets which show distribution of values in the chart. Example: "%.1fm/s" will show wind speeds for buckets as a floating point number with one decimal digit followed by "m/s". Having set "xstart" to 0.0 and "xinc" to 0.5 the buckets/rows will be named in the first column of the table like "0.0m/s", "0.5m/s", "1.0m/s" and so on.

=====CSV Exports=====
* '''Export''': CSV export, where each sensor is represented as a column and time stamped data sets are represented as rows. There are a couple of special settings for exports:
** ''glunit'' defines text to be used as separator between columns.
** ''grunit'' defines time stamp format in a notation used with gnu c function "strftime" ([http://www.kernel.org/doc/man-pages/online/pages/man3/strftime.3.html see manual]). Is used as format string for "x-value" in distribution chart mode.
** ''sname'' defines value to be taken for export if no value found for that specific sensor in database.
** ''sunit'' define additional characters to follow current value. This can be used to fill in some static text columns following actual sensor value. It is a useful feature to give columns default values where no data can be delivered from Meteoplug.

CSV exports can be used in distribution mode (xymode set to a non-null value). As distribution charts are not showing data in respect to a time line, ''grunit'' has a slightly different meaning. ''grunit'' is used as a format string (linke in printf statements in language c). Format string can contain information how to format the floating point number that defines the buckets which show distribution of values in the chart. Example: "%.1fm/s" will show wind speeds for buckets as a floating point number with one decimal digit followed by "m/s". Having set "xstart" to 0.0 and "xinc" to 0.5 the buckets/rows will be named in the first column of the csv export like "0.0m/s", "0.5m/s", "1.0m/s" and so on.

=====Maps=====
* '''Map''': defines a Google map with weather stations of your group as markers. On the right is an info window that displays weather data of weather station touched by the cursor on the map. Registered stations do also provide an interactive weather graph when clicked. 
** ''zoom'' defines zoom factor of the map. default for start is "4".
** ''ssel'' specifies a sensor value in form of a variable enclosed in square brackets. See [[#Numeric Variables]] and [[#Text Variables]] for details.

===Sensor Settings===
A Meteoplug graph can display data for a couple of sensors. As most sensors do present more than one type of data you have to define the sensor and what type of data to use from a sensor. All sensor definitions as preceded with a "s". To identify which settings are valid for which sensor, sensors are enumerated. Enumeration of sensors must start at 0 and must not have a gap in enumeration. Each sensor setting ends with an number that defines for which sensor these settings should apply. This number is represented by a "#" in the list of valid for sensor settings below:

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory<br>[applicable]''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| sid# || yes<br>[LJTRCGEDM] || see section "sensor IDs" || none || Defines the sensor to take data from. ||  sid0=wind0 (wind sensor)<br>sid1=th* (primary outdoor temp/hum sensor)
|-
| ssel# || yes, if not a "minmax" graph or "daycount" graph<br>[LJTRCGEDM]  || see section "sensor IDs" || none || Defines the sensor's value to be used for graphing. Has special meaning when doing maps, when this holds a text variable.||  ssel0=gustmax (maximum gust speed of wind sensor)<br>ssel0=[actual_min5_th0_temp] (actual temp for display on map)
|-
| sclient# || no<br>[LJTRCGEDM]  || name of the client that provides data || none || When using Meteoplug groups, you can use data from various clients of that group in one chart. Client parameter specifies what client to take the data from. ||  sclient0=citygroup-hamburg
|-
| sselmin# || yes, in case of a minmax graph<br>[LJG] || see section "sensor IDs" || none || Defines the sensor's value to be used for graphing as minimum value.||  sselmin0=tempmin (minimum temperature of a temp sensor)
|-
| sselmax# || yes, if a minmax graph<br>[LJG]  || see section "sensor IDs" || none || Defines the sensor's value to be used for graphing as maximum value. ||  sselmax0=tempmax (maximum temperature of a temp sensor)
|-
| sdaycount# || yes, if a "daycount" graph<br>[LJ]  || SQL conditional clauses mapped to predefined variable "day", see section "sensor IDs" for possible qualifiers || none || Defines the sensor's value to be used for graphing as daycount. This setting is defined for time resolution "month1" only. ||  sdaycount0=day.tempmax>=0.0&&day.tempmax<5.0 (counts number of days that meet condition: tempmax >= 0.0 and tempmax <5.0)
|-
| sname# || yes<br>[LJTRCGEDM]  || string || none || Defines the name of the sensor as displayed in the graph. Has special meaning in export mode as definition of value that should be written when no value available in database. ||  sname0=Outdoor_Temperature
|-
| stype# || no<br>[LJGD]  || see section "graph types"|| as defined by "gtype"|| Defines type of graph for this particular sensor. || stype0=line
|-
| swidth# || no<br>[LJRGD]  || number|| 0|| Defines line thickness for graph types: line, step, needle || swidth0=4 (line is 4 pixels wide)
|-
| syaxis# || no<br>[LJRG]  || left, right|| left|| Defines which y-axis to by used for current sensor. || syaxis0=r (right y-axis to be used)
|-
| scolor# || no<br>[LJRGD]  || hex number|| taken from internal table|| Defines color of sensor in the graph. || scolor0=AADDFF (sensor is displayed in a light blue)
|-
| scursorcolor# || no<br>[LJR]  || hex number|| same color as used for display of sensor data || Defines color of interactive cursor in the graph. || scursorcolor0=000000 (cursor is displayed in black)
|-
| sunit# || no<br>[TEDM]  || string || empty string || Defines unit text to be displayed as unit for sensor data in table columns. Defines Text to be added to current column in export mode. This allows to add static output on columns where Meteoplug can't deliver useful data. || sunit0=°C (numbers are displayed as temperatures)
|-
| slabel# || no<br>[J]  || string || no label used || Defines label to be displayed on top of each data item in the chart. Label can contain "[[value]]" for current data value or in min/max charts "[[low]]" and "[[high]]" for min resp. max values. || slabel0=°C (each data item of this sensor has the value added with "°C" on its top)
|-
| ssmooth# || no<br>[LJG]  || number || 0 || Defines if lines should be smoothed. || ssmooth0=1 (smoothing enabled)<br>ssmooth0=2 (defines bezier smoothing, available with graph type "gpline" only)
|-
| sstack# || no<br>[LJ]  || number || none || Defines a sensor this sensor's data should be stacked on when displayed. Just works for "line" graphs without "smooth" option. || sstack1=0 (data for sensor 1 is stacked on data for sensor 0)
|-
| sline# || no<br>[LJRGD]  || number 0-100 || 100 || Defines color intensity of line to be drawn. || sline0=100 (color of line for data of sensor 0 has full intensity)
|-
| sfill# || no<br>[LJRGD]  || number 0-100 || 100 || Defines color intensity of area below line. || sfill0=50 (color of area for data of sensor 0 has 50% intensity)
|-
| sconnect# || no<br>[LJRGD]  || number 0,1 || 0 || If set, missing data does not result in holes in the graph. Neighbouring points are always connected. || sconnect0=1 (graph for sensor 0 shows a perfectly connected line, even when some data is missing)
|-
| scursoralpha# || no<br>[LJR]  || number 0-100 || 100 || Defines color intensity of cursor. || scursoralpha0=0 (cursor is invisible)
|-
| slowbound# || no<br>[LJG]  || number || undefined || Defines a lower bound. Values below that are mapped to 0.0, values above or equal become 1.0. Offset and factor are applied after this operation. || slowbound0=100.0 (maps values below 100.0 to 0.0 and values of 100.0 and above to 1.0)
|-
| supbound# || no<br>[LJG]  || number || undefined || Defines an upper bound. Values below that are mapped to 1.0, values above or equal become 0.0. Offset and factor are applied after this operation. || supbound0=200.0 (maps values below 200.0 to 1.0 and values of 200.0 and above to 0.0)
|-
| slegend# || no<br>[LJG]  || number 0,1 || 1 || Defines if a sensor's values do appear in the legend: 0=no, 1=yes || slegend0=0 (no data in legend for sensor 0)
|-
| soffset# || no<br>[LJTRCGED]  || number || 0.0 || Defines offset to be applied to sensor data. || soffset0=32 (adds 32 to data)
|-
| sfactor# || no<br>[LJTRCGED]  || number || 1.0 || Defines factor to be applied to sensor data. || sfactor0=1.8 (multiplies with 1.8)
|-
| scumul# || no<br>[LJTRCGED]  || 0 or 1 || 0 || Defines if data should be used as is or being added up to display cumulative development. This can be used to generate stairway charts for rainfall over a time period. || scumul0=1 (use cumulative display for sensor 0)
|-
| sprec# || no<br>[LJTRCGED]  || number || depends on type of data || Defines number of decimals that should be used when printing values in graphs. When applied to timestamps it defines number of characters (from left when positive number, from right when negative number) to be displayed. || sprec0=1 (display data with 1 decimal) 
|-
| sprec# || no<br>[LJTRCGED]  || number || depends on type of data || Defines number of decimals that should be used when printing values in graphs. When applied to timestamps it defines number of characters (from left when positive number, from right when negative number) to be displayed. || sprec0=1 (display data with 1 decimal) 
|-
| sminmarker# || no<br>[J]  || string || none || Determines if lowest sensor value of selected time range should be marked with a star in the graph. Specified text is used as prefix for the value displayed inside the balloon connected to the star || sminmarker0=MIN (inserts a star on minimum value in the graph and sets balloon text to "MIN: 12.5°C", when lowest value was "12.5°C")
|-
| smaxmarker# || no<br>[J]  || string || none || Determines if highest sensor value of selected time range should be marked with a star in the graph. Specified text is used as prefix for the value displayed inside the balloon connected to the star || smaxmarker0=MAX (inserts a star on maximum value in the graph and sets balloon text to "MAX: 32.5°C", when highest value was "32.5°C")
|-
| smarker# || no<br>[J]  || string || star || Determines marker type to be used for this sensor. Defined types are "square", "circle". "diamond" and "star" || smarker0=circle (marks min/max vaules with a ircle in the chart)
|-
| smarkeralpha# || no<br>[J]  || number 0-100 || 100 || Determines intensity used for display of marker symbol (in oercent) || smarkeralpha0=50 (marker displayed with 50% intensity)
|}
<font size=1>Use with: [L] = line/step/bar graphs; [J] = javascript line/step/bar graphs; [T] = HTML tables; [R] = radar charts; [C] = color maps; [G] = GPline/GPstep/GPbar/GPneedle/GPpoint; [E] = csv export; [D] = distribution chart</font>

====Sensor IDs and Values====
Meteoplug supports different types of sensors. When you configure sensors on "Sensors" page you define IDs for these sensors. The same IDs are used as "sid" in graphing. Each of the sensor types present a different set of properties as listed below. Data for sensors of type "text" and "number" are not taken from the database but computed on request. While "number" sensors might be useful for graphing, "text" are limited to be used for HTML-tables, csv exports and template replacements.
When you use a fixed number like "th0" exactly that sensor is used. When you make use of wild-card notation "th*" the "th" sensor that has been specified on weather network page as your outdoor temp sensor will be used. This allows to write chart definitions that make use of your primary sensors, regardless which number you have given them on your "sensors" page. If no definition can be found on "weather network" page, the sensor with ID zero will be used as a default. 

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Sensor Type''' !! '''Sensor IDs''' !! '''Properties''' !! '''Comment'''
|- 
| Temp|| t0, t1,<br> ...,<br> t39 || temp, tempmin, tempmax, tempmintime, tempmaxtime || sensor reports temperature (°C) only 
|-
| Temp/Hygro|| th*, th0, th1,<br> ...,<br>th39 || temp, tempmin, tempmax, hum, hummin, hummax, dew, dewmin, dewmax, humi, humimin, humimax, heat, heatmin, heatmax, tempmintime, tempmaxtime, hummintime, hummaxtine, dewmintime, dewmaxtime ||  sensor reports temperature (°C)and humidity (%)
|-
| Temp/Hygro/Baro|| thb*, thb0, thb1,<br> ...,<br>thb39 || temp, tempmin, tempmax, hum, hummin, hummax, dew, dewmin, dewmax, humi, humimin, humimax, heat, heatmin, heatmax, press, pressmin, pressmax, seapress, seapressmin, seapressmax, tempmintime, tempmaxtime, hummintime, hummaxtine, dewmintime, dewmaxtime, pressmintime, pressmaxtime, forecast, forecasttext, forecasticon  ||  sensor reports temperature (°C), humidity (%) and air pressure (hPa), forecast information
|-
| Wind|| wind*, wind0, wind1,<br> ...,<br>wind9|| gust, gustmin, gustmax, wind, windmax, windmin, chill, chillmin, chillmax, maindir, highdir, gustmaxtime, windmaxtime, chillmintime, chillmaxtime<BR>maindirtext, highdirtext (for chart types "table" and "template" only) || sensor reports wind (m/s) and windchill data (°C)
|-
| Rain|| rain*, rain0, rain1,<br> ...,<br>rain9|| rate, ratemin, ratemax, total, days, ratemaxtime || sensor reports rain (mm)
|-
| UV|| uv*, uv0, uv1,<br> ...,<br>uv9|| uvi, uvimin, uvimax, uvimaxtime || sensor reports UV data (uvi)
|-
| Solar|| sol*, sol0, sol1,<br> ...,<br>sol9|| rad, radmin, radmax, radmaxtime || sensor reports solar data (W/qm)
|-
| Data|| data0, data1,<br> ...,<br>data39 || val, valmin, valmax, sum, summin, suminc, rise, fall, valmintime, valmaxtime || sensor reports numerical data, ''sum'' is sum of data, ''suminc'' is sum of increments, ''summin'' is sum of increments per minute, ''rise'' is number of events where data changes from falling to rise, ''fall'' is number of events where data changes from rising to fall. 
|-
| text || misc || longitude, latitude || report longitude or latitude as a decimal number. Does ignore given time stamps and time resolutions.
|-
| text || misc || localtime, utctime || report recent time in format "YYYY-MM-DD hh:mm:ss". Does ignore given time stamps and time resolutions. 
|-
| text || misc || uploadlocaltime, uploadutctime|| report time of last data upload in format "YYYY-MM-DD hh:mm:ss". Does ignore given time stamps and time resolutions.
|-
| text || misc || timestamp || reports time stamp used for request in format "YYYY-MM-DD hh:mm". This can be used to find out an absolute point in time that corrsponds to a given relative time description. 
|-
| number || misc || lunarphasepercentage || reports of visibility of moon as percentage (100% = full moon, 0% = new moon). 
|-
| number || misc || lunarphasesegment || reports a number of 0 to 7 which represents lunar phase (0 = new moon, 4 = full moon). 
|-
| number || misc || lunaragedays || reports a number of days since last new moon. 
|-
| text || misc || lunarphasetext || reports a test string that represents a lunarpahase. 8 Lunar phases are defined. Strings can be adapted to specific needs by "phasetextlist" definition. 
|-
| text || misc || lunarphaseicon || reports a HTML image tag that links to an image to be used for representation of lunarpahases. URLs can be adapted to specific needs by "phaseiconlist" definition. 
|-
| number || misc || daylengthstandardhours, daylengthcivilhours, daylengthnauticalhours || reports number of hours a day has. hours come with decimals. Computation is available in standard, civil or nautical mode.
|-
| text || misc || daylengthstandardtime, daylengthciviltime, daylengthnauticaltime || reports number of hours and minutes a day has in "hh:mm" notation. Computation is available in standard, civil or nautical mode.
|-
| text || misc || sunrisestandardutctime, sunsetstandardutctime, sunrisestandardlocaltime, sunsetstandardlocaltime, sunriseciviltwilightutctime, sunsetciviltwilightutctime, sunriseciviltwilightlocaltime, sunsetciviltwilightlocaltime, sunrisenauticaltwilightutctime, sunsetnauticaltwilightutctime, sunrisenauticaltwilightlocaltime, sunsetnauticaltwilightlocaltime || reports time of sunrise and sunset in "hh:mm" notation. Computation is available in standard, civil or nautical mode and in UTC and local time.
|-
| text || misc || moonriseutctime, moonsetutctime, moonriselocaltime, moonsetlocaltime || reports time of moon rise and moon set in "hh:mm" notation. Computation is available in UTC and local time.
|-
| text || misc || mac || reports MAC of the sending client.
|-
|}

===Template Settings===
Beside generation of graphs and tables it might also be useful to allow for handling of templates. Template mechanism works like this:
* Meteoplug loads a textfile somewhere located on the Internet (will mostly be HTML content) or inside the chart definition following the "template=inline" statement
* Meteoplug scans the file or data for existence of specific Meteoplug weather variables.
* Meteoplug replaces these variables by corresponding weather data
* Meteoplug returns the file or data (filled with data) to the requester

Template handling is realized in Meteoplug by a chart definition that makes use of the following name-value pairs.

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| template || yes || URL in complete syntax including "http://" or "inline" || none || URL of template to be used or "inline" tag, which indicates that template data follows after template statement || template=<nowiki>http://www.meteoplug.com/xyz.html</nowiki> 
|-
| content || no || http content type description || text/html || defines what type of content is delivered || content=text/plain (content=raw will supress content header information to be sent out) 
|-
| picture || no || type of picture || no picture template, html template is default || defines if URL given as template is a picture definition to be handled by ImageMagick's convert program and defines type of picture || picture=png 
|-
| dirlist<BR>phasetextlist<BR>phaseiconlist || no || lists as defined in [[#Chart Settings]] || see [[#Chart Settings]] ||  define text values or URLs to be taken instead of default settings || dirlist=N,NNO,NO,ONO,O,OSO,SO,SSW, S,SSW,SW,WSW,W,WNW,W,NNW
|-
| debug || no || 0 = normal operation<BR>1 = show replacement of variables and corresponding errors || 0 || allows for debugging of variable replacement || debug=1 (enables debug mode)  
|-
|}

Variables that Meteoplug replaces in templates are starting with "[" and end with "]". There are two types of variables, text and numbers which are handled slightly different. Any "[...]" enclosed strings that do not syntactically match a Meteoplug variable definition will not be touched. 

====Special Variables====
Beside the regular weather data values of numerical or textual type there are a couple of special variables returning usefull information:
* '''drawtoken_<chartname>''' returns the encoded draw token for the current user and the chart defined as <chartname>.
* '''engine''' returns the display engine currently used by the chart (can be "flash", "javascript" or "gnuplot").

====Numeric Variables====
Numeric variables are composed of the following fields, separated by an underscore "_":
* '''time stamp''': This can be any point in time given in "YYYYMMDDhhmmss" notation. When the last recorded data is meant, the string "actual" has to be used instead of a time stamp. Instead of absolute time stamps you can also use relative timestamps as explained in paragraph [[#Time Ranges]]. Please notice, that in this context relative timestamps are not interpreted as ranges up to the current date/time, but as a range where the relative timestamp gives the starting point. Endpoint is determined by start point plus the resolution specification. Assume your time is 13:17, then relative time stamp "3H_hour1_..." will select timeframe "11:00 - 11:59" as "3H" points to 3 hours in the past ("3H" is taking actual hour as an already started hour additional into consideration, "-3H" will select "10:00 - 10:59" omitting the actual hour). Following that rule, "3H_min10_..." will select "11:00 - 11:09" as time frame and "-1D_day1_.." will select yesterday's data. As a side effect not all relative timeframe definitions make sense here. Lower letter definitions can't be used and a given resolution has to be smaller or equal than the startpoint definition, i.e. "3D_month1_..." is not making sense, as the "month1" resolution is not alligned to the beginning of a day, selected by "3D". Using inappropriate timeframe defintions will lead to empty results.  
* '''resolution''': Meteoplug uses raw logged data to generate a hierarchy of various time buckets. Below you find time buckets available in Meteoplug. These are the same resolution settings as can be used for graphing. "Time stamp" and "resolution" strongly interact. As not all combination do make sense, it is important to understand how it works together. Assume that you are looking for some daily data (like daily max temperature or rainfall) for x-mas 2009, then "time stamp" will be "20091225000000" and "resolution" will be "day1". To get data about actual month "time stamp" will be "actual" and resolution will be "month1".
** min5 (5 minutes time frame)
** min10 (10 minutes time frame)
** min15 (15 minutes time frame)
** min30 (30 minutes time frame)
** hour1 (hourly time frame)
** hour6 (6 hour time frame)
** day1 (daily time frame)
** month1 (monthly time frame)
** year1 (yearly time frame)
** alltime (time frame covering all ever logged data)
* '''sensor id''': This determines the sensor to take data from. It is in the usual format as used in graphing specification, like "th0", "wind0", etc. You can also make use of default primary sensor names like "th*", "wind*", etc. When your station is part of a Meteoplug group, you can reference data from any client in the group by a "@<clientname>" suffix. Example: [actual_min5_th0@citygroup-hamburg_temp_1]
* '''selector''': Which selectors are available depends on selected type of sensor. List of defined selectors per sensor is lined out in [[#Sensor IDs and Values]]. If you are selecting a text variable or a numeric variable is determined by the selector you are using. When the selector is named "time" or "text" at the end it is a time stamp or other string and therefore a text variable. All other variables are of numeric type. There is one additional selector named "ts" (means time stamp) that reports time stamp of data, which also is regarded as a text variable.
* '''precision''': This defines how many decimal digits should be displayed. Decimals are just cut off, no rounding rules are applied. Default is one digit.
* '''factor''': Defines a factor to be applied to the value. Default factor is 1.0.
* '''offset''': Defines an offset to be applied to values. Default offset is 0.0.

An example for a numeric variable constructed according rules above is [actual_day1_th0_tempmax_1_1.8_32], which will be replaced by max temperature of current day in degree Fahrenheit (Celsius value * 1.8 + 32) with one decimal digit precision.

====Text Variables====
Fields used for definition of text variable are mainly the same as with numerical variables. Fields "time stamp", "resolution", "sensor id", "selector" are exactly the same. "selector" just needs to be "ts" or something ending with "time" to select a text variable. Fields "precision", "factor" and "offset" are not defined with text variables, but new fields "index" and "length" are added instead.
* '''index''': Index defines a position in the text where to start with reading. Default is 0 which is equivalent to start of text.
* '''length''': This defines how many character to take from the text. Default is to take the complete string.

An example for a text variable is [actual_day1_th0_tempmaxtime_11_5] which cuts off the "hh:mm" portion of the time stamp of highest temperature reading of recent day. Time stamps do have format "YYYY-MM-DD hh:mm:ss" when reading them from Meteoplug's database.

====Additional Features====
A ":" followed by a string can be added at the end of every variable. The string is used as a default replacement, when no value can be derived from Meteoplug's database for a given variable. 

Example: [20100101000000_day1_th0_tempmax_1_1.8_32:no data] does result in "no data" when there is no maximum temperature available for new year's day 2010 in Meteoplug's database. Default setting for missing variable data is "--".

A "#" followed by a number indicates the maximum age of sensor data allowed to regard this sensor data as still being valid. This is very usefull in combination with "actual" timeframes.

Example: [actual_min5_uv*_uvi_1:outdated#3600] reports the average uv index of last 5 minute bucket available, as long as it is not older than 3600 seconds, otherwise "outdated" is returned.

===Maps===
When using Meteoplug's map feature some additional parameters can be used.

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| outdate || no|| seconds since last data from stations || 15 days (15*86400 seconds) || This defines maximum age a connect from the Meteoplug client is allowed to have in order to be still displayed on the map || outdate=2592000 (defines a clip level of 30 days) 
|-
| latitude || no || decimal latitude || your stations latitude || defines the center of the map || latitude=59.234  
|-
| longitude || no || decimal longitude || your stations longitude || defines the center of the map || longitude=10.456  
|-
| mapchart || no || name of a defined map (should be defined for all users of the group) || "_mapaio" || you can direct the weather data graph when clicking onto a marker in the map to an alternative chart definition. Might only be useful in dedicated groups, where your own chart definitions are valid for the whole group per default. || mapchart=mychart (defines mychart to be used on maps) 
|}

===URL Parameters===
To allow a more flexible use of defined charts, some of the chart parameters can be provided when calling a chart definition. Usually you receive a chart you defined by calling "<nowiki>http://www.meteoplug.com/cgi-gin/meteochart.cgi?drawtoken=...</nowiki>". Meteoplug derives user and name of the requested chart from the encrypted draw token and returns the chart. You can also a these additional URL parameters behind the drawtoken.
{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Applicable''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| timeframe || [INCH] || timefame definition as described [[#Time Ranges]] || as given in the chart definition || selects th time frame the cahrt definition gets applied to. || timeframe=1M (current month) 
|- 
| resolution || [INCH] || time resolution as defineded [[#Time Resolution]] || as given in the chart definition || defines granularity of data used for the chart. Only distinct values are allow. || resolution=10min (chart shows data in 10 minute buckets) 
|-
| engine|| [IND] || one of "javascript", "flash, "gnuplot" || flash || meteoplug provides flash and javascript engines for drawing interactive charts and live data. As long as the cart definition use generic types (like line, bar, needle, step, ...) the engine setting does determine which engine to use. If engine specific types (like gpline, ...) are used, calling the chart with a different engime definition will trhow an error. || engine=javascript (use javascript variants of interactive charts) 
|- 
| latitude || [M] || decimal latitude || your stations latitude || defines the center of the map || latitude=59.234  
|-
| longitude || [M] || decimal longitude || your stations longitude || defines the center of the map || longitude=10.456  
|-
| all || [M] || 0 or 1 || 0 || defines if map of a group does include public stations (all=1) or does show group only stations (all=0) || all=1  
|-
| latitudemin || [M] || decimal latitude || minimal latitude of stations to be shown on map || can be used to restrict geografical range of stations to be shown || latitudemin=58.0 
|-
| latitudemax || [M] || decimal latitude || maximal latitude of stations to be shown on map || can be used to restrict geografical range of stations to be shown || latitudemin=60.0 
|-
| longitudemin || [M] || decimal longitude || minimal longitude of stations to be shown on map || can be used to restrict geografical range of stations to be shown || longitudemin=8.0 
|-
| longitudemax || [M] || decimal longitude || maximal longitude of stations to be shown on map || can be used to restrict geografical range of stations to be shown || longitudemax=10.0 
|-
| client || [INCHMD] || a meteoplug client name || client as specified in draw token || allows selecting a different client of the same meteoplug group. This is only applicable for clients of the same group || client=beach1
|- 
| zoom || [IM] || number between 1 and 15 on maps or fraction of time frame to be initially displayed on interactive charts || 4 (maps), MAX (interactive charts) || defines how close to zoom in on maps and what fraction of the time frame to display on interactive charts || zoom=1D (start displaying actual day on interactive chart)
|}
<font size=1>Use with: [I] = any interactive chart; [N] = non-interactive chart; [C] = CSV exports; [H] = HTML tables; [M] = Maps; [D] = Live display</font>

  
Values for "latitude", "longitude" (in degrees with decimals) and "zoom" (as integer from 1 to 15) can also be given as URL parameters when calling the chart generator.

==Display Language==
Display language used in Meteoplug is derived from a subset of fusionwidget options. It can be used very similar as if you would define widgets directly in funsionwidgets. This is especially true for the options that control the look and feel of the meters and gauges. Secification of values to be selected for display is similar to how Meteoplug does handle graphs. So it might be a good idea, to get familar with Meteoplug graphing first, before stepping into details with displays. 

Display commands are represented as name-value pairs separated by "=". No spaces are allowed between name, "=" and value. Name-value pairs are separated by white space characters (blanks and/or new lines). As a result you can place each name value pair into a new line or you can define multiple name-value pairs in one line separated by white spaces. 

When value should include a space character (might be useful for sensor names), you have to use underscore "_" instead of space. Underscores will be converted back to spaces when being displayed. When you need a underscore "_" not to be converted into space, type two underscores "__", which will be converted to one underscore "_". If you need a line feed character in the string, use vertical bar character "&#124;" instead.  

You can add comments to a display definition. When Meteoplug hits a "#" when it expects a new name value pair, then rest of current line will be skipped and not evaluated. This allows you to type any text you like after comment character "#". As you can see, the coming up examples make heavy use of commenting.

When you specify numbers the decimal separator is "." regardless what language you might have selected.

There is one important difference compared to graph definitions. When you define a widget, you specify the type of widget (i.e. Thermometer) in the usual name-value pair mimic. The lines following that special name-vaue pair are not handled as name-value pairs anymore but the entire followon text is taken as is and interpreted as XML data for description of the widget options. This XML is directly handed over to the corresponding fusionwidget flash widget. Meteoplug does no further processing on that. The end of XML data in the display definition is marked by an empty line. After that Meteoplug is in name-values piar mode again and operation continues in normal parsing mode until next widget name-value pair. Breaking the name-value pair logic by that might be seen as not very elegant, but it allows easy adaption of examples from fusionwidgets repository, which might be regarded as a major advantage. What options the choose for in context of each of the widgets is defined [http://www.fusioncharts.com/widgets/docs/ here].
 
As with graph definitions, the definition of displays is done on three levels
* on '''display settings''' are valid for all widgets in the display.
* on '''widget settings''' define characteristics of a single widget.
* on '''sensor settings''' give paramters for use of sensors for a specific widget.


===Display Settings===
A display definition should start with settings that are valid for all widgets in the display and all sensors used in the widgets. Meteoplug provides these name-value pairs to define display settings

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory [Applicable]''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|-
| restrictip || no [TCAHS] || WAN IP of requesting computer || none || restricts access to the chart to a certain requesting IP. When requesting IP does not match an error is displayed.  || restrictip=81.123.23.77 (restricts access to given IP)
|-
| bgcolor || no<br>[TCAHS] || string || white || Specifies background color in RGB style || bgcolor=#0000FF (blue)
|-
| title || no<br>[TCAHS] || string (blank chars replaced with "_")  || "Meteoplug_Chart" || Defines HTML title of the chart || title=temp_of_today
|-
| height || no<br>[TCAHS] || number  || 400 || Defines height of display in pixels || height=200
|-
| width || no<br>[TCAHS] || number  || 600 || Defines width of display in pixels || width=400
|} 
<font size=1>Letter in brackets indicate applicability: [T] = thermometer; [C] = cylinder; [A] = angular gauge; [H] = horizontal gauge; [S] = status pad</font>

===Widget Settings===
Widget settings have a meaning to an overall display comparable to graph settings for a chart. That means, each single display element (thermometer, gauge, etc.)  is defined by a stack of widget definitions. These definitions can be used with widgets, each of them needs the widget number as a suffix. A missing widget number suffix is interpreted as suffix "0". As a lot of the definitions are borrowed from graph definitions, we kept the prefix "g" for all widget commands.

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory [Applicable]''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| gtitle || no<br>[TCAHS] || string (blank chars replaced with "_") || none || reserved for future use || gtitle=Outdoor_Temp
|-
| gheight || no<br>[TCAHS] || number || 400 || specifies height of widget  || gheight=450 (widget is 450 pixel high)
|-
| gwidth || no<br>[TCAHS] || number || 600 || specifies width of widget || gwidth=550 (widget is 550 pixel wide)
|-
| gtimeout || no<br>[TCAHS] || number || 1800 || specifies update age in seconds to determine a widget being outdated and not showing data anymore || gtimeout=900 (timeout after 15 mins)
|-
| gcss || no<br>[TCAHS] || string (blank chars replaced with "_") || none || gives css information used for widget placement and style || gcss=position:absolute;_top:0;_left:0 (position widget in upper left corner)
|-
| gwidget || yes<br>[TCAHS] || Thermometer, Cylinder, AngularGauge, HLinearGauge, Status || none || defines which widget to use, followon lines define widget options in XML style as described by [http://www.fusioncharts.com/widgets/docs/ fusionwidget documentation] || gwidget=AngularGauge (select angular gauge type from fusionwidgets selection)
|}
<font size=1>Letter in brackets indicate applicability: [T] = thermometer; [C] = cylinder; [A] = angular gauge; [H] = horizontal gauge; [S] = status pad</font>

The example below illustrates how the different kinds of widgets can be used to setup a live data dashboard.

[[file:live-board.png]]

====Thermometer Widget====
This widget can handle just one value to display. Example above uses this widget for display of temperature, chill and dew point. Description of options to control look of the widget can be directly taken from corresponding fusionwidget documentation named "Thermometer Gauge" ([http://www.fusioncharts.com/widgets/docs/ link])

====Cylinder Widget====
Like the thermometer widget this widget also can handle just one value but brings a different look and can be displayed in a pseudo 3D style from various angles of view. Example above does use this widget type for display of daily rainfall. Description of options to control look of the widget can be directly taken from corresponding fusionwidget documentation named "Cylinder Gauge" ([http://www.fusioncharts.com/widgets/docs/ link])

====Angular Gauge====
This widget is usefull to display values in a tachometer like style. Example above makes use of this widget for wind direction and barometric pressure. The widget supports multiple dials and various design and annotation options. Description of options to control look of the widget can be directly taken from corresponding fusionwidget documentation named "Angular Gauge" ([http://www.fusioncharts.com/widgets/docs/ link])

====Linear Gauge====
This widget is similar to the angular gauge - but without curves. Example above uses this for wind speed, humidity, solar radiation and UV index. It also supports display of multiple values and various design and annotation options. Description of options to control look of the widget can be directly taken from corresponding fusionwidget documentation named "Linear Gauge" ([http://www.fusioncharts.com/widgets/docs/ link])

====Status Pad====
This is not something from fusionwidgets, but a very simple widget that can bring additional text on the display. It is particular useful to show some info like date and time of last display update. Example above does use this widget in the upper left corner. These patterns can be used as text variables:
* '''%Y''' represents the year, in 4 digit representation.
* '''%M''' represents the month (01-12).
* '''%D''' represents day of month (01-31).
* '''%h''' represents hours (00-23).
* '''%m''' represents minutes (00-59).
* '''%s''' represents seconds (00-59).
* '''%I''' represents the computed update interval. This can be less frequent than the regular 10 second interval when multiple Users are polling data for a specific station. Update rate adapts to intensity of usage to keep overall server performance in line. Example above specifies output message with string "last update %h:%m:%s (%I secs)".

===Sensor Settings===
Depending on the choosen widget, a Meteoplug widget can display data for a couple of sensors. As most sensors do present more than one type of data you have to define the sensor and what type of data to use from a sensor. All sensor definitions as preceded with a "s". To identify which settings are valid for which sensor, sensors are enumerated. Enumeration of sensors must start at 0 and must not have a gap in enumeration. Each sensor setting ends with an number that defines for which sensor these settings should apply. This number is represented by a "#" in the list of valid for sensor settings below:

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Name''' !! '''Mandatory''' !! '''Value''' !! '''Default''' !! '''Explanation''' !! '''Example'''
|- 
| sid# || yes<br>[TCAH] || see section "sensor IDs" || none || defines the sensor to take data from ||  sid0=wind0 (wind sensor)<br>sid1=th* (primary outdoor temp/hum sensor)
|-
| ssel# || yes<br>[TCAH]  || see section "sensor IDs" || none || defines the sensor's value to be used for widget display ||  ssel0=gust (gust speed of wind sensor)
|-
| sclient# || no<br>[TCAH]  || name of the client that provides data || none || When using Meteoplug groups, you can use data from various clients of that group in one widget. Client parameter specifies what client to take the data from. ||  sclient0=citygroup-hamburg
|-
| soffset# || no<br>[TCAH]  || number || 0.0 || Defines offset to be applied to sensor data. || soffset0=32 (adds 32 to data)
|-
| sfactor# || no<br>[TCAH]  || number || 1.0 || Defines factor to be applied to sensor data. || sfactor0=1.8 (multiplies with 1.8)
|-
| sprec# || no<br>[TCAH]  || number || depends on type of data || Defines number of decimals that should be used when printing values in widgets. || sprec0=1 (display data with 1 decimal) 
|}
<font size=1>Letter in brackets indicate applicability: [T] = thermometer; [C] = cylinder; [A] = angular gauge; [H] = horizontal gauge; [S] = status pad</font>

====Sensor IDs and Values====
Meteoplug supports different types of sensors. When you configure sensors on "Sensors" page you define IDs for these sensors. The same IDs are used as "sid" for display in widgets. Each of the sensor types present a different set of properties as listed below. 
When you use a fixed number like "th0" exactly that sensor is used. When you make use of wild-card notation "th*" the "th" sensor that has been specified on weather network page as your outdoor temp sensor will be used. This allows to write chart definitions that make use of your primary sensors, regardless which number you have given them on your "sensors" page. If no definition can be found on "weather network" page, the sensor with ID zero will be used as a default. 

{| style="background:none" border="1" cellpadding="5" cellspacing="0"
! '''Sensor Type''' !! '''Sensor IDs''' !! '''Properties''' !! '''Comment'''
|- 
| Temp|| t0, t1,<br> ...,<br> t39 || temp, tempmin, tempmax || sensor reports temperature (°C) and daily min/max values only 
|-
| Temp/Hygro|| th*, th0, th1,<br> ...,<br>th39 || temp, tempmin, tempmax, hum, hummin, hummax, dew, dewmin, dewmax ||  sensor reports temperature (°C) and humidity (%) and dewpoint (°C) and daily min/max values for these
|-
| Temp/Hygro/Baro|| thb*, thb0, thb1,<br> ...,<br>thb39 || temp, tempmin, tempmax, hum, hummin, hummax, dew, dewmin, dewmax, seapress, seapressmin, seapressmax ||  sensor reports temperature, dew point (°C), humidity (%) and air pressure (in hPa) with daily min and max)
|-
| Wind|| wind*, wind0, wind1,<br> ...,<br>wind9|| dir, wind, gust, gust10min, gustday, chill, chillmin, chillmax  || sensor reports wind dir, average wind sped (wind), current wind (gust), highest gust last 10 minutes (gust10min), highest gust of day (gustday) and wind chill (°C) inclusing min/max, all speeds in m/s
|-
| Rain|| rain*, rain0, rain1,<br> ...,<br>rain9|| rate, total, day, month, year || sensor reports rain rate (mm/h), total counter value (total), sum of day, month, year in mm.
|-
| UV|| uv*, uv0, uv1,<br> ...,<br>uv9|| uvi, uvimax || sensor reports current UV data (uvi) and maximum of day (uvimax)
|-
| Solar|| sol*, sol0, sol1,<br> ...,<br>sol9|| rad, radmax || sensor reports current solar data (rad) in W/qm and maximum of day (radmax)
|-
| Data|| data0, data1,<br> ...,<br>data39 || val, valmin, valmax || sensor reports numerical data inclunding min/max of day
|}

==Examples==
You will find examples for all graph and display types in the [[gallery]] of this wiki. You can see the graphs and you can inspect definition that created the graph or display. Definitions are commented, which should allow to get a better understanding how graphing works.