Fonction errorbar() de 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ètre | Type | Description |
|---|---|---|
| x, y | de type tableau | Coordonnées des points de données |
| yerr / xerr | float ou array-like | Erreur 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]. |
| fmt | str | Chaîne de format pour les points de données, par ex. 'o' (cercle), 's' (carré), 'o-' (cercle + ligne). |
| ecolor | color | Couleur des lignes des barres d'erreur. |
| elinewidth | float | Largeur des lignes des barres d'erreur. |
| capsize | float | Longueur des lignes d'embout des barres d'erreur (en points). |
| capthick | float | Épaisseur des lignes d'embout des barres d'erreur. |
| barsabove | bool | Si True, les barres d'erreur sont tracées au-dessus des points de données. |
| lolims / uplims | de type tableau de booléens | Indiquez la limite inférieure/supérieure dans la direction y (flèches unilatérales uniquement). |
| xlolims / xuplims | de type tableau de booléens | Indiquez la limite inférieure/supérieure dans la direction x. |
| errorevery | int | Tracez des barres d'erreur à intervalles de quelques points de données (réduit l'encombrement visuel lorsque les données sont denses). |
errorbar() renvoie un
ErrorbarContainerobjet, 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 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 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 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 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.
Autres extensions