Función bar() / barh() de Matplotlib
Documentación de referencia de Matplotlib
bar()Se utiliza para dibujar gráficos de barras verticales,barh()se utiliza para dibujar gráficos de barras horizontales.
El gráfico de barras se utiliza para mostrar la comparación de cantidades de datos categóricos; cada categoría se representa con una barra que indica la magnitud de su valor.
Definición de la función
bar() - Gráfico de barras vertical
matplotlib.pyplot.bar(x, height, width=0.8, bottom=0, *, align='center',
**kwargs)
barh() - Gráfico de barras horizontal
matplotlib.pyplot.barh(y, width, height=0.8, left=0, *, align='center',
**kwargs)
Interfaz Axes
Axes.bar(x, height, width=0.8, bottom=0, *, align='center', **kwargs) Axes.barh(y, width, height=0.8, left=0, *, align='center', **kwargs)
Descripción de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| x / y | array-like | Coordenada de posición de la barra (x para vertical, y para horizontal) |
| height / width | array-like | Altura (vertical) o ancho (horizontal) de la barra, es decir, el valor de los datos |
| width(bar)/ height(barh) | float o array-like | Ancho/alto de la barra, por defecto 0.8 |
| bottom / left | float o array-like | Posición inicial de la parte inferior de la barra, por defecto 0. Se puede utilizar para dibujar gráficos de barras apilados. |
| align | str | Alineación de la barra con respecto a las coordenadas x/y: 'center' (por defecto) o 'edge' |
| color | color o lista | Color de la barra, puede ser un solo color o una lista de colores |
| edgecolor | color | Color del borde de la barra |
| linewidth / lw | float | Grosor del borde de la barra |
| tick_label | array-like | Etiquetas de los ticks de las barras, correspondientes uno a uno con la posición x |
| label | str | Etiqueta de leyenda (para gráficos de barras agrupados) |
| alpha | float | Transparencia |
| hatch | str | Patrón de relleno: '/', '\', '|', '-', '+', 'x', 'o', '*' |
Notas complementarias sobre bar_label()
bar_label()Se utiliza para mostrar etiquetas de valor directamente en las barras.
Axes.bar_label(container, labels=None, *, fmt=None, label_type='edge',
padding=0, **kwargs)
bar() y barh() devuelven un
BarContainerobjeto, que se puede pasar a bar_label() para añadir etiquetas de valor. Esta es la práctica recomendada en Matplotlib 3.4+.
Ejemplos de uso
Ejemplo 1: Gráfico de barras vertical básico
Ejemplo
# Etiquetas de categorías y datos
categories = ['Python', 'Java', 'JavaScript', 'C++', 'Go']
values = [85, 72, 68, 55, 42]
fig, ax = plt.subplots(layout='constrained')
# Dibujar el gráfico de barras
bars = ax.bar(categories, values,
color=['#3498db', '#e74c3c', '#f39c12', '#2E7DCC', '#9b59b6'],
edgecolor='white', linewidth=1)
# Mostrar los valores en las barras
ax.bar_label(bars, fmt='%d', padding=3)
ax.set_title('Programming Language Popularity')
ax.set_ylabel('Score')
ax.set_ylim(0, 100)
ax.grid(axis='y', alpha=0.3)
plt.show()
Ejemplo 2: Gráfico de barras agrupado
Ejemplo
import numpy as np
# Datos agrupados
labels = ['Q1', 'Q2', 'Q3', 'Q4']
product_a = [120, 135, 148, 162]
product_b = [90, 105, 115, 130]
x = np.arange(len(labels)) # Posición x: [0, 1, 2, 3]
width = 0.35 # Ancho de cada barra
fig, ax = plt.subplots(layout='constrained')
# Primer grupo de barras (desplazamiento -width/2)
bars1 = ax.bar(x - width/2, product_a, width,
label='Product A', color='steelblue', edgecolor='white')
# Segundo grupo de barras (desplazamiento +width/2)
bars2 = ax.bar(x + width/2, product_b, width,
label='Product B', color='coral', edgecolor='white')
# Añadir etiquetas de valor
ax.bar_label(bars1, padding=3, fmt='%d')
ax.bar_label(bars2, padding=3, fmt='%d')
ax.set_title('Quarterly Sales Comparison')
ax.set_ylabel('Sales (units)')
ax.set_xticks(x)
ax.set_xticklabels(labels)
ax.legend()
ax.grid(axis='y', alpha=0.3)
plt.show()
Ejemplo 3: Gráfico de barras apilado
Ejemplo
categories = ['Jan', 'Feb', 'Mar', 'Apr', 'May']
income = [5000, 5200, 4800, 5500, 6000]
expense = [3000, 3500, 3200, 4000, 4200]
fig, ax = plt.subplots(layout='constrained')
# Primera capa de barras (parte inferior)
bars_income = ax.bar(categories, income,
label='Income', color='#2E7DCC', edgecolor='white')
# Segunda capa de barras (apilada sobre la primera capa)
bars_expense = ax.bar(categories, expense, bottom=income,
label='Expense', color='#e74c3c', edgecolor='white')
# Añadir etiquetas
ax.bar_label(bars_income, label_type='center', fmt='$%d')
ax.bar_label(bars_expense, label_type='center', fmt='$%d')
ax.set_title('Stacked Bar Chart: Monthly Finance')
ax.set_ylabel('Amount ($)')
ax.legend()
ax.grid(axis='y', alpha=0.3)
plt.show()
Ejemplo 4: Gráfico de barras horizontal (barh)
Ejemplo
tasks = ['Task A', 'Task B', 'Task C', 'Task D', 'Task E']
hours = [12.5, 8.0, 15.3, 6.2, 10.8]
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Gráfico de barras horizontal
bars = ax.barh(tasks, hours,
color='#3498db', edgecolor='white', height=0.6)
# Añadir etiquetas al final de las barras
ax.bar_label(bars, fmt='%.1f h', padding=5)
ax.set_title('Task Completion Time (Horizontal Bar)')
ax.set_xlabel('Hours')
ax.invert_yaxis() # Invertir el eje y para que la primera categoría esté en la parte superior
ax.grid(axis='x', alpha=0.3)
plt.show()
Preguntas frecuentes
¿Correspondencia de ejes entre bar() y barh()?
bar(x, height): x es la posición, height determina la altura de la barra (dirección vertical).
barh(y, width): y es la posición, width determina el ancho de la barra (dirección horizontal).
Ten en cuenta que los nombres de los parámetros son diferentes: bar usa height, barh usa width para representar el valor de los datos.
¿Cómo hacer que las barras de un gráfico de barras agrupado queden pegadas entre sí?
va awidthEstablécelo como el recíproco del ancho total de cada grupo de barras y utilizaalign='edge'。
Otras extensiones