Show API reference for

st.graphviz_chart

Display a graph using the dagre-d3 library.

Important

You must install graphviz>=0.19.0 to use this command. You can install all charting dependencies (except Bokeh) as an extra with Streamlit:

pip install streamlit[charts]
Function signature[source]

st.graphviz_chart(figure_or_dot, use_container_width=None, *, width="content", height="content")

Parameters

figure_or_dot (graphviz.dot.Graph, graphviz.dot.Digraph, graphviz.sources.Source, str)

The Graphlib graph object or dot string to display

use_container_width (bool)

delete

use_container_width is deprecated and will be removed in a future release. For use_container_width=True, use width="stretch". For use_container_width=False, use width="content".

Whether to override the figure's native width with the width of the parent container. If use_container_width is False (default), Streamlit sets the width of the chart to fit its contents according to the plotting library, up to the width of the parent container. If use_container_width is True, Streamlit sets the width of the figure to match the width of the parent container.

width ("content", "stretch", or int)

The width of the chart element. This can be one of the following:

  • "content" (default): The width of the element matches the width of its content, but doesn't exceed the width of the parent container.
  • "stretch": The width of the element matches the width of the parent container.
  • An integer specifying the width in pixels: The element has a fixed width. If the specified width is greater than the width of the parent container, the width of the element matches the width of the parent container.

height ("content", "stretch", or int)

The height of the chart element. This can be one of the following:

  • "content" (default): The height of the element matches the height of its content.
  • "stretch": The height of the element matches the height of its content or the height of the parent container, whichever is larger. If the element is not in a parent container, the height of the element matches the height of its content.
  • An integer specifying the height in pixels: The element has a fixed height. If the content is larger than the specified height, scrolling is enabled.

Examples

import streamlit as st
import graphviz

# Create a graphlib graph object
graph = graphviz.Digraph()
graph.edge("run", "intr")
graph.edge("intr", "runbl")
graph.edge("runbl", "run")
graph.edge("run", "kernel")
graph.edge("kernel", "zombie")
graph.edge("kernel", "sleep")
graph.edge("kernel", "runmem")
graph.edge("sleep", "swap")
graph.edge("swap", "runswap")
graph.edge("runswap", "new")
graph.edge("runswap", "runmem")
graph.edge("new", "runmem")
graph.edge("sleep", "runmem")

st.graphviz_chart(graph)

Or you can render the chart from the graph using GraphViz's Dot language:

st.graphviz_chart('''
    digraph {
        run -> intr
        intr -> runbl
        runbl -> run
        run -> kernel
        kernel -> zombie
        kernel -> sleep
        kernel -> runmem
        sleep -> swap
        swap -> runswap
        runswap -> new
        runswap -> runmem
        new -> runmem
        sleep -> runmem
    }
''')
Built with Streamlit 🎈
arrow_backPrevious: st.bokeh_chartarrow_forwardNext: st.plotly_chart
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.