bar_chart_race

To create a bar chart race, your data must be in a 'wide' format within a pandas DataFrame:

• Rows: Represent a single period of time.
• Columns: Each column holds the value for a particular category.
• Index: Contains the time component (optional).

Example structure: A DataFrame where the index is a date, columns are country names, and values are death counts.

To save animations as video formats such as .mp4, .m4v, or .mov, you must install ffmpeg.

After installation, verify it is correctly added to your system PATH by running ffmpeg -version in your terminal.

To display an animation directly within a Jupyter Notebook instead of saving it to a file, set the filename parameter to None.

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

The bar_chart_race package requires the following Python libraries to be installed in your environment:

• matplotlib
• pandas

Use the bar_chart_race function to create animations. If you are in a Jupyter Notebook, the animation is automatically embedded as a video. You can use load_dataset to access sample DataFrames.

import bar_chart_race
df = bcr.load_dataset('covid19_tutorial')
df.bcr.bar_chart_race()

To create animated .gif files, you must install ImageMagick.

After installation, verify it is correctly added to your system PATH by running magick -version in your terminal.

You can install the bar_chart_race package using either pip or conda.

pip install bar_chart_race
# or
conda install -c conda-forge bar_chart_race

You can install the bar_chart_race package using either pip or conda.

pip install bar_chart_race
# or
conda install -c conda-forge bar_chart_race

To save the animation as a video file (e.g., .mp4, .mov) or a .gif, pass the filename as the first argument to bar_chart_race.

Requirements:

• For video formats: Install ffmpeg.
• For GIF format: Install ImageMagick.

# Save as MP4
df.bcr.bar_chart_race('output_video.mp4', figsize=(5, 3))

If you are not in a Jupyter Notebook but have IPython installed, the function returns an HTML object. You can access the raw HTML string via the .data attribute.

df.bcr.bar_chart_race('docs/videos/covid19.mp4', figsize=(5, 3))

New parameters in version 0.2 allow for better animation control and title styling:

• end_period_pause: Sets a pause (in milliseconds) at the end of each period.
• title: Can be a string or a dictionary. When using a dictionary, use the 'label' key for the title text, and other keys to control text properties.

Use the following parameters to control how bar labels appear:

• bar_textposition: Specifies the position of the bar label. Options are 'outside', 'inside', or None.
• bar_texttemplate: Allows for label formatting using either a string or a function.