==================================
Vizier: a python reporting library
==================================

Vizier started as a fork of cairoplot adding multi-page PDF support.

Since then, the project has been written from the ground-up and re-imagined
to provide a dead-easy reporting and graphing solution for python using cairo.
Notable features include

  * bezier line interpolation,
  * handling NaN values,
  * threshold indicators,
  * the creation and management of multi-page documents ("books"), and
  * different types of plots (e.g. rectangle, line, scatter) on one graph

I'd like to point you to the fine work of the contributors and maintainers of
the CairoPlot project, who sadly have not had time to continue their work. See
`CairoPlot's project page on Launchpad <https://launchpad.net/cairoplot>`_.
Vizier does not yet provide a comparable level of functionality to cairoplot,
whose sources are available here (in a modified form) by checking out the tag
cairoplot-merged.

Note: libcairo >= 1.10.1 recommended, to fix a bug with multi-page PDF clipping.
https://bugs.freedesktop.org/show_bug.cgi?id=24691

Installing on Windows
=====================

Grab a recent version of GTK+, which includes Cairo. You can download an installer here:
http://sourceforge.net/projects/gtk-win/files/GTK%2B%20Runtime%20Environment/GTK%2B%202.22/

Now, get vizier. In the root vizier directory, run::

    python setup.py install

You should now be able to run one of the examples. Try::

    python examples/test1.py

If test1.pdf is created and looks slick, you're ready to go!

Quick Example
=============

See examples/test1.py for code that creates a multi-page PDF.