bar_chart_race

Bar Chart Race

Make animated bar and line chart races in Python with matplotlib or plotly.

Official Documentation

Visit the bar_chart_race official documentation for detailed usage instructions.

Installation

Install with either:

• pip install bar_chart_race
• conda install -c conda-forge bar_chart_race

Quickstart

Must begin with a pandas DataFrame containing 'wide' data where:

• Every row represents a single period of time
• Each column holds the value for a particular category
• The index contains the time component (optional)

The data below is an example of properly formatted data. It shows total deaths from COVID-19 for several countries by date.

Create bar and line chart races

There are three core functions available to construct the animations.

• bar_chart_race
• bar_chart_race_plotly
• line_chart_race

The above animation was created with the help of matplotlib using the following call to bar_chart_race.

…

Save animation to disk or embed into a Jupyter Notebook

If you are working within a Jupyter Notebook, leave the filename as None and it will be automatically embedded into a Jupyter Notebook.

bcr.bar_chart_race(df=df, filename=None)

Customization

There are many options to customize the bar chart race to get the animation you desire. Below, we have an animation where the maximum x-value and order of the bars are set for the entire duration. A custom summary label and perpendicular bar of the median is also added.

…