Property Graph

The property graph widget displays a mixed series graph of values for multiple properties.


Field	Description
Name	The name of the graph, shown at the top of the widget.
Thing key	The thing key this widget should respond to. If left blank, the widget will inherit the thing key from the dashboard.
Thing property (mandatory)	The property of the thing to be shown by the widget.
Graph type	Specifies how the property graph should be presented. Line will show the property as straight lines connecting points. Spline will show the property as a curved line connecting points. Step will show the property as a series of lines forming steps between points. Area will show the property as a line with a shaded portion of the graph. Area-spline will show the property as a curved line with a shaded portion of the graph. Area-step will show the property as a series of lines forming steps between points with a shaded portion of the graph. Bar will show the property as a bar starting at 0 and extending to its value.
Color	The color to be used for the property on the graph. The acceptable input is a HEX code. A color picker is provided.
Add property	An action to create another property configuration section with the following fields and a remove link. Thing key Thing property Graph type Color Remove removes the property configuration section from the form.
Series	Allows you to select how you would like to see the series of data. History - Historical points of data. Day, Hour - Aggregates the data by day or hour for consumption.
Calculation	When series is set to history, you can select how to display your aggregate data.
Show points	If the widget should show points on each of the graphs.
Show single property average	Shows an average line for a single property. Only available when one property being graphed.
Y axis max	The maximum Y axis value the widget is to be expecting.
Y axis min	The minimum Y axis value the widget is to be expecting.
Unit	The unit value for the properties.
Show legend	If the widget should show the legend for the graph.
Show border	If the widget should have a border around it.

If you are displaying the legend, moving the mouse pointer over the legend highlights the property on the graph. Clicking the color in the legend switches the line on and off in the chart.
Moving the mouse pointer over a point on the line displays the date-time, color, property, and value of that point.
Moving the mouse pointer over an alarm vertical line displays the date-time, color, and alarm state.

Graph widgets are subject to a data bracketing algorithm. This is done to alleviate excessive white space in the graph as a result of data gaps between the start of the time-series and the first data point, and the between the last data point and the end of the time-series.

The average time interval is calculated for the number of points in the date range and then a 1.5 multiplier is applied to define an acceptable margin.
If the first reported point occurs later than the graph's start date by an amount greater than the acceptable margin, an extra data point with the same first value will be inserted at the start of the time-series.
If the last reported point occurs earlier than the graph's end date by an amount greater than the acceptable margin, an extra data point with the same last value will be inserted at the end of the time-series.

These extra data points are only inserted for the purpose of the display. On refresh of the graph, these extra data points are not retained. The data bracketing algorithm is applied again on the new time-series data set to determine if extra data points are required.