Property graph

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

Configuring the widget

Field	Description
Graph 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	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. Think key Thing property Graph type Color Remove will take out that 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 choose 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.

Interacting with the widget

If you are displaying the legend, moving the mouse over the legend will highlight the property on the graph. Clicking on the color in the legend will toggle the line on and off in the chart.
Mousing over a point on the line will display the date-time, color, property, and value of that point.
Mousing over an alarm vertical line will display the date-time, color, and alarm state.

Data Bracketing Algorithm

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.