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.
 
 
 

225 lines
4.4 KiB

Rendering
=========
stroke
------
On line graphs you can disable line stroking:
.. pygal-code::
chart = pygal.Line(stroke=False)
chart.add('line', [.0002, .0005, .00035])
fill
----
And enable line filling:
.. pygal-code::
chart = pygal.Line(fill=True)
chart.add('line', [.0002, .0005, .00035])
zero
----
To fill to an other reference than zero:
.. pygal-code::
chart = pygal.Line(fill=True, zero=.0004)
chart.add('line', [.0002, .0005, .00035])
show_dots
---------
You can remove dots by setting ``show_dots`` at ``False```
.. pygal-code::
chart = pygal.Line(show_dots=False)
chart.add('line', [.0002, .0005, .00035])
show_only_major_dots
--------------------
You can remove minor x-labelled dots by setting ``show_only_major_dots`` at ``True``
.. pygal-code::
chart = pygal.Line(show_only_major_dots=True)
chart.add('line', range(12))
chart.x_labels = map(str, range(12))
chart.x_labels_major = ['2', '4', '8', '11']
dots_size
---------
You can change the dot size
.. pygal-code::
chart = pygal.Line(dots_size=5)
chart.add('line', [.0002, .0005, .00035])
stroke_style
------------
It is possible to set a default style for lines with the ``stroke_style`` dictionary.
.. pygal-code::
chart = pygal.Line(stroke_style={'width': 5, 'dasharray': '3, 6', 'linecap': 'round', 'linejoin': 'round'})
chart.add('line', [.0002, .0005, .00035])
show_x_guides
-------------
You can force the display of x guides
.. pygal-code::
chart = pygal.Line(show_x_guides=True)
chart.x_labels = ['alpha', 'beta', 'gamma']
chart.add('line', [.0002, .0005, .00035])
show_y_guides
-------------
Or disable y guides:
.. pygal-code::
chart = pygal.Line(show_y_guides=False)
chart.x_labels = ['alpha', 'beta', 'gamma']
chart.add('line', [.0002, .0005, .00035])
style
-----
see `styles <../styles.html>`_
You can add or replace css/js files in pygal using the `css` and `js` array options.
These lists contain absolute filenames and/or external URI. (Relative filenames are relative to pygal internal files)
All config lists now support the use of ellipsis as an extender. For instance:
.. code-block:: python
config = Config()
config.css.append('style.css')
chart = pygal.Line(config)
can now be replaced with:
.. code-block:: python
chart = pygal.Line(css=(..., 'style.css'))
or if you are still using python from the last decade:
.. code-block:: python
from pygal._compat import _ellipsis
chart = pygal.Line(css=(_ellipsis, 'style.css'))
css
---
Default:
.. code-block:: python
css = ['file://style.css', 'file://graph.css']
Css can also specified inline by prepending `inline:` to the css:
.. code-block:: python
css = ['inline:.rect { fill: blue; }']
classes
-------
You can alter pygal svg node classes with the classes option:
.. code-block:: python
chart = pygal.Line(classes=(..., 'flex'))
defs
----
You can add defs like linearGradient, radialGradient, pattern to the defs config:
.. pygal-code::
config = pygal.Config()
config.style = pygal.style.DarkStyle
config.defs.append('''
<linearGradient id="gradient-0" x1="0" x2="0" y1="0" y2="1">
<stop offset="0%" stop-color="#ff5995" />
<stop offset="100%" stop-color="#feed6c" />
</linearGradient>
''')
config.defs.append('''
<linearGradient id="gradient-1" x1="0" x2="0" y1="0" y2="1">
<stop offset="0%" stop-color="#b6e354" />
<stop offset="100%" stop-color="#8cedff" />
</linearGradient>
''')
config.css.append('''inline:
.color-0 {
fill: url(#gradient-0) !important;
stroke: url(#gradient-0) !important;
}''')
config.css.append('''inline:
.color-1 {
fill: url(#gradient-1) !important;
stroke: url(#gradient-1) !important;
}''')
chart = pygal.Line(config)
chart.add('1', [1, 3, 12, 3, 4, None, 9])
chart.add('2', [7, -4, 10, None, 8, 3, 1])
chart.x_labels = ('a', 'b', 'c', 'd', 'e', 'f', 'g')
chart.legend_at_bottom = True
chart.interpolate = 'cubic'
js
--
.. code-block:: python
js = [
'//kozea.github.io/pygal.js/2.0.x/pygal-tooltips.min.js'
]
See `pygal.js <https://github.com/Kozea/pygal.js/>`_
force_uri_protocol
------------------
In case of rendering the svg as a data uri, it is mandatory to specify a protocol.
It can be set to http or https and will be used for '//domain/' like uri.
It is used along with ``render_data_uri``.