Función Matplotlib errorbar()
Documentación de referencia de Matplotlib
errorbar()Se utiliza para dibujar gráficos de líneas con barras de error, mostrando el rango de incertidumbre de los valores medidos sobre los puntos de datos.
Se usa ampliamente en experimentos científicos, análisis estadísticos y visualización de datos de ingeniería.
Definición de la función
Interfaz pyplot
matplotlib.pyplot.errorbar(x, y, yerr=None, xerr=None, fmt='',
ecolor=None, elinewidth=None, capsize=None, barsabove=False,
lolims=False, uplims=False, xlolims=False, xuplims=False,
errorevery=1, capthick=None, *, **kwargs)
Interfaz Axes
Axes.errorbar(x, y, yerr=None, xerr=None, fmt='', ecolor=None,
elinewidth=None, capsize=None, barsabove=False, lolims=False,
uplims=False, xlolims=False, xuplims=False, errorevery=1,
capthick=None, *, **kwargs)
Descripción de parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| x, y | array-like | Coordenadas de los puntos de datos |
| yerr / xerr | float o array-like | Error en la dirección y/x. Un escalar indica el mismo error para todos los puntos; un array indica un error independiente para cada punto. Un array bidimensional puede ser [lo, hi] para especificar los errores inferior y superior respectivamente. |
| fmt | str | Cadena de formato para los puntos de datos, por ejemplo 'o' (círculo), 's' (cuadrado), 'o-' (círculo + línea) |
| ecolor | color | Color de las líneas de las barras de error |
| elinewidth | float | Ancho de las líneas de las barras de error |
| capsize | float | Longitud de las líneas horizontales en los extremos de las barras de error (en puntos) |
| capthick | float | Grosor de las líneas horizontales en los extremos de las barras de error |
| barsabove | bool | Si es True, las barras de error se dibujan encima de los puntos de datos |
| lolims / uplims | array-like of bool | Indica el límite inferior/superior en la dirección y (solo flechas en un lado) |
| xlolims / xuplims | array-like of bool | Indica el límite inferior/superior en la dirección x |
| errorevery | int | Dibuja barras de error cada varios puntos de datos (reduce el desorden visual cuando los datos son densos) |
errorbar() devuelve un
ErrorbarContainerobjeto, que contiene(plotline, caplines, barlinecols), que permite acceder por separado a la línea principal y a las líneas de las barras de error.
Ejemplos de uso
Ejemplo 1: Barras de error básicas
Ejemplo
import numpy as np
x = np.array([1, 2, 3, 4, 5])
y = np.array([3.5, 5.2, 4.8, 6.1, 7.3])
y_err = np.array([0.3, 0.5, 0.4, 0.6, 0.5]) # error de cada punto
fig, ax = plt.subplots(layout='constrained')
# dibuja un gráfico de líneas con barras de error
ax.errorbar(x, y, yerr=y_err,
fmt='o-', # círculo + línea
color='steelblue',
ecolor='gray', # color de las barras de error
elinewidth=1.5, # ancho de línea de las barras de error
capsize=5, # longitud de la línea horizontal en los extremos
capthick=1.5,
markersize=8,
label='Measurement')
ax.set_title('Errorbar Plot with y-errors')
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 2: Error asimétrico (diferente arriba y abajo)
Ejemplo
import numpy as np
x = np.arange(5)
y = np.array([10, 12, 9, 15, 13])
# array bidimensional: la primera fila es el error inferior, la segunda fila es el error superior
y_err = np.array([[0.5, 0.8, 0.6, 1.0, 0.7], # error inferior
[1.5, 1.2, 2.0, 0.8, 1.3]]) # error superior
fig, ax = plt.subplots(layout='constrained')
ax.errorbar(x, y, yerr=y_err,
fmt='s', # marcador de cuadrado, sin línea
color='coral',
ecolor='black',
capsize=6,
markersize=10,
markerfacecolor='white',
markeredgewidth=1.5,
label='Asymmetric Error')
ax.set_title('Asymmetric Error Bars (different upper/lower)')
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 3: Barras de error en ambas direcciones (con error en las direcciones x e y)
Ejemplo
import numpy as np
np.random.seed(42)
x = np.arange(8)
y = 2 * x + 1 + np.random.randn(8) * 2
x_err = np.full(8, 0.3) # error en dirección x (igual para todos los puntos)
y_err = np.random.rand(8) * 3 # error en dirección y (diferente para cada punto)
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
ax.errorbar(x, y,
xerr=x_err, # error en dirección x
yerr=y_err, # error en dirección y
fmt='o',
color='#8e44ad',
ecolor='gray',
capsize=4,
markersize=8,
label='2D Error')
ax.set_title('Error Bars in Both X and Y Directions')
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Ejemplo 4: errorevery para reducir el desorden visual
Ejemplo
import numpy as np
# puntos de datos densos (100 puntos)
x = np.linspace(0, 10, 100)
y = np.sin(x) + np.random.randn(100) * 0.1
y_err = np.full(100, 0.15)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 4),
layout='constrained')
# gráfico izquierdo: muestra barras de error en cada punto (demasiado denso)
ax1.errorbar(x, y, yerr=y_err, fmt='o', markersize=3,
capsize=2, elinewidth=0.5, errorevery=1)
ax1.set_title('errorevery=1 (too dense)')
# gráfico derecho: muestra una barra de error cada 8 puntos
ax2.errorbar(x, y, yerr=y_err, fmt='o', markersize=3,
capsize=2, elinewidth=0.5, errorevery=8)
ax2.set_title('errorevery=8 (cleaner)')
for ax in [ax1, ax2]:
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.grid(True, alpha=0.3)
plt.show()
Preguntas frecuentes
¿Diferentes formas de yerr?
Escalar: el mismo error para todos los puntos.
Array unidimensional (N,): error simétrico para cada punto (el mismo arriba y abajo).
Array bidimensional (2, N): la primera fila es el error inferior, la segunda fila es el error superior.
¿Qué hacer si no quieres líneas de conexión entre los puntos de datos?
va afmtEstablécelo como formato solo de marcador, como'o'、's'、'^', omitiendo la parte del estilo de línea.
Otras extensiones