line_chartΒΆ
Description
Line-chart using jqPlot library. Allows to display arbitrary number of plots on single chart, with automatic generation of trend lines for them (which is turned on by default).
Content
data = {
"subtitle": "<subtitle_text">,
"description": "<description_text>",
"series_list": [[<series1>], [<series2>], [<series3>], ...]
}
where:
- subtitle, description
Additional text fields for charts descriptions (optional - you can pass empty strings here).
- series_list
Data for line-charts in a form of list of series, where each series designates single chart; each element of a given series is a pair [x_axis_value, y_axis_value].
Example:
curl http://localhost:7272/api/v0.1/<api_key>/push
-X POST
-d "tile=line_chart"
-d "key=example_line"
-d 'data={"subtitle": "averages from last week",
"description": "Sales in our dept",
"series_list": [[["23.09", 8326], ["24.09", 260630], ["25.09", 240933], ["26.09", 229639], ["27.09", 190240], ["28.09", 125272], ["29.09", 3685]],
[["23.09", 3685], ["24.09", 125272], ["25.09", 190240], ["26.09", 229639], ["27.09", 240933], ["28.09", 260630], ["29.09", 108326]]]}'
– this will give two plots on a single chart (on x-axis there will be “23.09”, “24.09”, “25.09” and so on) with heading “Sales in our dept” and subtitle “averages from last week”.
Configuration
value = {<jqplot_config>, simplify: <simplify_config>}
where:
- jqplot_config
Configuration params in the form described by jqPlot documentation.
Example:
curl http://localhost:7272/api/v0.1/<api_key>/tileconfig/example_line
-X POST
-d 'value={"grid": {"drawGridLines": true,
"gridLineColor": "#FFFFFF",
"shadow": false,
"background": "#000000",
"borderWidth": 0}}'
– this will set up the grid (in white color), black background and will turn off shadow effects as well as borders.
simplify_config
simplify_config = {
tolerancy: 10,
data_points_limit: 50, // we will TRY to achieve lower number of data points than this
max_simplifying_steps: 5,
simplify_step_multiplicator: 1.5
};
Each option is self-describing. This feature tries to optimize dataset to achieve points count lower than data_points_limit. If simplify_config is not set, there won’t be any simplify process at all (you will just have your raw data displayed).
curl -X POST http://127.0.0.1:7272/api/v0.1/dev_key/tileconfig/test_line
-d 'value={"simplify": {"tolerancy": 2}}'
Note
In case of displaying multiple plots on a single chart (e.g. for more than one data series) you have to keep in mind that the x_axis_value values should be the same for all of those plots.