From 60c073a6ed451cf91d9877a3305407756b9ffdce Mon Sep 17 00:00:00 2001 From: Tomasz Mieszkowski Date: Thu, 28 Aug 2014 08:54:15 +0200 Subject: Tipboard got open-sourced! --- doc/tile__advanced_plot.rst | 140 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 140 insertions(+) create mode 100644 doc/tile__advanced_plot.rst (limited to 'doc/tile__advanced_plot.rst') diff --git a/doc/tile__advanced_plot.rst b/doc/tile__advanced_plot.rst new file mode 100644 index 0000000..afeabab --- /dev/null +++ b/doc/tile__advanced_plot.rst @@ -0,0 +1,140 @@ +================= +``advanced_plot`` +================= + +.. image:: img/smaller/advanced-plot.png + +**Description** + +This tile is for more demanding users. It basically allows to display arbitrary +type of chart/plot from the `jqPlot `_ library, along +with the title and description (both are optional). + +Before you start experimenting with jqPlot library, we suggest to familiarize +yourself with `this manual +`_. After that +you should check out `options tutorial +`_ +and `options summary `_. + +Here you will find `some examples `_. + +**Content** + +:: + + "data" = { + "title": "", + "description": "", + "plot_data": "" + } + +where: + +.. describe:: title, description + + Title and description (subtitle) for the tile. + +.. describe:: plot_data + + Data that will be fed directly to your plot. Its form depends on the + specific type of plot that you are going to use - see jqPlot's documentation + for the details. + +Example (using horizontal `Bar Chart +`_ - third example +from the top):: + + curl http://localhost:7272/api/v0.1//push + -X POST + -d "tile=advanced_plot" + -d "key=" + -d 'data={"title": "Metric Tons per Year", "description": "", + "plot_data": [[[2,1], [4,2], [6,3], [3,4]], + [[5,1], [1,2], [3,3], [4,4]], + [[4,1], [7,2], [1,3], [2,4]]]}' + +.. note:: + + Keep in mind that ``advanced_plot`` can display arbitrary charts from jqPlot + library, and more than often they are quite different when it comes to the + parameters required etc. + +**Configuration** + +:: + + value = { + "value": "" + } + +where: + +.. describe:: value + + Raw configuration that will be passed directly to jqPlot and which should + obey the rules defined by the jqPlot library. Internally, this config will + be passed as ``$.jqplot(some-container, some-data, our-config)``. + + If such configuration contains one of jqPlot's renderers, its name should be + passed as a string, according to the table below: + + +--------------------------------------+-------------------------------+ + | jqPlot's renderer | string to send | + +======================================+===============================+ + | ``$.jqplot.BarRenderer`` | ``"BarRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.BlockRenderer`` | ``"BlockRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.BubbleRenderer`` | ``"BubbleRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.CanvasAxisLabelRenderer`` | ``"CanvasAxisLabelRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.CanvasAxisTickRenderer`` | ``"CanvasAxisTickRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.CanvasTextRenderer`` | ``"CanvasTextRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.CategoryAxisRenderer`` | ``"CategoryAxisRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.DateAxisRenderer`` | ``"DateAxisRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.DonutRenderer`` | ``"DonutRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.EnhancedLegendRenderer`` | ``"EnhancedLegendRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.FunnelRenderer`` | ``"FunnelRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.LogAxisRenderer`` | ``"LogAxisRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.MekkoAxisRenderer`` | ``"MekkoAxisRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.MekkoRenderer`` | ``"MekkoRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.MeterGaugeRenderer`` | ``"MeterGaugeRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.OhlcRenderer`` | ``"OhlcRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.PieRenderer`` | ``"PieRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.PyramidAxisRenderer`` | ``"PyramidAxisRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.PyramidGridRenderer`` | ``"PyramidGridRenderer"`` | + +--------------------------------------+-------------------------------+ + | ``$.jqplot.PyramidRenderer`` | ``"PyramidRenderer"`` | + +--------------------------------------+-------------------------------+ + +Example (using horizontal `Bar Chart +`_ - third example +from the top):: + + curl http://localhost:7272/api/v0.1//tileconfig/ + -X POST + -d 'value={ + "seriesDefaults": { + "trendline": {"show": false}, + "renderer":"BarRenderer", + "pointLabels": {"show": true, "location": "e", "edgeTolerance": -15}, + "shadowAngle": 135, + "rendererOptions": {"barDirection": "horizontal"} + }, + "axes": {"yaxis": { "renderer": "CategoryAxisRenderer"}}}' -- cgit v1.2.3