mirror of https://github.com/Kozea/pygal.git
Python to generate nice looking SVG graph
http://pygal.org/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
107 lines
2.0 KiB
107 lines
2.0 KiB
13 years ago
|
===============
|
||
|
Documentation
|
||
|
===============
|
||
|
|
||
|
|
||
|
Other customizations
|
||
|
====================
|
||
|
|
||
|
.. contents::
|
||
|
|
||
|
|
||
|
Logarithmic
|
||
|
-----------
|
||
|
|
||
|
`logarithmic`
|
||
|
|
||
|
You can set the scale to be logarithmic:
|
||
|
|
||
|
.. pygal-code::
|
||
|
|
||
|
chart = pygal.Line(logarithmic=True)
|
||
|
values = [1, 3, 43, 123, 1231, 23192]
|
||
|
chart.x_labels = map(str, values)
|
||
|
chart.add('log example', values)
|
||
|
|
||
|
|
||
|
Custom css and js
|
||
|
-----------------
|
||
|
|
||
|
`base_css, base_js`
|
||
|
|
||
|
You can specify a css/js file to replace the one by default using `base_css` and `base_js` options.
|
||
|
These options take a filename in parameter.
|
||
|
|
||
|
|
||
|
Legend box size
|
||
|
---------------
|
||
|
|
||
|
`legend_box_size`
|
||
|
|
||
|
You can change the size of the rectangle next to the legend:
|
||
|
|
||
|
.. pygal-code::
|
||
|
|
||
|
chart = pygal.Line(legend_box_size=50)
|
||
|
values = [1, 3, 43, 123, 1231, 23192]
|
||
|
chart.x_labels = map(str, values)
|
||
|
chart.add('log example', values)
|
||
|
|
||
|
|
||
|
Rounded bars
|
||
|
---------------
|
||
|
|
||
|
`rounded_bars`
|
||
|
|
||
|
You can add a round effect to bar diagrams with `rounded_bars`:
|
||
|
|
||
|
.. pygal-code::
|
||
|
|
||
|
chart = pygal.Bar(rounded_bars=20)
|
||
|
chart.add('rounded', [3, 10, 7, 2, 9, 7])
|
||
|
|
||
|
|
||
|
Static options
|
||
|
--------------
|
||
|
|
||
|
`print_values, print_zeroes`
|
||
|
|
||
|
By default, when the graph is viewed using a non javascript compatible
|
||
|
viewer or as an image, all the values are displayed on the graph.
|
||
|
|
||
|
It can be disabled by setting `print_values` to `False`.
|
||
|
|
||
|
`print_zeroes` can be enabled to display static values even if equal to zero.
|
||
|
|
||
|
|
||
|
Tooltip animation
|
||
|
-----------------
|
||
|
|
||
|
`animation_steps`
|
||
|
|
||
|
*Experimental* (might be slow sometimes)
|
||
|
|
||
|
If you want some smoothing in tooltip display you can set animation_steps to a number.
|
||
|
The greater the number the slowest but detailed the animation:
|
||
|
|
||
|
|
||
|
.. pygal-code::
|
||
|
|
||
|
chart = pygal.Line(animation_steps=20)
|
||
|
values = [1, 3, 43, 123, 1231, 23192]
|
||
|
chart.x_labels = map(str, values)
|
||
|
chart.add('log example', values)
|
||
|
|
||
|
|
||
|
Disable xml declaration
|
||
|
-----------------------
|
||
|
|
||
|
`disable_xml_declaration`
|
||
|
|
||
|
When you want to embed directly your SVG in your html,
|
||
|
this option disables the xml prolog in the output.
|
||
|
|
||
|
Since no encoding is declared, the result will be in unicode instead of bytes.
|
||
|
|
||
|
|