Display a bar 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.bar_chart does not guess the data specification correctly, try specifying your desired chart using st.altair_chart.
Function signature[source] | |
---|---|
st.bar_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, or dict) | Data to be plotted. |
x (str or None) | Column name to use for the x-axis. If None, uses the data index for the x-axis. |
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. |
color (str, tuple, Sequence of str, Sequence of tuple, or None) | The color to use for different series in this chart. For a bar chart with just one series, this can be:
For a bar chart with multiple series, where the dataframe is in long format (that is, y is None or just one column), this can be:
For a bar chart with multiple series, where the dataframe is in wide format (that is, y is a Sequence of columns), this can be:
|
width (int) | The chart width in pixels. If 0, selects the width automatically. |
height (int) | The chart height in pixels. If 0, selects the height automatically. |
use_container_width (bool) | If True, set the chart width to the column width. This takes precedence over the width argument. |
Examples
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.bar_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": list(range(20)) * 3, "col2": np.random.randn(60), "col3": ["A"] * 20 + ["B"] * 20 + ["C"] * 20, } ) st.bar_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 series with different colors:
import streamlit as st import pandas as pd import numpy as np chart_data = pd.DataFrame( {"col1": list(range(20)), "col2": np.random.randn(20), "col3": np.random.randn(20)} ) st.bar_chart( chart_data, x="col1", y=["col2", "col3"], color=["#FF0000", "#0000FF"] # Optional )
Still have questions?
Our forums are full of helpful information and Streamlit experts.