.. _drawdiagramrst:

================================
Display a diagram with blockdiag
================================


.. only:: html

    **Links:** :download:`notebook <draw_diagram.ipynb>`, :downloadlink:`html <draw_diagram2html.html>`, :download:`PDF <draw_diagram.pdf>`, :download:`python <draw_diagram.py>`, :downloadlink:`slides <draw_diagram.slides.html>`, :githublink:`GitHub|_doc/notebooks/draw_diagram.ipynb|*`


`blockdiag <http://blockdiag.com/>`__ is module which plots diagrams.

.. code:: ipython3

    from pyensae.graphhelper import draw_diagram

.. code:: ipython3

    img = draw_diagram("""
            blockdiag {
                A -> B -> C -> D;
                A -> E -> F -> G;
            }
            """)
    img




.. image:: draw_diagram_2_0.png



The page `blockdiag - simple block-diagram image
generator <http://blockdiag.com/en/blockdiag/index.html>`__ explains the
syntax used to describe a graph.

.. code:: ipython3

    draw_diagram("""
    blockdiag admin {
       A -> B -> C -> D;
       A -> E;
       A -> H;
    
       // A and B belong to first group.
       group {
          A; B;
       }
    }
    """)




.. image:: draw_diagram_4_0.png