= Getting started with the latest release =

== Compile ==
=== Dependences ===
To compile picviz, you will need:
 * Compile suite (gcc, make etc..)
 * flex and bison
 * Cmake (http://www.cmake.org)
 * pcre library (http://www.pcre.org/)
 * cairo library (http://cairographics.org/)

Optional:
 * Python development library (http://www.python.org)
 * QT4 python bindings (http://www.riverbankcomputing.co.uk/software/pyqt/download)

=== Compile and install ===

'''libpicviz'''

{{{
$ wget http://www.wallinfire.net/files/picviz/libpicviz-0.6.tar.gz
$ tar xvf libpicviz-0.6.tar.gz
$ cd libpicviz-0.6
$ make
$ sudo make install
$ cd src/bindings/python
$ sudo python ./setup.py install
}}}

'''Command line''':

{{{
$ wget http://www.wallinfire.net/files/picviz/picviz-cli-0.6.tar.gz
$ tar xvf picviz-cli-0.6.tar.gz
$ cd src
$ make
$ sudo make install
}}}


'''Frontend'':

{{{
$ wget http://www.wallinfire.net/files/picviz/picviz-gui-0.6.tar.gz
$ tar xvf picviz-gui-0.6.tar.gz
$ sudo python ./setup.py install
}}}


You can now try in picviz-cli-0.6/samples, you have some example files.

== Use ==

You can create your graphs using the language. To learn this please refer to [PcvLanguage the Picviz language] page. Those files are named with the extension 'pcv'. Samples are available in the source directory ''''sample''''.

However the best is to generate this language. And perl being a great language for this, one can use the tools available with the sources in the directory ''''tools''''. So to graph your logs easily one can do:
{{{
$ cd parsers/
$ sudo ./syslog2picviz.pl /var/log/syslog > syslog.pcv
}}}

In my case, the syslog file is pretty big:
{{{
$ wc -l syslog.pcv 
87139 syslog.pcv
}}}

Because the file is pretty big, your svg viewer may not work. So you can use the png plugin:
{{{
$ pcv -Tpngcairo syslog.pcv -o syslog.png
}}}

Which would produce the following graph:

[[Image(syslog.png)]]


You can also increase the image resolution to get a better image
{{{
$ pcv -Tpngcairo syslog.pcv -o syslog.png -rrr
}}}


Default values positioning is not relative. As of now, this is not the default behavior to put data in relative mode but it soon may change. To active it, simply add at the beginning of the graph:
{{{
engine {
    relative = "1";
}
}}}

This graph is the result for the same data than above but in relative mode:

[[Image(syslog-relative.png)]]