Basic pie chart with plt.pie in Matplotlib - Deep Dive

Overview - Basic pie chart with plt.pie

What is it?

A pie chart is a circular graph divided into slices to show proportions of a whole. The plt.pie function in matplotlib creates these charts easily by taking data values and displaying each as a slice. Each slice's size corresponds to its value's share of the total. This helps visualize parts of a dataset in a simple, clear way.

Why it matters

Pie charts help people quickly see how different parts compare to the whole, like how a budget is split or survey results. Without pie charts, understanding proportions at a glance would be harder, requiring more complex tables or numbers. They make data stories easier to tell and understand, especially for non-technical audiences.

Where it fits

Before learning pie charts, you should know basic Python and how to use matplotlib for plotting. After mastering pie charts, you can explore other chart types like bar charts and histograms to visualize data in different ways.

Mental Model

Core Idea

A pie chart slices a circle into parts where each slice size shows how big that part is compared to the whole.

Think of it like...

Imagine cutting a pizza into slices where each slice size shows how hungry each friend is; bigger slices mean hungrier friends.

  _________
 /         \
|  Slice 1 |
|  Slice 2 |
|  Slice 3 |
 \_________/

Each slice's angle shows its share of the total circle.

Build-Up - 7 Steps

1

Foundation

Understanding Pie Chart Basics

Concept: What a pie chart represents and how slices relate to data values.

A pie chart shows parts of a whole as slices of a circle. Each slice size is proportional to its data value compared to the total sum of all values. For example, if you have data [10, 20, 30], the total is 60. The slice for 10 covers 10/60 of the circle, or about 60 degrees.

Result

You understand that pie charts visually compare parts to the whole using slice sizes.

Understanding the proportional relationship between slice size and data value is key to interpreting pie charts correctly.

2

Foundation

Installing and Importing Matplotlib

Concept: How to set up matplotlib and import it to create plots.

To use plt.pie, first install matplotlib with 'pip install matplotlib' if needed. Then import it in Python with 'import matplotlib.pyplot as plt'. This prepares your environment to create pie charts and other plots.

Result

You can run matplotlib commands to create visualizations.

Knowing how to set up and import matplotlib is essential before making any plots.

3

Intermediate

Creating a Simple Pie Chart

🤔Before reading on: do you think plt.pie needs labels to work or can it plot slices without them? Commit to your answer.

Concept: Using plt.pie with just data values to draw a basic pie chart.

Use plt.pie([10, 20, 30]) to create a pie chart with three slices. Then call plt.show() to display it. Labels are optional; if omitted, slices appear without names. This shows the basic usage of plt.pie.

Result

A pie chart window opens showing three slices sized 10, 20, and 30 parts.

Knowing that plt.pie can plot without labels helps you start simple and add details later.

4

Intermediate

Adding Labels and Colors

🤔Before reading on: do you think you can customize slice colors and labels separately or must they match exactly? Commit to your answer.

Concept: Enhancing pie charts with labels and custom colors for clarity.

Pass labels=['A', 'B', 'C'] to name slices and colors=['red', 'green', 'blue'] to set slice colors. Example: plt.pie([10, 20, 30], labels=['A', 'B', 'C'], colors=['red', 'green', 'blue']). This makes the chart easier to understand.

Result

The pie chart shows slices named A, B, C with red, green, and blue colors respectively.

Customizing labels and colors improves communication and makes charts more readable.

5

Intermediate

Exploding Slices for Emphasis

🤔Before reading on: do you think exploding a slice moves all slices or just the selected one? Commit to your answer.

Concept: Using the explode parameter to highlight specific slices by offsetting them.

The explode parameter takes a list of offsets for each slice. For example, explode=[0, 0.1, 0] moves the second slice slightly outwards. This draws attention to that slice visually.

Result

The pie chart shows the second slice separated slightly from the rest.

Exploding slices helps highlight important parts of data without changing the data itself.

6

Advanced

Adding Percentages and Shadows

🤔Before reading on: do you think percentages are calculated automatically or must you compute them yourself? Commit to your answer.

Concept: Displaying slice percentages and adding shadows for better visuals.

Use autopct='%1.1f%%' to show percentages on slices automatically. Add shadow=True to create a shadow effect. Example: plt.pie([10, 20, 30], autopct='%1.1f%%', shadow=True). This improves chart aesthetics and information.

Result

The pie chart shows slice sizes as percentages with a shadow effect.

Automatic percentage labels save time and make charts more informative at a glance.

7

Expert

Handling Edge Cases and Customizations

🤔Before reading on: do you think plt.pie can handle zero or negative values gracefully? Commit to your answer.

Concept: Understanding how plt.pie behaves with zero or negative values and advanced customization options.

