Función Matplotlib errorbar()


Matplotlib 参考文档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ámetroTipoDescripción
x, yarray-likeCoordenadas de los puntos de datos
yerr / xerrfloat o array-likeError 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.
fmtstrCadena de formato para los puntos de datos, por ejemplo 'o' (círculo), 's' (cuadrado), 'o-' (círculo + línea)
ecolorcolorColor de las líneas de las barras de error
elinewidthfloatAncho de las líneas de las barras de error
capsizefloatLongitud de las líneas horizontales en los extremos de las barras de error (en puntos)
capthickfloatGrosor de las líneas horizontales en los extremos de las barras de error
barsaboveboolSi es True, las barras de error se dibujan encima de los puntos de datos
lolims / uplimsarray-like of boolIndica el límite inferior/superior en la dirección y (solo flechas en un lado)
xlolims / xuplimsarray-like of boolIndica el límite inferior/superior en la dirección x
erroreveryintDibuja barras de error cada varios puntos de datos (reduce el desorden visual cuando los datos son densos)

errorbar() devuelve unErrorbarContainerobjeto, 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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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.


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

Otras extensiones