matplotlib.axes.Axes.barra de errores #
- hachas barra de error ( x , y , yerr = Ninguno , xerr = Ninguno , fmt = '' , ecolor = Ninguno , elinewidth = Ninguno , capsize = Ninguno , barsabove = Falso , lolims = Falso , uplims = Falso , xlolims = Falso , xuplims = Falso , cada error= 1 , capthick = Ninguno , * , datos = Ninguno , ** kwargs ) [fuente] #
Trace y contra x como líneas y/o marcadores con barras de error adjuntas.
x , y definen las ubicaciones de los datos, xerr , yerr definen los tamaños de la barra de error. Por defecto, esto dibuja los marcadores/líneas de datos así como las barras de error. Use fmt='none' para dibujar barras de error sin ningún marcador de datos.
- Parámetros :
- x, y flotante o tipo matriz
Las posiciones de los datos.
- xerr, yerr flotante o tipo matriz, forma (N,) o forma (2, N), opcional
Los tamaños de la barra de error:
escalar: valores simétricos +/- para todos los puntos de datos.
forma (N,): valores simétricos +/- para cada punto de datos.
forma (2, N): valores separados - y + para cada barra. La primera fila contiene los errores inferiores, la segunda fila contiene los errores superiores.
Ninguno : Sin barra de error.
Todos los valores deben ser >= 0.
Consulte Diferentes formas de especificar barras de error para ver un ejemplo del uso de
xerr
yyerr
.- cadena fmt , por defecto: ''
El formato de los puntos de datos/líneas de datos. Ver
plot
para más detalles.Use 'ninguno' (sin distinción entre mayúsculas y minúsculas) para trazar barras de error sin ningún marcador de datos.
- color ecolor , por defecto: Ninguno
El color de las líneas de la barra de error. Si no hay, use el color de la línea que conecta los marcadores.
- elinewidth float, por defecto: Ninguno
El ancho de línea de las líneas de la barra de error. Si es Ninguno, se usa el ancho de línea del estilo actual.
- capsize float, predeterminado:
rcParams["errorbar.capsize"]
(predeterminado:0.0
) La longitud de los límites de la barra de error en puntos.
- capthick float, predeterminado: Ninguno
Un alias para el argumento de la palabra clave markeredgewidth (también conocido como mew ). Esta configuración es un nombre más sensato para la propiedad que controla el grosor de la tapa de la barra de error en puntos. Para compatibilidad con versiones anteriores, si se proporciona mew o markeredgewidth , estos anularán capthick . Esto puede cambiar en versiones futuras.
- barsabove bool, predeterminado: Falso
Si es Verdadero, trazará las barras de error sobre los símbolos de trazado. El valor predeterminado está debajo.
- lolims, uplims, xlolims, xuplims bool, predeterminado: Falso
Estos argumentos se pueden usar para indicar que un valor proporciona solo límites superior/inferior. En ese caso, se utiliza un símbolo de intercalación para indicarlo. lims -arguments pueden ser escalares, o similares a arreglos de la misma longitud que xerr y yerr . Para usar límites con ejes invertidos,
set_xlim
oset_ylim
debe llamarse antes deerrorbar()
. Tenga en cuenta los nombres de parámetros complicados: establecer, por ejemplo, lolims en True significa que el valor y es un límite inferior del valor True, por lo que solo se dibujará una flecha que apunta hacia arriba .- errorevery int o (int, int), por defecto: 1
dibuja barras de error en un subconjunto de los datos. errorevery =N dibuja barras de error en los puntos (x[::N], y[::N]). errorevery =(start, N) dibuja barras de error en los puntos (x[start::N], y[start::N]). por ejemplo, errorevery=(6, 3) agrega barras de error a los datos en (x[6], x[9], x[12], x[15], ...). Se utiliza para evitar la superposición de barras de error cuando dos series comparten valores en el eje x.
- Devoluciones :
ErrorbarContainer
El contenedor contiene:
línea de trama:
Line2D
instancia de x, y marcadores de trama y/o línea.caplines: Una tupla de
Line2D
instancias de las mayúsculas de la barra de error.barlinecols: Una tupla de
LineCollection
con los rangos de error horizontal y vertical.
- Otros parámetros :
- objeto indexable de datos , opcional
Si se proporcionan, los siguientes parámetros también aceptan una cadena
s
, que se interpreta comodata[s]
(a menos que esto genere una excepción):x , y , xerr , yerr
- **kwargs
Todos los demás argumentos de palabras clave se pasan a la
plot
llamada que dibuja los marcadores. Por ejemplo, este código crea cuadrados rojos grandes con bordes verdes gruesos:x, y, yerr = rand(3, 10) errorbar(x, y, yerr, marker='s', mfc='red', mec='green', ms=20, mew=4)
donde mfc , mec , ms y mew son alias para los nombres de propiedad más largos, markerfacecolor , markeredgecolor , markersize y markeredgewidth .
Los kwargs válidos para las propiedades del marcador son:
guiones
dash_capstyle
dash_joinstyle
estilo de dibujo
estilo de relleno
estilo de línea
marcador
marcadorbordecolor
ancho del borde del marcador
rotuladorcaracolor
rotuladorcaracoloralt
tamaño del marcador
marcar cada
solid_capstyle
solid_joinstyle
Consulte la
Line2D
propiedad correspondiente para obtener más detalles:Propiedad
Descripción
una función de filtro, que toma una matriz flotante (m, n, 3) y un valor de ppp, y devuelve una matriz (m, n, 3) y dos compensaciones desde la esquina inferior izquierda de la imagen
escalar o ninguno
bool
antialiased
o unobool
bool
Parchear o (Ruta, Transformar) o Ninguno
color
o ccolor
CapStyle
o {'trasero', 'proyectando', 'redondo'}JoinStyle
o {'inglete', 'redondo', 'bisel'}secuencia de flotadores (tinta de encendido/apagado en puntos) o (Ninguno, Ninguno)
(2, N) matriz o dos matrices 1D
drawstyle
o ds{'predeterminado', 'pasos', 'pasos-pre', 'pasos-medio', 'pasos-post'}, predeterminado: 'predeterminado'
{'completo', 'izquierda', 'derecha', 'abajo', 'arriba', 'ninguno'}
color o ninguno
calle
bool
objeto
linestyle
o ls{'-', '--', '-.', ':', '', (desplazamiento, on-off-seq), ...}
linewidth
o bajoflotar
cadena de estilo de marcador,
Path
oMarkerStyle
markeredgecolor
o meccolor
markeredgewidth
o maullarflotar
markerfacecolor
o mfccolor
markerfacecoloralt
o mfcaltcolor
markersize
o másflotar
Ninguno o int o (int, int) o rebanada o list[int] o float o (float, float) o list[bool]
bool
float o invocable[[Artista, Evento], tupla[bool, dict]]
desconocido
bool
(escala: flotante, longitud: flotante, aleatoriedad: flotante)
booleano o ninguno
CapStyle
o {'trasero', 'proyectando', 'redondo'}JoinStyle
o {'inglete', 'redondo', 'bisel'}desconocido
calle
bool
matriz 1D
matriz 1D
flotar
Ejemplos usando matplotlib.axes.Axes.errorbar
#
![Incluyendo límites superior e inferior en barras de error](/stable/_images/sphx_glr_errorbar_limits_thumb.png)
Incluyendo límites superior e inferior en barras de error
![Creando cuadros a partir de barras de error usando PatchCollection](/stable/_images/sphx_glr_errorbars_and_boxes_thumb.png)
Creando cuadros a partir de barras de error usando PatchCollection