README.md 1.82 KB
Newer Older
Arnaud Blanchard's avatar
Arnaud Blanchard committed
1
2
3
Gnuplot
=======

Arnaud Blanchard's avatar
Arnaud Blanchard committed
4
Open a window and nicely graph the content of a blc_channel.
Arnaud Blanchard's avatar
Arnaud Blanchard committed
5
6

Install
Arnaud Blanchard's avatar
Arnaud Blanchard committed
7
=======
Arnaud Blanchard's avatar
Arnaud Blanchard committed
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

Requiert gnuplot.

- Ubuntu: `sudo apt-get install gnuplot`
- Mac OSX: `brew install gnuplot --with-qt`

Usage
=====
`o_gnuplot <channel>` graphs the content of the channel.

By default the graph is refreshed at 10Hz, you can change the **period** using `-P`

You may want to graph the evolution of data over the time. You  precise how many past values you want to display with `-H`.
By default they are updated each 10ms, change it with `-p`.

Arnaud Blanchard's avatar
Arnaud Blanchard committed
23
e.g. `i_keyboard | o_gnuplot -H1000` displays the changes with your keyboard (see bapps) with an history of 10 seconds (1000 `-H` values of 10ms `-p`). 
Arnaud Blanchard's avatar
Arnaud Blanchard committed
24
25
26
27
To change the values you must be focus on the terminal.

You can change the type of display ( default lines) using the `-w` option e.g. dots or boxes. For more information about the with option see gnuplot documenton.

Arnaud Blanchard's avatar
Arnaud Blanchard committed
28
Change any setting of gnuplot using `-t`. e.g. `o_gnuplot  -w "boxes"  -t "set boxwidth 0.9
Arnaud Blanchard's avatar
Arnaud Blanchard committed
29
 absolute; set key left" `. This define a boxwidth of 0.9 and put the legend on the left.
Arnaud Blanchard's avatar
Arnaud Blanchard committed
30

Arnaud Blanchard's avatar
Arnaud Blanchard committed
31
Links
Arnaud Blanchard's avatar
Arnaud Blanchard committed
32
=====
Arnaud Blanchard's avatar
Arnaud Blanchard committed
33

Arnaud Blanchard's avatar
Arnaud Blanchard committed
34
- [gnuplot Quick Reference](http://www.gnuplot.info/docs_4.0/gpcard.pdf) Summary of th main functions.
Arnaud Blanchard's avatar
Arnaud Blanchard committed
35
36
- [gnuplot](http://www.gnuplot.info) Official website
- [gnuplotting](http://www.gnuplotting.org) Nice blogs with lot of original exemples
Arnaud Blanchard's avatar
Arnaud Blanchard committed
37
- [Complete pdf manual](http://www.usm.uni-muenchen.de/people/puls/lessons/intro_general/gnuplot/gpdocu.pdf)
Arnaud Blanchard's avatar
Arnaud Blanchard committed
38
39
40
- [Impossible gnuplot graphs](http://www.phyast.pitt.edu/~zov1/gnuplot/html/intro.html) see specifically [stats function](http://www.phyast.pitt.edu/~zov1/gnuplot/patch/stats.html)  (syntax is deprecated but the principle is there)
- [not so Frequently Asked Questions](http://lowrank.net/gnuplot/index-e.html)
- [gnuplot surprising](http://gnuplot-surprising.blogspot.fr) A bit old (2012) but interesting