plt.pie ignores zero values by not drawing slices for them but raises errors for negative values. You can customize startangle to rotate the chart and counterclock to change slice order. Example: plt.pie([10, 0, 30], startangle=90, counterclock=False). Knowing these helps create polished charts and avoid errors.

Result

The pie chart rotates so the first slice starts at 90 degrees and slices go clockwise; zero-value slices are skipped.

Knowing how plt.pie handles special values and rotation options prevents bugs and improves presentation.

Under the Hood

plt.pie calculates the sum of all data values to find the total. Then it computes each slice's angle by dividing each value by the total and multiplying by 360 degrees. It draws each slice as a wedge of the circle with the calculated angle. Labels and colors are applied as text and fill colors. Explode offsets move slices outward by adjusting their center positions. Percentages are formatted strings based on slice proportions.

Why designed this way?

The pie chart design follows the natural way humans understand parts of a whole as slices of a circle. Using angles to represent proportions is intuitive and visually clear. The explode and autopct features were added to enhance communication and highlight important data. The design balances simplicity with flexibility to cover common use cases without overwhelming complexity.

Data values --> Sum total --> Calculate slice angles --> Draw wedges with colors
          |                                         |
          v                                         v
     Apply labels and percentages           Apply explode offsets
          |                                         |
          v                                         v
       Render pie chart with shadows and rotation

Myth Busters - 4 Common Misconceptions

Quick: Does a pie chart always need labels to be useful? Commit yes or no.

Common Belief: Pie charts must always have labels to be understood.

Reality: Pie charts can be useful without labels if colors or legends explain slices, especially for simple data.

Why it matters: Believing labels are always required may stop you from making quick, clean charts where labels clutter the view.

Quick: Can pie charts show negative values correctly? Commit yes or no.

Common Belief: Pie charts can display negative values as slices.

Reality: Pie charts cannot represent negative values; matplotlib raises errors if negatives are included.

Why it matters: Trying to plot negative values causes errors and confusion; you must preprocess data or choose other charts.

Quick: Do exploding slices move all slices or just the selected one? Commit your answer.

Common Belief: Exploding one slice pushes all slices outward evenly.

Reality: Only the specified slice moves outward; others stay in place.

Why it matters: Misunderstanding explode behavior can lead to unexpected chart layouts and misinterpretation.

Quick: Are pie charts always the best choice for showing proportions? Commit yes or no.

Common Belief: Pie charts are always the best way to show parts of a whole.

Reality: Pie charts are less effective with many slices or similar sizes; bar charts or other plots may be clearer.

Why it matters: Overusing pie charts can confuse viewers and hide important differences.

Expert Zone

1

Exploding multiple slices simultaneously can create visual imbalance; subtle offsets work best.

2

The startangle parameter affects slice order and can improve readability depending on data story.

3

Using autopct with a custom function allows precise control over percentage formatting and conditional labels.

When NOT to use

Avoid pie charts when you have many categories or very small slices; use bar charts or stacked bar charts instead for clearer comparison.

Production Patterns

Professionals use pie charts in dashboards for quick status views, often combining them with legends and interactive tooltips. They carefully limit slice count and use consistent colors for brand or theme alignment.

Connections

Bar Chart

Alternative visualization for comparing parts of a whole

Knowing when to use bar charts instead of pie charts helps communicate data more clearly when there are many categories or small differences.

Data Storytelling

Pie charts are a tool to tell simple data stories visually

Understanding pie charts enhances your ability to craft clear narratives that non-technical audiences can grasp quickly.

Human Perception of Angles

Pie charts rely on how humans perceive angles and areas

Knowing that humans find it harder to compare angles than lengths explains why pie charts can be less precise than bar charts.

Common Pitfalls

#1 Trying to plot negative values in a pie chart.

Wrong approach:

plt.pie([10, -5, 15])
plt.show()

Correct approach:

plt.pie([10, 0, 15])
plt.show()

Root cause:

Pie charts cannot represent negative values; negative inputs cause errors.

#2 Not calling plt.show() after plt.pie, so no chart appears.

Wrong approach:

plt.pie([10, 20, 30])

Correct approach:

plt.pie([10, 20, 30])
plt.show()

Root cause:

plt.pie creates the chart but plt.show() is needed to display it.

#3 Using explode with wrong length list causing error.

Wrong approach:

plt.pie([10, 20, 30], explode=[0.1, 0.2])
plt.show()

Correct approach:

plt.pie([10, 20, 30], explode=[0.1, 0.2, 0])
plt.show()

Root cause:

Explode list length must match data length exactly.

Key Takeaways

Pie charts show parts of a whole by dividing a circle into slices sized by data values.

Matplotlib's plt.pie function creates pie charts easily with options for labels, colors, and slice offsets.

Exploding slices and adding percentages improve chart clarity and highlight important data.

Pie charts cannot display negative values and work best with few categories and clear differences.

Understanding pie charts helps communicate data stories visually to both technical and non-technical audiences.