data_explorer.md

Data Explorer

The data explorer UI element outputs a visual editor explore your data via plotting and intelligent recommendations. You can incrementally build your "main" plot by adding different encodings: x-axis, y-axis, color, size, and shape. As you build your plot, the UI element will suggest further plots by intelligently "exploding" an additional encoding derived from your base plot.

!!! note "Pandas Required"

In order to use the dataframe UI element, you must have the `pandas` package installed.
You can install it with `pip install pandas`.

/// marimo-embed size: large app_width: full

@app.cell
def __():
    import pandas as pd
    df = pd.read_csv("https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv")
    mo.ui.data_explorer(df)
    return

///

To set an initial configuration, you can pass keyword arguments to mo.ui.data_explorer. For example, to start with sepal_length on the x-axis, sepal_width on the y-axis, and species as the color encoding:

/// marimo-embed size: large app_width: full

@app.cell
def __():
    import pandas as pd
    df = pd.read_csv("https://raw.githubusercontent.com/mwaskom/seaborn-data/master/iris.csv")
    mo.ui.data_explorer(
        df,
        x="sepal_length",
        y="sepal_width",
        color="species",
    )
    return

///

::: marimo.ui.data_explorer