Author: | Vadim Gubergrits <[email protected]> |
---|
This extensions allows rendering of plots using the gnuplot language.
This extensions adds the gnuplot
directive that will replace the gnuplot
commands with the image of the plot.
This source:
.. gnuplot:: :title: The sine function plot sin(x)
is rendered as:
.. gnuplot:: :title: The sine function plot sin(x)
Gnuplot should be installed and be in the system's path.
Checkout sphinx-contrib:
$ hg clone https://bitbucket.org/birkenfeld/sphinx-contrib/
Change into the gnuplot directory:
$ cd sphinx-contrib/gnuplot
Install the module:
$ python setup.py install
Enabling the extension in Sphinx
Just add sphinxcontrib.gnuplot
to the list of extensions in the conf.py
file. For example:
extensions = ['sphinxcontrib.gnuplot']
size
: X,Y- Width and height of the resulting plot.
title
: <TITLE>- set the plot title to TITLE. Equivalent to "set title TITLE".
For now one optional configuration is added to Sphinx. It can be set in
conf.py
file:
gnuplot_fromat
<dict>:image format used for the different builders.
latex
andhtml
fromats are supported.For example:
gnuplot_format = dict(latex='png', html='png')
These are the actual defaults.
Gnuplot is instructed to change its working directory to the document base directory. When referencing data files in gnuplot they must be relative to the document.
To provide a link to the data source you can use Sphinx standard download
role:
.. gnuplot:: plot 'data.dat' using 1:2 The source is :download:`here <data.dat>`.