Función pie() de Matplotlib


Matplotlib 参考文档Documentación de referencia de Matplotlib

pie()Se usa para dibujar gráficos de pastel, mostrando la relación de proporción de cada parte en el todo.

El gráfico de pastel es adecuado para mostrar la proporción de pocas categorías (generalmente dentro de 5-8).

Definición de la función

Interfaz pyplot

matplotlib.pyplot.pie(x, explode=None, labels=None, colors=None,
    autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1,
    startangle=0, radius=1, counterclock=True, wedgeprops=None,
    textprops=None, center=(0, 0), frame=False, rotatelabels=False, *,
    normalize=True, hatch=None, **kwargs)

Interfaz Axes

Axes.pie(x, explode=None, labels=None, colors=None, autopct=None,
    pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=0,
    radius=1, counterclock=True, wedgeprops=None, textprops=None,
    center=(0, 0), frame=False, rotatelabels=False, *,
    normalize=True, hatch=None, **kwargs)

Descripción de parámetros

ParámetroTipoDescripción
x1D array-likeValor de cada sector (obligatorio), normalizado automáticamente
explodearray-likeDistancia de cada sector desde el centro, 0 indica sin desviación
labelslistTexto de etiqueta de cada sector
colorslistColor de cada sector
autopctstr o callableMostrar automáticamente el porcentaje, por ejemplo '%1.1f%%' indica un decimal; None no muestra
pctdistancefloatRelación de distancia del texto de porcentaje al centro, por defecto 0.6
shadowboolSi añadir efecto de sombra
labeldistancefloatRelación de distancia de las etiquetas al centro, por defecto 1.1
startanglefloatÁngulo inicial del primer sector (sentido antihorario), 0 indica comenzar desde la dirección de las 3 en punto
radiusfloatRadio del gráfico de pastel, por defecto 1
counterclockboolDirección de los sectores: True antihorario (predeterminado), False horario
wedgepropsdictParámetros pasados a cada sector (Wedge), por ejemplo {'edgecolor':'white', 'linewidth':1}
textpropsdictParámetros pasados a los textos, por ejemplo {'fontsize':12, 'color':'gray'}
centertupleCoordenadas del centro del gráfico de pastel, por defecto (0, 0)
normalizeboolSi normalizar x para que la suma sea 1, por defecto True

pie() devuelve tres listas:(patches, texts, autotexts)patches son los objetos de sector, texts son las etiquetas de texto, autotexts son los textos de porcentaje.


Ejemplos de uso

Ejemplo 1: Gráfico de pastel básico

Ejemplo

import matplotlib.pyplot as plt

# Datos
sizes = [30, 25, 20, 15, 10]
labels = ['Python', 'Java', 'JavaScript', 'C++', 'Go']
colors = ['#3498db', '#e74c3c', '#f39c12', '#2E7DCC', '#9b59b6']

fig, ax = plt.subplots(layout='constrained')

# Dibujar gráfico de pastel
ax.pie(sizes, labels=labels, colors=colors,
       autopct='%1.1f%%',         # Mostrar porcentaje, con un decimal
       startangle=90,             # Comenzar desde la dirección de las 12 en punto
       wedgeprops={'edgecolor': 'white', 'linewidth': 1})

ax.set_title('Programming Language Usage')
plt.show()

Ejemplo 2: Resaltar un sector específico (explode)

Ejemplo

import matplotlib.pyplot as plt

sizes = [35, 25, 20, 12, 8]
labels = ['Search', 'Social', 'Direct', 'Email', 'Referral']
explode = (0.1, 0, 0, 0, 0)  # El primer sector (Search) sobresale 0.1

fig, ax = plt.subplots(layout='constrained')

wedges, texts, autotexts = ax.pie(
    sizes, labels=labels, explode=explode,
    autopct='%1.1f%%', startangle=90,
    colors=['#2E7DCC', '#3498db', '#9b59b6', '#f39c12', '#e74c3c'],
    wedgeprops={'edgecolor': 'white', 'linewidth': 1},
    textprops={'fontsize': 11})

# Modificar el color del texto de porcentaje
for autotext in autotexts:
    autotext.set_color('white')
    autotext.set_fontweight('bold')

ax.set_title('Website Traffic Sources', fontsize=14)
plt.show()

Ejemplo 3: Gráfico de anillo (gráfico de dona)

Ejemplo

import matplotlib.pyplot as plt

sizes = [40, 30, 20, 10]
labels = ['Chrome (40%)', 'Safari (30%)', 'Firefox (20%)', 'Other (10%)']

fig, ax = plt.subplots(layout='constrained')

# Usar wedgeprops para configurar width y crear un gráfico de anillo
wedges, texts = ax.pie(
    sizes, labels=labels,
    startangle=90,
    colors=['#4285F4', '#346EA8', '#FBBC05', '#EA4335'],
    wedgeprops={'width': 0.4,      # Ancho del sector (0~1), si es <1 es un anillo
                'edgecolor': 'white', 'linewidth': 2})

ax.set_title('Browser Market Share (Donut Chart)', fontsize=14)
plt.show()

Ejemplo 4: Gráfico de anillo multinivel

Ejemplo

import matplotlib.pyplot as plt

# Datos de la capa externa y de la capa interna
outer_sizes = [35, 30, 20, 15]
inner_sizes = [40, 30, 30]

outer_labels = ['Asia', 'Europe', 'America', 'Africa']
inner_labels = ['Mobile', 'Desktop', 'Tablet']

outer_colors = ['#FF6B6B', '#4ECDC4', '#45B7D1', '#71A0CE']
inner_colors = ['#FFE0B2', '#BBDEFB', '#C8D7E6']

fig, ax = plt.subplots(layout='constrained')

# Anillo exterior
ax.pie(outer_sizes, radius=1.3,
       labels=outer_labels,
       labeldistance=1.1,
       colors=outer_colors,
       wedgeprops={'width': 0.3, 'edgecolor': 'white', 'linewidth': 2})

# Anillo interior
ax.pie(inner_sizes, radius=1.0,
       labels=inner_labels,
       labeldistance=0.75,
       colors=inner_colors,
       wedgeprops={'width': 0.3, 'edgecolor': 'white', 'linewidth': 2})

ax.set_title('Multi-level Donut Chart', fontsize=14)
plt.show()

Preguntas frecuentes

¿Cuándo usar gráfico de pastel vs gráfico de barras?

El gráfico de pastel es adecuado para mostrar la proporción de hasta 5-8 categorías; los lectores pueden percibir intuitivamente la participación en el todo.

Cuando hay demasiadas categorías (más de 8) o se necesita comparar valores con precisión, es preferible usar un gráfico de barras.

¿Explicación del formato de autopct?

'%1.1f%%'Representa un número flotante, con un ancho total de al menos 1 dígito, 1 decimal, seguido de%%(signo de porcentaje).

También se puede pasar una función, comoautopct=lambda pct: f'{pct:.1f}%'。


Matplotlib 参考文档Documentación de referencia de Matplotlib

Otras extensiones