sphinxcontrib-plot
*********************
A sphinx extension to plot all kinds of graph such as ditaa, gnuplot, pyplot,
dot, magick, blockdiag, seqdiag, actdiag, nwdiag.
.. image:: http://gnuplot.sourceforge.net/demo_5.2/transparent.2.png
The extension defines a new ".. plot::" directive.
The directive execute the given command/script and insert the generated figure
into the document (like the .. image:: directive). Compared to directive
".. image::", it generate the image at first by the given script.
For example you execute "command parameters_or_script" to generate the
"command_output.png", Writing the directive as following would include the
image into you document::
.. plot command parameters_or_script
:caption: An example
A real examples is magick as following and more examples are shown later.::
.. plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png
:caption: An magick example
This is the output: |imagemagick_example1|
.. .. contents::
.. :depth: 2
1. Installing and setup
=======================
1) Install::
pip install sphinxcontrib-plot
2) Set "sphinx_plot_directive" to the list of extensions in the conf.py::
extensions = ['sphinxcontrib.plot']
3) You may need to install extra command that sphinx-plot-directive depends on::
apt install imagemagick inkscape libwebp gnuplot
2. Usage
============
Inlcuding a ".. plot::" code block in your sphinx document would generate the figure into the built document directly. For HTML output it's .png(or .svg for vector), For LaTeX output, it will include a .png(or .pdf for vector), etc..
The plot content may be defined in one of Three ways:
2.1 A simple plot command to generate a figure.
-------------------------------------------------
::
.. plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png
:caption: An magick example
The output is:
|imagemagick_example1|.
2.2 A plot command(gnuplot, ditaa, matplotlib or graphviz) with inline script
-------------------------------------------------------------------------------
::
.. plot:: gnuplot
:caption: figure 3. illustration for gnuplot
set output "test.png"
set terminal pngcairo size 900,600
set style fill transparent solid 0.5 noborder
set style function filledcurves y1=0
Gauss(x,mu,sigma) = 1./(sigma*sqrt(2*pi)) * exp( -(x-mu)**2 / (2*sigma**2) )
d1(x) = Gauss(x, 0.5, 0.5)
d2(x) = Gauss(x, 2., 1.)
d3(x) = Gauss(x, -1., 2.)
set xrange [-5:5]
set yrange [0:1]
set key title "Gaussian Distribution"
set key top left Left reverse samplen 1
set title "Transparent filled curves"
plot d1(x) fs solid 1.0 lc rgb "forest-green" title "μ = 0.5 σ = 0.5", \
d2(x) lc rgb "gold" title "μ = 2.0 σ = 1.0", \
d3(x) lc rgb "dark-violet" title "μ = -1.0 σ = 2.0"
The output is:
|gnuplot_example|.
2.3 A plot command with included file
---------------------------------------
::
.. plot:: ditaa --svg
:caption: figure 2. illustration for ditaa with option
:include: _static/ditaa_example.txt
After compilation, the above file becomes: |ditaa_example|
2.4 inline image
-----------------
for example, an icons is generated and inserted. ::
This is a |rose|.
.. |rose| plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png
The output is:
This is a |imagemagick_example1|.
3 Options
===========
sphinx-plot-directive provide global options and plot image for easy use. Besides you can change the output by change the command's own options.
3.1 global options
---------------------------------
You can define the prefered format for different output. It's best effort, if it couldn't be done, the output format might be .png or anything else.::
plot_format = dict(html='svg', latex='pdf')
3.2 sphinx-plot-directive options
---------------------------------
sphinx-plot-directive specific options:
#. :caption: Caption of the generated figure.
#. :include: include the plot script. Make sure it's readable.
#. :magick: add annotate or watermark.
#. :show_source: for text generated iamge, if the source code is shown.
#. :latex_show_max_png: When the build target is is latexpdf and output is .gif, We can magick it to multiple .png, then this defines how many frames would be shown in latex output. it's integer.
Common image options:
Since plot generate figure/image, it's in fact a image. So all the options of figure and image could be used. For example:
#. :name: the reference name for the figure/image. For html, it would rename the output file to the @name. Since latex doesn't do well in supporting :name: for example doesn't support Chinese/SPACE, doesn't generate linke to :name, we don't do that in latex.
For example::
.. plot:: gnuplot
:caption: figure 1. illustration for gnuplot with watermark.
:size: 900,600
:width: 600
plot [-5:5] (sin(1/x) - cos(x))*erfc(x)
3.3 command options
-------------------
You can add any parameter after the command. sphinxcontrib-plot doesn't know it and only get the graph after it's executed. for example::
.. plot:: ditaa --no-antialias -s 2
:caption: figure 1. illustration for ditaa with option.
+--------+ +-------+ +-------+
| | --+ ditaa +--> | |
| Text | +-------+ |diagram|
|Document| |!magic!| | |
| {d}| | | | |
+---+----+ +-------+ +-------+
: ^
| Lots of work |
+-------------------------+
4. More Examples
===================
In rst we we use `image`_ and `figure`_ directive to render image/figure. In
fact we can plot anything in rst as it was on shell. You need only include the
command or script in the directive body, then the figure would be automatically
included in your sphinx document. For examples:
4.1 gnuplot example
-------------------
The first example is gnuplot.::
.. plot:: gnuplot
:caption: figure 3. illustration for gnuplot
:image: test.png
set output "test.png"
set terminal pngcairo size 900,600
set style fill transparent solid 0.5 noborder
set style function filledcurves y1=0
Gauss(x,mu,sigma) = 1./(sigma*sqrt(2*pi)) * exp( -(x-mu)**2 / (2*sigma**2) )
d1(x) = Gauss(x, 0.5, 0.5)
d2(x) = Gauss(x, 2., 1.)
d3(x) = Gauss(x, -1., 2.)
set xrange [-5:5]
set yrange [0:1]
set key title "Gaussian Distribution"
set key top left Left reverse samplen 1
set title "Transparent filled curves"
plot d1(x) fs solid 1.0 lc rgb "forest-green" title "μ = 0.5 σ = 0.5", \
d2(x) lc rgb "gold" title "μ = 2.0 σ = 1.0", \
d3(x) lc rgb "dark-violet" title "μ = -1.0 σ = 2.0"
After compilation, the above file becomes: |gnuplot_example|
4.2 ditaa example
-------------------
Another example is ditaa. ditaa_ is a small command-line utility that can
magick diagrams drawn using ascii art into proper bitmap graphics. Ditaa is in
java and we We could use following directive to render the image with extra
parameters::
.. plot:: ditaa
:caption: figure 1. illustration for ditaa
+--------+ +-------+ +-------+
| | --+ ditaa +--> | |
| Text | +-------+ |diagram|
|Document| |!magic!| | |
| {d}| | | | |
+---+----+ +-------+ +-------+
: ^
| Lots of work |
+-------------------------+
To render the best image, it will add --svg even user didn't add it. The it
will generate a vector image::
.. plot:: ditaa --svg
:caption: figure 2. illustration for ditaa with option
+--------+ +-------+ +-------+
| | --+ ditaa +--> | |
| Text | +-------+ |diagram|
|Document| |!magic!| | |
| {d}| | | | |
+---+----+ +-------+ +-------+
: ^
| Lots of work |
+-------------------------+
After compilation, the above file becomes: |ditaa_example|
4.3 python(matplotlib) example
---------------------------------
Another example is mulplotlib.plot. ::
.. plot:: python
:caption: figure 4. illustration for python
import numpy as np
import matplotlib.pyplot as plt
x = np.linspace(0, 1, 500)
y = np.sin(4 * np.pi * x) * np.exp(-5 * x)
fig, ax = plt.subplots()
ax.fill(x, y, zorder=10)
ax.grid(True, zorder=5)
plt.show()
After compilation, we could get the following image: |matplotlib_example|
4.4 graphviz(dot) example
--------------------------
Another example is graphivx(dot), since we want to generate png image, we add
the option in the command, it's dot's own option::
.. plot:: dot -Tpng
:caption: illustration for dot
digraph G {
subgraph cluster_0 {
style=filled;
color=lightgrey;
node [style=filled,color=white];
a0 -> a1 -> a2 -> a3;
label = "process #1";
}
subgraph cluster_1 {
node [style=filled];
b0 -> b1 -> b2 -> b3;
label = "process #2";
color=blue
}
start -> a0;
start -> b0;
a1 -> b3;
b2 -> a3;
a3 -> a0;
a3 -> end;
b3 -> end;
start [shape=Mdiamond];
end [shape=Msquare];
}
After compilation, the above file becomes: |graphviz_example|
4.5 imagemagick example
-------------------------
Another example is magick. You can write the command in the commnad line::
.. plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png
:caption: illustration for magick
This is the output: |imagemagick_example1|
or you can write a magick script as the following::
.. plot:: magick
:caption: illustration for magick
magick -size 140x130 xc:white -stroke black \
-fill red -draw "path 'M 60,70 L 60,20 A 50,50 0 0,1 68.7,20.8 Z'" \
-fill green -draw "path 'M 60,70 L 68.7,20.8 A 50,50 0 0,1 77.1,23.0 Z'" \
-fill blue -draw "path 'M 68,65 L 85.1,18.0 A 50,50 0 0,1 118,65 Z'" \
-fill gold -draw "path 'M 60,70 L 110,70 A 50,50 0 1,1 60,20 Z'" \
-fill black -stroke none -pointsize 10 \
-draw "text 57,19 '10' text 70,20 '10' text 90,19 '70' text 113,78 '270'" \
out.png
This is the output: |imagemagick_example2|
4.6 blockdiag, seqdiag, actdiag, nwdiag.
------------------------------------------
demo for blockdiag::
.. plot:: blockdiag
:caption: demo for blockdiag
:name: demo for blockdiag
blockdiag {
// Set stacked to nodes.
stacked [stacked];
diamond [shape = "diamond", stacked];
database [shape = "flowchart.database", stacked];
stacked -> diamond -> database;
}
This will generate the follong image on your .htm/.pdf document generated from
sphinx: |blockdiag_example|
demo for seqdiag::
.. plot:: blockdiag
:caption: demo for seqdiag
:name: demo for seqdiag
seqdiag {
// Set edge metrix.
edge_length = 300; // default value is 192
span_height = 80; // default value is 40
// Set fontsize.
default_fontsize = 16; // default value is 11
// Do not show activity line
activation = none;
// Numbering edges automaticaly
autonumber = True;
// Change note color
default_note_color = lightblue;
browser -> webserver [label = "GET \n/index.html"];
browser <-- webserver [note = "Apache works!"];
}
This will generate the follong image on your .htm/.pdf document generated from
sphinx: |seqdiag_example|
demo for actdiag::
.. plot:: actdiag
:caption: demo for actdiag
actdiag {
write -> convert -> image
lane user {
label = "User"
write [label = "Writing reST"];
image [label = "Get diagram IMAGE"];
}
lane actdiag {
convert [label = "convert reST to Image"];
}
}
This will generate the follong image on your .htm/.pdf document generated from
sphinx: |actdiag_example|
demo for nwdiag::
.. plot:: nwdiag
:caption: demo for actdiag
nwdiag {
network dmz {
address = "210.x.x.x/24"
web01 [address = "210.x.x.1"];
web02 [address = "210.x.x.2"];
}
network internal {
address = "172.x.x.x/24";
web01 [address = "172.x.x.1"];
web02 [address = "172.x.x.2"];
db01;
db02;
}
}
This will generate the follong image on your .htm/.pdf document generated from
sphinx: |nwdiag_example|
4.7 svg
----------------------
We can include the .svg image in our document directly and it will be rended as
a picture in either html or pdf output.::
.. plot:: svg
<svg version="1.1"
baseProfile="full"
width="300" height="200"
xmlns="http://www.w3.org/2000/svg">
<rect width="100%" height="100%" fill="red" />
<circle cx="150" cy="100" r="80" fill="green" />
<text x="150" y="125" font-size="60" text-anchor="middle" fill="white">SVG</text>
</svg>
You can use ":include:" parameter to include a .svg image::
.. plot:: svg
:include: _static/test.svg
:caption: include参数的用法
4.8 use cp to include .webp into the document
------------------------------------------------
We can copy the .dwep picture into the document directly, it would be rended as .webp in html and .png in latexpdf.::
.. plot:: cp _static/palms.webp out.webp
:caption: An example to include .webp picture.
5. License
==========
MIT
.. _ditaa: http://ditaa.sourceforge.net/
.. _image: http://docutils.sourceforge.net/docs/ref/rst/directives.html#image
.. _figure: http://docutils.sourceforge.net/docs/ref/rst/directives.html#figure
.. |imagemagick_example1| image:: https://legacy.imagemagick.org/Usage/draw/rose_raw.png
.. |imagemagick_example2| image:: https://legacy.imagemagick.org/Usage/draw/piechart.jpg
.. |gnuplot_example| image:: http://gnuplot.sourceforge.net/demo_5.2/transparent.2.png
.. |ditaa_example| image:: http://ditaa.sourceforge.net/images/first.png
.. |matplotlib_example| image:: https://matplotlib.org/2.0.2/_images/fill_demo1.png
.. |graphviz_example| image:: http://www.graphviz.org/Gallery/directed/cluster.png
.. |blockdiag_example| image:: http://blockdiag.com/en/_images/blockdiag-56cb174d92d602f8cc9013006e661c4806e1d5ab.png
.. |seqdiag_example| image:: http://blockdiag.com/en/_images/seqdiag-9d43a794bd1f63fc9418595e4451c5fb9c52ad39.png
.. |actdiag_example| image:: http://blockdiag.com/en/_images/actdiag-27aec367951ef70f7b5badceebbcc0c2bc687752.png
.. |nwdiag_example| image:: http://blockdiag.com/en/_images/nwdiag-be3d31eeeacd641176a6f63703748e33d278419a.png
6. Changelog
============
| 1.0 Initial upload.
| 1.0.8 Bug fix: When there is no :size: in gnuplot plot, it might crash.
| 1.0.10 Bug fix: fix the issue that magick doesn't work.
| 1.0.13 Support magick script
| 1.0.17 bug fix: magick can has no body.
| 1.0.18 New feature: 1) Support montage command; 2) Support including .gif image into html and pdf. If it's html, play the .gif, or else if it's pdf, magick the .gif to a list of frame.
| 1.0.19 Support lines starting with # in the magick/montage body.
| 1.1.0 Bug fix: It doesn't work for ditaa with magick parameters.
| 1.1.1 Support the following plot command: blockdiag, seqdiag, actdiag, nwdiag.
| 1.1.2 magick command must be in command line or in content with one worad “magick” in command line.
| 1.1.3 Bug fix: make html might cause the following error: AttributeError: 'str' object has no attribute 'extend'
| 1.1.4 Support inline image.
| 1.1.5 When the output is .gif, print the frames in 8 frames in every row by default.
| 1.1.6 When .gif is given width, then increase it in latexpdf output.
| 1.1.7 Support new commands: dwebp and others.
| 1.1.8 Support new command cp to incluce .webp.
Refenreces
==========
#. gnuplot, http://www.gnuplot.info/
#. ditaa, https://github.com/tmthrgd/ditaa-ditaa
#. Matplotlib, https://matplotlib.org/
#. graphviz, https://graphviz.org/
#. imagemagick, https://imagemagick.org
#. blockdiag, http://blockdiag.com/en/blockdiag/index.html
#. seqdiag , http://blockdiag.com/en/seqdiag/index.html
#. actdiag , http://blockdiag.com/en/nwdiag/actdiag.html
#. nwdiag , http://blockdiag.com/en/nwdiag/index.html
Raw data
{
"_id": null,
"home_page": "https://github.com/stathissideris/sphinxcontrib-plot",
"name": "sphinxcontrib-plot",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "sphinx, sphinxcontrib, plot, ditaa, gnuplot, magick",
"author": "Yongping Guo",
"author_email": "Yongping Guo <guoyoooping@163.com>",
"download_url": "https://files.pythonhosted.org/packages/86/0c/b0e66b93536997bd2524b739f2cc5102b9f8221483bfd330badf2d9c89e1/sphinxcontrib_plot-1.1.8.tar.gz",
"platform": "any",
"description": "sphinxcontrib-plot\n*********************\n\nA sphinx extension to plot all kinds of graph such as ditaa, gnuplot, pyplot,\ndot, magick, blockdiag, seqdiag, actdiag, nwdiag.\n\n.. image:: http://gnuplot.sourceforge.net/demo_5.2/transparent.2.png\n\nThe extension defines a new \".. plot::\" directive.\n\nThe directive execute the given command/script and insert the generated figure\ninto the document (like the .. image:: directive). Compared to directive \n\".. image::\", it generate the image at first by the given script.\n\nFor example you execute \"command parameters_or_script\" to generate the\n\"command_output.png\", Writing the directive as following would include the\nimage into you document::\n\n .. plot command parameters_or_script\n :caption: An example\n\nA real examples is magick as following and more examples are shown later.::\n\n .. plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png\n :caption: An magick example\n\nThis is the output: |imagemagick_example1|\n\n.. .. contents::\n.. :depth: 2\n\n1. Installing and setup\n=======================\n\n1) Install::\n\n pip install sphinxcontrib-plot\n\n2) Set \"sphinx_plot_directive\" to the list of extensions in the conf.py::\n\n extensions = ['sphinxcontrib.plot']\n\n3) You may need to install extra command that sphinx-plot-directive depends on::\n\n apt install imagemagick inkscape libwebp gnuplot\n\n2. Usage\n============\n\nInlcuding a \".. plot::\" code block in your sphinx document would generate the figure into the built document directly. For HTML output it's .png(or .svg for vector), For LaTeX output, it will include a .png(or .pdf for vector), etc..\n\nThe plot content may be defined in one of Three ways:\n\n2.1 A simple plot command to generate a figure.\n-------------------------------------------------\n\n::\n\n .. plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png\n :caption: An magick example\n\nThe output is:\n\n|imagemagick_example1|.\n\n2.2 A plot command(gnuplot, ditaa, matplotlib or graphviz) with inline script\n-------------------------------------------------------------------------------\n\n::\n\n .. plot:: gnuplot\n :caption: figure 3. illustration for gnuplot\n\n set output \"test.png\"\n set terminal pngcairo size 900,600\n set style fill transparent solid 0.5 noborder\n set style function filledcurves y1=0\n Gauss(x,mu,sigma) = 1./(sigma*sqrt(2*pi)) * exp( -(x-mu)**2 / (2*sigma**2) )\n d1(x) = Gauss(x, 0.5, 0.5)\n d2(x) = Gauss(x, 2., 1.)\n d3(x) = Gauss(x, -1., 2.)\n set xrange [-5:5]\n set yrange [0:1]\n set key title \"Gaussian Distribution\"\n set key top left Left reverse samplen 1\n set title \"Transparent filled curves\"\n plot d1(x) fs solid 1.0 lc rgb \"forest-green\" title \"\u03bc = 0.5 \u03c3 = 0.5\", \\\n d2(x) lc rgb \"gold\" title \"\u03bc = 2.0 \u03c3 = 1.0\", \\\n d3(x) lc rgb \"dark-violet\" title \"\u03bc = -1.0 \u03c3 = 2.0\"\n\nThe output is:\n\n|gnuplot_example|.\n\n2.3 A plot command with included file\n---------------------------------------\n\n::\n\n .. plot:: ditaa --svg\n :caption: figure 2. illustration for ditaa with option\n :include: _static/ditaa_example.txt\n\nAfter compilation, the above file becomes: |ditaa_example|\n\n2.4 inline image\n-----------------\n\nfor example, an icons is generated and inserted. ::\n\n This is a |rose|.\n\n .. |rose| plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png\n\nThe output is:\n\nThis is a |imagemagick_example1|.\n\n3 Options\n===========\n\nsphinx-plot-directive provide global options and plot image for easy use. Besides you can change the output by change the command's own options.\n\n3.1 global options\n---------------------------------\n\nYou can define the prefered format for different output. It's best effort, if it couldn't be done, the output format might be .png or anything else.::\n\n plot_format = dict(html='svg', latex='pdf')\n\n3.2 sphinx-plot-directive options\n---------------------------------\n\nsphinx-plot-directive specific options:\n\n #. :caption: Caption of the generated figure.\n #. :include: include the plot script. Make sure it's readable.\n #. :magick: add annotate or watermark.\n #. :show_source: for text generated iamge, if the source code is shown. \n #. :latex_show_max_png: When the build target is is latexpdf and output is .gif, We can magick it to multiple .png, then this defines how many frames would be shown in latex output. it's integer.\n\nCommon image options:\n\nSince plot generate figure/image, it's in fact a image. So all the options of figure and image could be used. For example:\n\n #. :name: the reference name for the figure/image. For html, it would rename the output file to the @name. Since latex doesn't do well in supporting :name: for example doesn't support Chinese/SPACE, doesn't generate linke to :name, we don't do that in latex.\n\nFor example::\n\n .. plot:: gnuplot\n :caption: figure 1. illustration for gnuplot with watermark.\n :size: 900,600\n :width: 600\n\n plot [-5:5] (sin(1/x) - cos(x))*erfc(x)\n\n3.3 command options\n-------------------\n\nYou can add any parameter after the command. sphinxcontrib-plot doesn't know it and only get the graph after it's executed. for example::\n\n .. plot:: ditaa --no-antialias -s 2\n :caption: figure 1. illustration for ditaa with option.\n\n +--------+ +-------+ +-------+\n | | --+ ditaa +--> | |\n | Text | +-------+ |diagram|\n |Document| |!magic!| | |\n | {d}| | | | |\n +---+----+ +-------+ +-------+\n : ^\n | Lots of work |\n +-------------------------+\n\n\n4. More Examples\n===================\n\nIn rst we we use `image`_ and `figure`_ directive to render image/figure. In\nfact we can plot anything in rst as it was on shell. You need only include the\ncommand or script in the directive body, then the figure would be automatically\nincluded in your sphinx document. For examples:\n\n4.1 gnuplot example\n-------------------\n\nThe first example is gnuplot.::\n\n .. plot:: gnuplot\n :caption: figure 3. illustration for gnuplot\n :image: test.png\n\n set output \"test.png\"\n set terminal pngcairo size 900,600\n set style fill transparent solid 0.5 noborder\n set style function filledcurves y1=0\n Gauss(x,mu,sigma) = 1./(sigma*sqrt(2*pi)) * exp( -(x-mu)**2 / (2*sigma**2) )\n d1(x) = Gauss(x, 0.5, 0.5)\n d2(x) = Gauss(x, 2., 1.)\n d3(x) = Gauss(x, -1., 2.)\n set xrange [-5:5]\n set yrange [0:1]\n set key title \"Gaussian Distribution\"\n set key top left Left reverse samplen 1\n set title \"Transparent filled curves\"\n plot d1(x) fs solid 1.0 lc rgb \"forest-green\" title \"\u03bc = 0.5 \u03c3 = 0.5\", \\\n d2(x) lc rgb \"gold\" title \"\u03bc = 2.0 \u03c3 = 1.0\", \\\n d3(x) lc rgb \"dark-violet\" title \"\u03bc = -1.0 \u03c3 = 2.0\"\n\nAfter compilation, the above file becomes: |gnuplot_example|\n\n4.2 ditaa example\n-------------------\n\nAnother example is ditaa. ditaa_ is a small command-line utility that can\nmagick diagrams drawn using ascii art into proper bitmap graphics. Ditaa is in\njava and we We could use following directive to render the image with extra\nparameters::\n\n .. plot:: ditaa\n :caption: figure 1. illustration for ditaa\n\n +--------+ +-------+ +-------+\n | | --+ ditaa +--> | |\n | Text | +-------+ |diagram|\n |Document| |!magic!| | |\n | {d}| | | | |\n +---+----+ +-------+ +-------+\n : ^\n | Lots of work |\n +-------------------------+\n\nTo render the best image, it will add --svg even user didn't add it. The it\nwill generate a vector image::\n\n .. plot:: ditaa --svg\n :caption: figure 2. illustration for ditaa with option\n\n +--------+ +-------+ +-------+\n | | --+ ditaa +--> | |\n | Text | +-------+ |diagram|\n |Document| |!magic!| | |\n | {d}| | | | |\n +---+----+ +-------+ +-------+\n : ^\n | Lots of work |\n +-------------------------+\n\nAfter compilation, the above file becomes: |ditaa_example|\n\n4.3 python(matplotlib) example\n---------------------------------\n\nAnother example is mulplotlib.plot. ::\n\n .. plot:: python\n :caption: figure 4. illustration for python\n\n import numpy as np\n import matplotlib.pyplot as plt\n\n x = np.linspace(0, 1, 500)\n y = np.sin(4 * np.pi * x) * np.exp(-5 * x)\n\n fig, ax = plt.subplots()\n\n ax.fill(x, y, zorder=10)\n ax.grid(True, zorder=5)\n plt.show()\n\nAfter compilation, we could get the following image: |matplotlib_example|\n\n4.4 graphviz(dot) example\n--------------------------\n\nAnother example is graphivx(dot), since we want to generate png image, we add\nthe option in the command, it's dot's own option::\n\n .. plot:: dot -Tpng\n :caption: illustration for dot\n\n digraph G {\n\n subgraph cluster_0 {\n style=filled;\n color=lightgrey;\n node [style=filled,color=white];\n a0 -> a1 -> a2 -> a3;\n label = \"process #1\";\n }\n\n subgraph cluster_1 {\n node [style=filled];\n b0 -> b1 -> b2 -> b3;\n label = \"process #2\";\n color=blue\n }\n start -> a0;\n start -> b0;\n a1 -> b3;\n b2 -> a3;\n a3 -> a0;\n a3 -> end;\n b3 -> end;\n\n start [shape=Mdiamond];\n end [shape=Msquare];\n }\n\nAfter compilation, the above file becomes: |graphviz_example|\n\n4.5 imagemagick example\n-------------------------\n\nAnother example is magick. You can write the command in the commnad line::\n\n .. plot:: magick rose: -fill none -stroke white -draw 'line 5,40 65,5' rose_raw.png\n :caption: illustration for magick\n\nThis is the output: |imagemagick_example1|\n\nor you can write a magick script as the following::\n\n .. plot:: magick\n :caption: illustration for magick\n\n magick -size 140x130 xc:white -stroke black \\\n -fill red -draw \"path 'M 60,70 L 60,20 A 50,50 0 0,1 68.7,20.8 Z'\" \\\n -fill green -draw \"path 'M 60,70 L 68.7,20.8 A 50,50 0 0,1 77.1,23.0 Z'\" \\\n -fill blue -draw \"path 'M 68,65 L 85.1,18.0 A 50,50 0 0,1 118,65 Z'\" \\\n -fill gold -draw \"path 'M 60,70 L 110,70 A 50,50 0 1,1 60,20 Z'\" \\\n -fill black -stroke none -pointsize 10 \\\n -draw \"text 57,19 '10' text 70,20 '10' text 90,19 '70' text 113,78 '270'\" \\\n out.png\n\nThis is the output: |imagemagick_example2|\n\n4.6 blockdiag, seqdiag, actdiag, nwdiag.\n------------------------------------------\n\ndemo for blockdiag::\n\n .. plot:: blockdiag\n :caption: demo for blockdiag\n :name: demo for blockdiag\n\n blockdiag {\n // Set stacked to nodes.\n stacked [stacked];\n diamond [shape = \"diamond\", stacked];\n database [shape = \"flowchart.database\", stacked];\n\n stacked -> diamond -> database;\n }\n\nThis will generate the follong image on your .htm/.pdf document generated from\nsphinx: |blockdiag_example|\n\ndemo for seqdiag::\n\n .. plot:: blockdiag\n :caption: demo for seqdiag\n :name: demo for seqdiag\n\n seqdiag {\n // Set edge metrix.\n edge_length = 300; // default value is 192\n span_height = 80; // default value is 40\n\n // Set fontsize.\n default_fontsize = 16; // default value is 11\n\n // Do not show activity line\n activation = none;\n\n // Numbering edges automaticaly\n autonumber = True;\n\n // Change note color\n default_note_color = lightblue;\n\n browser -> webserver [label = \"GET \\n/index.html\"];\n browser <-- webserver [note = \"Apache works!\"];\n }\n\nThis will generate the follong image on your .htm/.pdf document generated from\nsphinx: |seqdiag_example|\n\ndemo for actdiag::\n\n .. plot:: actdiag\n :caption: demo for actdiag\n\n actdiag {\n write -> convert -> image\n\n lane user {\n label = \"User\"\n write [label = \"Writing reST\"];\n image [label = \"Get diagram IMAGE\"];\n }\n lane actdiag {\n convert [label = \"convert reST to Image\"];\n }\n }\n\nThis will generate the follong image on your .htm/.pdf document generated from\nsphinx: |actdiag_example| \n\ndemo for nwdiag::\n\n .. plot:: nwdiag\n :caption: demo for actdiag\n\n nwdiag {\n network dmz {\n address = \"210.x.x.x/24\"\n\n web01 [address = \"210.x.x.1\"];\n web02 [address = \"210.x.x.2\"];\n }\n network internal {\n address = \"172.x.x.x/24\";\n\n web01 [address = \"172.x.x.1\"];\n web02 [address = \"172.x.x.2\"];\n db01;\n db02;\n }\n }\n\nThis will generate the follong image on your .htm/.pdf document generated from\nsphinx: |nwdiag_example| \n\n4.7 svg\n----------------------\n\nWe can include the .svg image in our document directly and it will be rended as\na picture in either html or pdf output.::\n\n .. plot:: svg\n\n <svg version=\"1.1\"\n baseProfile=\"full\"\n width=\"300\" height=\"200\"\n xmlns=\"http://www.w3.org/2000/svg\">\n <rect width=\"100%\" height=\"100%\" fill=\"red\" />\n <circle cx=\"150\" cy=\"100\" r=\"80\" fill=\"green\" />\n <text x=\"150\" y=\"125\" font-size=\"60\" text-anchor=\"middle\" fill=\"white\">SVG</text>\n </svg>\n\nYou can use \":include:\" parameter to include a .svg image::\n\n .. plot:: svg\n :include: _static/test.svg\n :caption: include\u53c2\u6570\u7684\u7528\u6cd5\n\n4.8 use cp to include .webp into the document\n------------------------------------------------\n\nWe can copy the .dwep picture into the document directly, it would be rended as .webp in html and .png in latexpdf.::\n\n .. plot:: cp _static/palms.webp out.webp\n :caption: An example to include .webp picture.\n\n5. License\n==========\n\nMIT\n\n.. _ditaa: http://ditaa.sourceforge.net/\n.. _image: http://docutils.sourceforge.net/docs/ref/rst/directives.html#image\n.. _figure: http://docutils.sourceforge.net/docs/ref/rst/directives.html#figure\n\n\n.. |imagemagick_example1| image:: https://legacy.imagemagick.org/Usage/draw/rose_raw.png\n.. |imagemagick_example2| image:: https://legacy.imagemagick.org/Usage/draw/piechart.jpg\n.. |gnuplot_example| image:: http://gnuplot.sourceforge.net/demo_5.2/transparent.2.png\n.. |ditaa_example| image:: http://ditaa.sourceforge.net/images/first.png\n.. |matplotlib_example| image:: https://matplotlib.org/2.0.2/_images/fill_demo1.png\n.. |graphviz_example| image:: http://www.graphviz.org/Gallery/directed/cluster.png\n.. |blockdiag_example| image:: http://blockdiag.com/en/_images/blockdiag-56cb174d92d602f8cc9013006e661c4806e1d5ab.png\n.. |seqdiag_example| image:: http://blockdiag.com/en/_images/seqdiag-9d43a794bd1f63fc9418595e4451c5fb9c52ad39.png\n.. |actdiag_example| image:: http://blockdiag.com/en/_images/actdiag-27aec367951ef70f7b5badceebbcc0c2bc687752.png\n.. |nwdiag_example| image:: http://blockdiag.com/en/_images/nwdiag-be3d31eeeacd641176a6f63703748e33d278419a.png\n\n6. Changelog\n============\n\n| 1.0 Initial upload.\n| 1.0.8 Bug fix: When there is no :size: in gnuplot plot, it might crash.\n| 1.0.10 Bug fix: fix the issue that magick doesn't work.\n| 1.0.13 Support magick script\n| 1.0.17 bug fix: magick can has no body.\n| 1.0.18 New feature: 1) Support montage command; 2) Support including .gif image into html and pdf. If it's html, play the .gif, or else if it's pdf, magick the .gif to a list of frame.\n| 1.0.19 Support lines starting with # in the magick/montage body.\n| 1.1.0 Bug fix: It doesn't work for ditaa with magick parameters.\n| 1.1.1 Support the following plot command: blockdiag, seqdiag, actdiag, nwdiag.\n| 1.1.2 magick command must be in command line or in content with one worad \u201cmagick\u201d in command line.\n| 1.1.3 Bug fix: make html might cause the following error: AttributeError: 'str' object has no attribute 'extend'\n| 1.1.4 Support inline image.\n| 1.1.5 When the output is .gif, print the frames in 8 frames in every row by default.\n| 1.1.6 When .gif is given width, then increase it in latexpdf output.\n| 1.1.7 Support new commands: dwebp and others.\n| 1.1.8 Support new command cp to incluce .webp.\n\nRefenreces\n==========\n\n#. gnuplot, http://www.gnuplot.info/\n#. ditaa, https://github.com/tmthrgd/ditaa-ditaa\n#. Matplotlib, https://matplotlib.org/\n#. graphviz, https://graphviz.org/\n#. imagemagick, https://imagemagick.org\n#. blockdiag, http://blockdiag.com/en/blockdiag/index.html\n#. seqdiag , http://blockdiag.com/en/seqdiag/index.html\n#. actdiag , http://blockdiag.com/en/nwdiag/actdiag.html\n#. nwdiag , http://blockdiag.com/en/nwdiag/index.html\n\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "A sphinx extension to plot graph such as ditaa, gnuplot, pyplot, etc in you sphinx document.",
"version": "1.1.8",
"project_urls": {
"Homepage": "https://github.com/stathissideris/sphinxcontrib-plot"
},
"split_keywords": [
"sphinx",
" sphinxcontrib",
" plot",
" ditaa",
" gnuplot",
" magick"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8762d99b5544e1e93f0f798f402f28a084c23cadb7bf9cd2e9943613a06532a1",
"md5": "3a7109da3518f9806b7715b252aae327",
"sha256": "31471152b81417b44205495bc2de764bd5d5a59f4be83873b6eaa53ba89ead7d"
},
"downloads": -1,
"filename": "sphinxcontrib_plot-1.1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3a7109da3518f9806b7715b252aae327",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 16019,
"upload_time": "2025-09-10T03:16:50",
"upload_time_iso_8601": "2025-09-10T03:16:50.403504Z",
"url": "https://files.pythonhosted.org/packages/87/62/d99b5544e1e93f0f798f402f28a084c23cadb7bf9cd2e9943613a06532a1/sphinxcontrib_plot-1.1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "860cb0e66b93536997bd2524b739f2cc5102b9f8221483bfd330badf2d9c89e1",
"md5": "db22b73a1efe9c8be13a9a1fefbc02d4",
"sha256": "7c634aa8915dfcc7e686e8cccf0fb845154bbd443539a09d28192f86d047ad8f"
},
"downloads": -1,
"filename": "sphinxcontrib_plot-1.1.8.tar.gz",
"has_sig": false,
"md5_digest": "db22b73a1efe9c8be13a9a1fefbc02d4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 21016,
"upload_time": "2025-09-10T03:16:52",
"upload_time_iso_8601": "2025-09-10T03:16:52.053822Z",
"url": "https://files.pythonhosted.org/packages/86/0c/b0e66b93536997bd2524b739f2cc5102b9f8221483bfd330badf2d9c89e1/sphinxcontrib_plot-1.1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-10 03:16:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stathissideris",
"github_project": "sphinxcontrib-plot",
"github_not_found": true,
"lcname": "sphinxcontrib-plot"
}
JSON
