Display a line chart.

This is syntax-sugar around st.altair_chart. The main difference is this command uses the data's own column and indices to figure out the chart's spec. As a result this is easier to use for many "just plot this" scenarios, while being less customizable.

If st.line_chart does not guess the data specification correctly, try specifying your desired chart using st.altair_chart.

Function signature[source]

st.line_chart(data=None, *, x=None, y=None, color=None, width=0, height=0, use_container_width=True)

Parameters

data (pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, snowflake.snowpark.table.Table, Iterable, dict or None)

Data to be plotted. Pyarrow tables are not supported by Streamlit's legacy DataFrame serialization (i.e. with config.dataFrameSerialization = "legacy"). To use pyarrow tables, please enable pyarrow by changing the config setting, config.dataFrameSerialization = "arrow".

x (str or None)

Column name to use for the x-axis. If None, uses the data index for the x-axis. This argument can only be supplied by keyword.

y (str, sequence of str, or None)

Column name(s) to use for the y-axis. If a sequence of strings, draws several series on the same chart by melting your wide-format table into a long-format table behind the scenes. If None, draws the data of all remaining columns as data series. This argument can only be supplied by keyword.

color (str, tuple, sequence of str, sequence of tuple, or None)

The color to use for different lines in this chart. This argument can only be supplied by keyword.

For a line chart with just one line, this can be:

  • None, to use the default color.
  • A hex string like "#ffaa00" or "#ffaa0088".
  • An RGB or RGBA tuple with the red, green, blue, and alpha components specified as ints from 0 to 255 or floats from 0.0 to 1.0.

For a line chart with multiple lines, where the dataframe is in long format (that is, y is None or just one column), this can be:

  • None, to use the default colors.

  • The name of a column in the dataset. Data points will be grouped into lines of the same color based on the value of this column. In addition, if the values in this column match one of the color formats above (hex string or color tuple), then that color will be used.

    For example: if the dataset has 1000 rows, but this column can only contains the values "adult", "child", "baby", then those 1000 datapoints will be grouped into three lines, whose colors will be automatically selected from the default palette.

    But, if for the same 1000-row dataset, this column contained the values "#ffaa00", "#f0f", "#0000ff", then then those 1000 datapoints would still be grouped into three lines, but their colors would be "#ffaa00", "#f0f", "#0000ff" this time around.

For a line chart with multiple lines, where the dataframe is in wide format (that is, y is a sequence of columns), this can be:

  • None, to use the default colors.
  • A list of string colors or color tuples to be used for each of the lines in the chart. This list should have the same length as the number of y values (e.g. color=["#fd0", "#f0f", "#04f"] for three lines).

width (int)

The chart width in pixels. If 0, selects the width automatically. This argument can only be supplied by keyword.

height (int)

The chart height in pixels. If 0, selects the height automatically. This argument can only be supplied by keyword.

use_container_width (bool)

If True, set the chart width to the column width. This takes precedence over the width argument. This argument can only be supplied by keyword.

Example

import streamlit as st
import pandas as pd
import numpy as np

chart_data = pd.DataFrame(
    np.random.randn(20, 3),
    columns=['a', 'b', 'c'])

st.line_chart(chart_data)

You can also choose different columns to use for x and y, as well as set the color dynamically based on a 3rd column (assuming your dataframe is in long format):

import streamlit as st
import pandas as pd
import numpy as np

chart_data = pd.DataFrame({
    'col1' : np.random.randn(20),
    'col2' : np.random.randn(20),
    'col3' : np.random.choice(['A','B','C'], 20)
})

st.line_chart(
    chart_data,
    x = 'col1',
    y = 'col2',
    color = 'col3'
)

Finally, if your dataframe is in wide format, you can group multiple columns under the y argument to show multiple lines with different colors:

import streamlit as st
import pandas as pd
import numpy as np

chart_data = pd.DataFrame(
    np.random.randn(20, 3),
    columns = ['col1', 'col2', 'col3'])

st.line_chart(
    chart_data,
    x = 'col1',
    y = ['col2', 'col3'],
    color = ['#FF0000', '#0000FF']  # Optional
)
forum

Still have questions?

Our forums are full of helpful information and Streamlit experts.

Was this page helpful?

editEdit this page on GitHub