Fonction errorbar() de Matplotlib


Matplotlib 参考文档Documentation de référence de Matplotlib

errorbar()Utilisée pour tracer des graphiques en courbes avec barres d'erreur, affichant la plage d'incertitude des valeurs mesurées aux points de données.

Largement utilisée dans les expériences scientifiques, l'analyse statistique et la visualisation de données d'ingénierie.

Définition de fonction

Interface 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)

Interface 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)

Description du paramètre

ParamètreTypeDescription
x, yde type tableauCoordonnées des points de données
yerr / xerrfloat ou array-likeErreur dans la direction y/x. Un scalaire signifie la même erreur pour tous les points ; un tableau signifie des erreurs indépendantes pour chaque point. Un tableau 2D peut spécifier les erreurs inférieure et supérieure sous la forme [lo, hi].
fmtstrChaîne de format pour les points de données, par ex. 'o' (cercle), 's' (carré), 'o-' (cercle + ligne).
ecolorcolorCouleur des lignes des barres d'erreur.
elinewidthfloatLargeur des lignes des barres d'erreur.
capsizefloatLongueur des lignes d'embout des barres d'erreur (en points).
capthickfloatÉpaisseur des lignes d'embout des barres d'erreur.
barsaboveboolSi True, les barres d'erreur sont tracées au-dessus des points de données.
lolims / uplimsde type tableau de booléensIndiquez la limite inférieure/supérieure dans la direction y (flèches unilatérales uniquement).
xlolims / xuplimsde type tableau de booléensIndiquez la limite inférieure/supérieure dans la direction x.
erroreveryintTracez des barres d'erreur à intervalles de quelques points de données (réduit l'encombrement visuel lorsque les données sont denses).

errorbar() renvoie unErrorbarContainerobjet, contenant(plotline, caplines, barlinecols), permettant un accès séparé à la ligne principale et aux lignes des barres d'erreur.


Exemples d'utilisation

Exemple 1 : Barres d'erreur de base

Exemple

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])  # Erreur pour chaque point

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

# Tracez un graphique en courbes avec des barres d'erreur
ax.errorbar(x, y, yerr=y_err,
            fmt='o-',             # Cercles + ligne
            color='steelblue',
            ecolor='gray',        # Couleur des barres d'erreur
            elinewidth=1.5,       # Largeur de ligne des barres d'erreur
            capsize=5,            # Longueur des embouts
            capthick=1.5,
            markersize=8,
            label='Mesure')

ax.set_title('Tracé de barres d'erreur avec erreurs en y')
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Exemple 2 : Erreurs inégales (limites supérieure et inférieure différentes)

Exemple

import matplotlib.pyplot as plt
import numpy as np

x = np.arange(5)
y = np.array([10, 12, 9, 15, 13])

# Tableau 2D : la première ligne est l'erreur de limite inférieure, la deuxième ligne est l'erreur de limite supérieure
y_err = np.array([[0.5, 0.8, 0.6, 1.0, 0.7],   # Erreur inférieure
                  [1.5, 1.2, 2.0, 0.8, 1.3]])  # Erreur supérieure

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

ax.errorbar(x, y, yerr=y_err,
            fmt='s',              # Marqueur carré, sans ligne
            color='coral',
            ecolor='black',
            capsize=6,
            markersize=10,
            markerfacecolor='white',
            markeredgewidth=1.5,
            label='Erreur asymétrique')

ax.set_title('Barres d'erreur asymétriques (différentes en haut et en bas)')
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Exemple 3 : Barres d'erreur bidirectionnelles (erreurs dans les deux directions x et y)

Exemple

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)          # erreur en direction x (identique pour tous les points)
y_err = np.random.rand(8) * 3    # erreur en direction y (différente pour chaque point)

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

ax.errorbar(x, y,
            xerr=x_err,           # erreur en direction x
            yerr=y_err,           # erreur en direction y
            fmt='o',
            color='#8e44ad',
            ecolor='gray',
            capsize=4,
            markersize=8,
            label='Erreur 2D')

ax.set_title('Barres d'erreur dans les deux directions X et Y')
ax.set_xlabel('X')
ax.set_ylabel('Y')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()

Exemple 4 : Utilisation de errorevery pour réduire l'encombrement visuel

Exemple

import matplotlib.pyplot as plt
import numpy as np

# Points de données denses (100 points)
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')

# Graphique de gauche : afficher les barres d'erreur pour chaque point (trop dense)
ax1.errorbar(x, y, yerr=y_err, fmt='o', markersize=3,
             capsize=2, elinewidth=0.5, errorevery=1)
ax1.set_title('errorevery=1 (trop dense)')

# Graphique de droite : afficher une barre d'erreur tous les 8 points
ax2.errorbar(x, y, yerr=y_err, fmt='o', markersize=3,
             capsize=2, elinewidth=0.5, errorevery=8)
ax2.set_title('errorevery=8 (plus propre)')

for ax in [ax1, ax2]:
    ax.set_xlabel('X')
    ax.set_ylabel('Y')
    ax.grid(True, alpha=0.3)

plt.show()

Questions fréquentes

Différentes formes de yerr ?

Scalaire : même erreur pour tous les points.

Tableau 1D (N,) : erreur symétrique pour chaque point (les erreurs supérieure et inférieure sont identiques).

Tableau 2D (2, N) : la première ligne correspond à l'erreur inférieure, la deuxième ligne à l'erreur supérieure.

Que faire si vous ne voulez pas de lignes entre les points de données ?

vafmtDéfinissez-le sur un format avec marqueurs uniquement, par exemple,'o'、's'、'^', en omettant la partie style de ligne.


Matplotlib 参考文档Documentation de référence de Matplotlib

Autres extensions