Plots

Plotting

marimo supports several popular plotting libraries, including matplotlib, plotly, seaborn, and altair.

This tutorial gives examples using matplotlib; other libraries are used similarly. ## Matplotlib To show a plot, include it in the last expression of a cell (just like any other output).

# create the plot in the last line of the cell
import matplotlib.pyplot as plt
plt.plot([1, 2])

# create a plot
plt.plot([1, 2])
# ... do some work ...
# make plt.gca() the last line of the cell
plt.gca()

A new figure every cell. Every cell starts with an empty figure for the imperative pyplot API.

To build a figure over multiple cells, use the object-oriented API and create your own axis:

Draw plots interactively

Draw plots interactively by parametrizing them with UI elements.

Other libraries

marimo also supports these other plotting libraries:

Plotly
Seaborn
Altair

Just output their figure objects as the last expression of a cell, or embed them in markdown with mo.as_html.

If you would like another library to be integrated into marimo, please get in touch.

--- title: Plots marimo-version: 0.13.2 eval: false --- # Plotting ```python {.marimo hide_code="true"} check_dependencies() ``` marimo supports several popular plotting libraries, including matplotlib, plotly, seaborn, and altair. This tutorial gives examples using matplotlib; other libraries are used similarly.  ## Matplotlib  To show a plot, include it in the last expression of a cell (just like any other output). ```python3 # create the plot in the last line of the cell import matplotlib.pyplot as plt plt.plot([1, 2]) ``` ```{python .marimo} plt.plot([1, 2]) ``` ```python3 # create a plot plt.plot([1, 2]) # ... do some work ... # make plt.gca() the last line of the cell plt.gca() ``` ```{python .marimo} plt.plot([1, 2]) # ... do some work ... # make plt.gca() the last line of the cell plt.gca() ``` ```python {.marimo hide_code="true"} mo.accordion(plt_show_explainer) ``` **A new figure every cell.** Every cell starts with an empty figure for the imperative `pyplot` API. ```{python .marimo} x = np.linspace(start=-4, stop=4, num=100, dtype=float) ``` ```{python .marimo} plt.plot(x, x) plt.plot(x, x**2) plt.gca() ``` ```{python .marimo} plt.plot(x, x**3) ``` To build a figure over multiple cells, use the object-oriented API and create your own axis: ```{python .marimo} _, axis = plt.subplots() axis.plot(x, x) axis.plot(x, x**2) axis ``` ```{python .marimo} axis.plot(x, x**3) axis ``` ### Draw plots interactively Draw plots interactively by parametrizing them with UI elements. ```{python .marimo} exponent = mo.ui.slider(1, 5, value=1, step=1, label='exponent') mo.md( f""" **Visualizing powers.** {exponent} """ ) ``` ```{python .marimo} @mo.cache def plot_power(exponent): plt.plot(x, x**exponent) return plt.gca() ``` ```{python .marimo} _tex = ( f"$$f(x) = x^{exponent.value}$$" if exponent.value > 1 else "$$f(x) = x$$" ) mo.md( f""" {_tex} {mo.as_html(plot_power(exponent.value))} """ ) ``` ## Other libraries  marimo also supports these other plotting libraries: - Plotly - Seaborn - Altair Just output their figure objects as the last expression of a cell, or embed them in markdown with `mo.as_html`. If you would like another library to be integrated into marimo, please get in touch. ````python {.marimo hide_code="true"} module_not_found_explainer = mo.md( """ ## Oops! It looks like you're missing a package that this tutorial requires. Use the package manager panel on the left to install **numpy** and **matplotlib**, then restart the tutorial. Or, if you use `uv`, open the tutorial with ``` uvx marimo tutorial plots ``` at the command line. """ ).callout(kind='warn') def check_dependencies(): if missing_packages: return module_not_found_explainer ```` ```python {.marimo hide_code="true"} plt_show_explainer = { "Using `plt.show()`": """ You can use `plt.show()` or `figure.show()` to display plots in the console area of a cell. Keep in mind that console outputs are not shown in the app view. """ } ``` ```{python .marimo} try: import matplotlib import matplotlib.pyplot as plt import numpy as np missing_packages = False except ModuleNotFoundError: missing_packages = True if not missing_packages: matplotlib.rcParams['figure.figsize'] = (6, 2.4) ``` ```{python .marimo} import marimo as mo ```