File: introduction.rst

package info (click to toggle)
pycha 0.5.3-1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 580 kB
  • ctags: 434
  • sloc: python: 3,642; makefile: 67
file content (85 lines) | stat: -rw-r--r-- 2,011 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
.. index:: introduction
.. _introduction:

************
Introduction
************

PyCha is a very simple `Python <http://www.python.org>`_ package for drawing 
charts using the `Cairo <http://www.cairographics.org/>`_ library. Its lead
developer is Lorenzo Gil Sanchez.

.. index:: pycha goals

PyCha aims to be:

    * Lightweight
    * Simple to use
    * Nice looking with default values
    * Customizable

.. index:: chart types
.. _pycha-chart-types:
    
The following charts are currently supported (see screenshots below):

    * horizontal bar charts (``pycha.bar.HorizontalBarChart``)
    * vertical bar charts (``pycha.bar.VerticalBarChart``)
    * pie charts (``pycha.pie.PieChart``)
    * line charts (``pycha.line.LineChart``)
    * scatter charts (``pycha.scatter.ScatterChart``)
  
Support for stacked bar charts is planned for a future release. 
    
PyCha is distributed under the terms of the `GNU Lesser General Public License
<http://www.gnu.org/licenses/lgpl.html>`_. 

If you require more advanced graphs, you might want to consider `matplotlib 
<http://matplotlib.sourceforge.net/>`_.

.. index:: screenshots   
.. _screenshots:
    
Screenshots
===========

- **horizontal bar chart**

.. image:: ../examples/hbarchart.png

- **vertical bar chart**

.. image:: ../examples/vbarchart.png

- **pie chart**

.. image:: ../examples/piechart.png

- **line chart**

.. image:: ../examples/linechart.png

- **scatter chart**

.. image:: ../examples/scatterchart.png

.. index:: output formats
.. _output-formats:

Output Formats
==============

PyCha uses the `Cairo <http://www.cairographics.org/>`_ library so it should support
all `Cairo surfaces <http://www.cairographics.org/manual/cairo-surfaces.html>`_.

Please refer to :ref:`save-chart-to-file` and :ref:`embed-chart-in-gtk-app` for
examples.

.. _get-involved:

Get Involved
============

PyCha has a mailing list at `http://groups.google.com/group/pycha
<http://groups.google.com/group/pycha>`_. Questions and ideas are welcome.