Función pie() de 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ámetro | Tipo | Descripción |
|---|---|---|
| x | 1D array-like | Valor de cada sector (obligatorio), normalizado automáticamente |
| explode | array-like | Distancia de cada sector desde el centro, 0 indica sin desviación |
| labels | list | Texto de etiqueta de cada sector |
| colors | list | Color de cada sector |
| autopct | str o callable | Mostrar automáticamente el porcentaje, por ejemplo '%1.1f%%' indica un decimal; None no muestra |
| pctdistance | float | Relación de distancia del texto de porcentaje al centro, por defecto 0.6 |
| shadow | bool | Si añadir efecto de sombra |
| labeldistance | float | Relación de distancia de las etiquetas al centro, por defecto 1.1 |
| startangle | float | Ángulo inicial del primer sector (sentido antihorario), 0 indica comenzar desde la dirección de las 3 en punto |
| radius | float | Radio del gráfico de pastel, por defecto 1 |
| counterclock | bool | Dirección de los sectores: True antihorario (predeterminado), False horario |
| wedgeprops | dict | Parámetros pasados a cada sector (Wedge), por ejemplo {'edgecolor':'white', 'linewidth':1} |
| textprops | dict | Parámetros pasados a los textos, por ejemplo {'fontsize':12, 'color':'gray'} |
| center | tuple | Coordenadas del centro del gráfico de pastel, por defecto (0, 0) |
| normalize | bool | Si 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
# 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
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
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
# 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}%'。
Otras extensiones