Skip to main content
The LinePlot component creates interactive line charts from pandas DataFrames.

​
Basic usage

import gradio as gr
import pandas as pd

df = pd.DataFrame({
    "time": [1, 2, 3, 4, 5],
    "value": [10, 20, 15, 25, 30]
})

gr.LinePlot(
    value=df,
    x="time",
    y="value"
)

​
Constructor

​
value
pd.DataFrame | Callable | None
default:"None"
Pandas DataFrame containing the data
​
x
str | None
default:"None"
Column name for x-axis
​
y
str | None
default:"None"
Column name for y-axis (must be numeric)
​
color
str | None
default:"None"
Column name for color grouping
​
title
str | None
default:"None"
Chart title
​
x_title
str | None
default:"None"
X-axis title
​
y_title
str | None
default:"None"
Y-axis title
​
color_map
dict[str, str] | None
default:"None"
Mapping of series to colors
​
height
int | None
default:"None"
Plot height in pixels

​
Events

  • select - Triggered when point is selected
  • double_click - Triggered on double click

​
Example

import gradio as gr
import pandas as pd
import numpy as np

def create_timeseries():
    dates = pd.date_range('2024-01-01', periods=30)
    df = pd.DataFrame({
        "date": dates,
        "value": np.cumsum(np.random.randn(30)),
        "series": ["A"] * 15 + ["B"] * 15
    })
    return df

gr.LinePlot(
    value=create_timeseries(),
    x="date",
    y="value",
    color="series",
    title="Time Series Data"
)