pygal/pages/first_steps.rst

===============
 Documentation
===============


First steps
===========

First you need to download the pygal package, see the `download page </download>`_.

When it's done, you are ready to make your first chart:

.. code-block:: python

  import pygal                                                       # First import pygal
  bar_chart = pygal.Bar()                                            # Then create a bar graph object
  bar_chart.add('Fibonacci', [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55])  # Add some values
  bar_chart.render_to_file('bar_chart.svg')                          # Save the svg to a file

Now you have a svg file called `bar_chart.svg` in your current directory.

You can open it with various programs such as your web browser, inkscape or any svg compatible viewer.

The resulting chart will be tho following:

.. pygal-code::

  bar_chart = pygal.Bar()
  bar_chart.add('Fibonacci', [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55])

To make a multiple series graph just add another one:

.. pygal-code::

  bar_chart = pygal.Bar()
  bar_chart.add('Fibonacci', [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55])
  bar_chart.add('Padovan', [1, 1, 1, 2, 2, 3, 4, 5, 7, 9, 12])

If you want to stack them, use `StackedBar` instead of `Bar`:

.. pygal-code::

  bar_chart = pygal.StackedBar()
  bar_chart.add('Fibonacci', [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55])
  bar_chart.add('Padovan', [1, 1, 1, 2, 2, 3, 4, 5, 7, 9, 12])


You can also make it horizontal with `HorizontalStackedBar`:

.. pygal-code::

  bar_chart = pygal.HorizontalStackedBar()
  bar_chart.add('Fibonacci', [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55])
  bar_chart.add('Padovan', [1, 1, 1, 2, 2, 3, 4, 5, 7, 9, 12])


And finally add a title and some labels:

.. pygal-code::

  bar_chart = pygal.HorizontalStackedBar()
  bar_chart.title = "Remarquable sequences"
  bar_chart.x_labels = map(str, range(11))
  bar_chart.add('Fibonacci', [0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55])
  bar_chart.add('Padovan', [1, 1, 1, 2, 2, 3, 4, 5, 7, 9, 12])