matplotlib.axes.Axes.errorbar #
- Haches. errorbar ( x , y , yerr = Aucun , xerr = Aucun , fmt = '' , ecolor = Aucun , elinewidth = Aucun , capsize = Aucun , barsabove = Faux , lolims = Faux , uplims = Faux , xlolims = Faux , xuplims = Faux , erreur chaque= 1 , capthick = None , * , data = None , ** kwargs ) [source] #
Tracez y par rapport à x sous forme de lignes et/ou de marqueurs avec des barres d'erreur attachées.
x , y définissent les emplacements des données, xerr , yerr définissent les tailles de la barre d'erreur. Par défaut, cela dessine les marqueurs/lignes de données ainsi que les barres d'erreur. Utilisez fmt='none' pour dessiner des barres d'erreur sans aucun marqueur de données.
- Paramètres :
- x, y flottant ou semblable à un tableau
Les positions des données.
- xerr, yerr float ou type tableau, shape(N,) ou shape(2, N), facultatif
La taille de la barre d'erreur :
scalaire : valeurs +/- symétriques pour tous les points de données.
shape(N,) : valeurs +/- symétriques pour chaque point de données.
shape(2, N) : valeurs - et + distinctes pour chaque barre. La première ligne contient les erreurs inférieures, la deuxième ligne contient les erreurs supérieures.
Aucun : Pas de barre d'erreur.
Toutes les valeurs doivent être >= 0.
Voir Différentes façons de spécifier des barres d'erreur pour un exemple sur l'utilisation de
xerr
etyerr
.- chaîne fmt , par défaut : ''
Le format des points de données / lignes de données. Voir
plot
pour plus de détails.Utilisez 'aucun' (insensible à la casse) pour tracer les barres d'erreur sans aucun marqueur de données.
- couleur ecolor , par défaut : Aucun
La couleur des lignes de la barre d'erreur. Si aucun, utilisez la couleur de la ligne reliant les marqueurs.
- elinewidth flottant, par défaut : aucun
La largeur de ligne des lignes de la barre d'erreur. Si aucun, la largeur de ligne du style actuel est utilisée.
- chavirer le flotteur, par défaut :
rcParams["errorbar.capsize"]
(par défaut :0.0
) La longueur des plafonds de la barre d'erreur en points.
- capthick flottant, par défaut : aucun
Un alias pour l'argument de mot-clé markeredgewidth (alias mew ). Ce paramètre est un nom plus sensé pour la propriété qui contrôle l'épaisseur du plafond de la barre d'erreur en points. Pour une compatibilité descendante, si mew ou markeredgewidth sont donnés, ils remplaceront capthick . Cela peut changer dans les prochaines versions.
- barsabove bool, par défaut : False
Si True, tracera les barres d'erreur au-dessus des symboles de tracé. La valeur par défaut est ci-dessous.
- lolims, uplims, xlolims, xuplims booléen , par défaut : False
Ces arguments peuvent être utilisés pour indiquer qu'une valeur ne donne que des limites supérieures/inférieures. Dans ce cas, un signe insertion est utilisé pour l'indiquer. lims -arguments peut être des scalaires ou des types de tableau de la même longueur que xerr et yerr . Pour utiliser des limites avec des axes inversés,
set_xlim
ouset_ylim
doit être appelé avanterrorbar()
. Notez les noms de paramètres délicats : définir par exemple lolims sur True signifie que la valeur y est une limite inférieure de la valeur True, donc seule une flèche pointant vers le haut sera dessinée !- errorevery int ou (int, int), par défaut : 1
dessine des barres d'erreur sur un sous-ensemble de données. errorevery =N dessine des barres d'erreur sur les points (x[::N], y[::N]). errorevery =(start, N) dessine des barres d'erreur sur les points (x[start::N], y[start::N]). par exemple errorevery=(6, 3) ajoute des barres d'erreur aux données à (x[6], x[9], x[12], x[15], ...). Utilisé pour éviter le chevauchement des barres d'erreur lorsque deux séries partagent des valeurs d'axe x.
- Retours :
ErrorbarContainer
Le conteneur contient :
plotline :
Line2D
instance de x, y plot markers et/ou line.caplines : un tuple d'
Line2D
instances des plafonds de la barre d'erreur.barlinecols : un tuple de
LineCollection
avec les plages d'erreur horizontales et verticales.
- Autres paramètres :
- objet de données indexable, facultatif
S'ils sont fournis, les paramètres suivants acceptent également une chaîne
s
, qui est interprétée commedata[s]
(sauf si cela déclenche une exception) :x , y , xerr , yerr
- **kwargs
Tous les autres arguments de mots clés sont transmis à l'
plot
appel dessinant les marqueurs. Par exemple, ce code fait de grands carrés rouges avec des bords verts épais :x, y, yerr = rand(3, 10) errorbar(x, y, yerr, marker='s', mfc='red', mec='green', ms=20, mew=4)
où mfc , mec , ms et mew sont des alias pour les noms de propriété plus longs, markerfacecolor , markeredgecolor , markersize et markeredgewidth .
Les kwargs valides pour les propriétés du marqueur sont :
tirets
dash_capstyle
dash_joinstyle
style de dessin
style de remplissage
style de ligne
marqueur
couleur du bord du marqueur
largeur du bord du marqueur
marqueurfacecouleur
marqueurfacecoloralt
taille du marqueur
marque chaque
solid_capstyle
solid_joinstyle
Reportez-vous à la
Line2D
propriété correspondante pour plus de détails :Propriété
La description
une fonction de filtre, qui prend un tableau flottant (m, n, 3) et une valeur dpi, et renvoie un tableau (m, n, 3) et deux décalages à partir du coin inférieur gauche de l'image
scalaire ou Aucun
bourdonner
antialiased
ou aabourdonner
bourdonner
Patch ou (chemin, transformation) ou aucun
color
ou cCouleur
CapStyle
ou {'bout', 'en saillie', 'rond'}JoinStyle
ou {'onglet', 'rond', 'biseau'}séquence de flottants (on/off encre en points) ou (Aucun, Aucun)
(2, N) tableau ou deux tableaux 1D
drawstyle
ou dès{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, par défaut : 'default'
{'plein', 'gauche', 'droite', 'bas', 'haut', 'aucun'}
couleur ou Aucun
chaîne
bourdonner
objet
linestyle
ou ls{'-', '--', '-.', ':', '', (décalage, on-off-seq), ...}
linewidth
ou lwflotteur
chaîne de style marqueur,
Path
ouMarkerStyle
markeredgecolor
ou mecCouleur
markeredgewidth
ou miaulerflotteur
markerfacecolor
ou mfcCouleur
markerfacecoloralt
ou mfcaltCouleur
markersize
ou msflotteur
None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
bourdonner
float ou callable[[Artist, Event], tuple[bool, dict]]
inconnue
bourdonner
(échelle : flottant, longueur : flottant, caractère aléatoire : flottant)
booléen ou Aucun
CapStyle
ou {'bout', 'en saillie', 'rond'}JoinStyle
ou {'onglet', 'rond', 'biseau'}inconnue
chaîne
bourdonner
Tableau 1D
Tableau 1D
flotteur
Exemples utilisant matplotlib.axes.Axes.errorbar
#
Sous-échantillonnage de la barre d'erreur
Différentes façons de spécifier les barres d'erreur
Y compris les limites supérieure et inférieure dans les barres d'erreur
Création de boîtes à partir de barres d'erreur à l'aide de PatchCollection
barre d'erreur (x, y, yerr, xerr)