matplotlib.pyplot.errorbar

matplotlib.pyplot. errorbar ( x , y , yerr = Nenhum , xerr = Nenhum , fmt = '' , ecolor = Nenhum , elinewidth = Nenhum , capsize = Nenhum , barsabove = False , lolims = False , uplims = False , xlolims = False , xuplims = False ,errorevery = 1 , capthick = None , * , data = None , ** kwargs )

Plote y versus x como linhas e/ou marcadores com barras de erro anexadas.

x , y definem os locais dos dados, xerr , yerr definem os tamanhos da barra de erro. Por padrão, isso desenha os marcadores/linhas de dados, bem como as barras de erro. Use fmt='none' para desenhar barras de erro sem nenhum marcador de dados.

Parâmetros :

x, y float ou array-like

As posições de dados.

xerr, yerr float ou array-like, shape(N,) ou shape(2, N), opcional

Os tamanhos da barra de erro:

• escalar: Valores +/- simétricos para todos os pontos de dados.

• shape(N,): Valores +/- simétricos para cada ponto de dados.

• shape(2, N): Separe os valores - e + para cada barra. A primeira linha contém os erros inferiores, a segunda linha contém os erros superiores.

• Nenhum : Nenhuma barra de erro.

Todos os valores devem ser >= 0.

Consulte Diferentes maneiras de especificar barras de erro para obter um exemplo de uso de xerre yerr.

fmt str, padrão: ''

O formato para os pontos de dados/linhas de dados. Consulte plotpara obter detalhes.

Use 'none' (sem distinção entre maiúsculas e minúsculas) para plotar barras de erro sem nenhum marcador de dados.

cor ecolor , padrão: nenhum

A cor das linhas da barra de erro. Se Nenhum, use a cor da linha que conecta os marcadores.

elinewidth flutuante, padrão: nenhum

A largura de linha das linhas da barra de erro. Se Nenhum, a largura de linha do estilo atual é usada.

capsize float, padrão: rcParams["errorbar.capsize"](padrão: 0.0)

O comprimento da barra de erro é limitado em pontos.

capthick float, padrão: nenhum

Um alias para o argumento de palavra-chave markeredgewidth (também conhecido como mew ). Essa configuração é um nome mais sensato para a propriedade que controla a espessura da tampa da barra de erro em pontos. Para compatibilidade com versões anteriores, se mew ou markeredgewidth forem fornecidos, eles substituirão capthick . Isso pode mudar em versões futuras.

barsabove bool, padrão: False

Se for True, irá plotar as barras de erro acima dos símbolos de plotagem. O padrão está abaixo.

lolims, uplims, xlolims, xuplims bool, padrão: Falso

Esses argumentos podem ser usados ​​para indicar que um valor fornece apenas limites superiores/inferiores. Nesse caso, um símbolo de circunflexo é usado para indicar isso. lims -argumentos podem ser escalares ou semelhantes a matrizes do mesmo comprimento que xerr e yerr . Para usar limites com eixos invertidos, set_xlimou set_ylimdeve ser chamado antes errorbar(). Observe os nomes de parâmetros complicados: definir, por exemplo, lolims como True significa que o valor y é um limite inferior do valor True, portanto, apenas uma seta apontando para cima será desenhada!

errorevery int ou (int, int), padrão: 1

desenha barras de erro em um subconjunto dos dados. errorevery =N desenha barras de erro nos pontos (x[::N], y[::N]). errorevery =(início, N) desenha barras de erro nos pontos (x[início::N], y[início::N]). por exemplo, errorevery=(6, 3) adiciona barras de erro aos dados em (x[6], x[9], x[12], x[15], ...). Usado para evitar a sobreposição de barras de erro quando duas séries compartilham valores do eixo x.

Devoluções :

ErrorbarContainer

O recipiente contém:

• plotline: Line2Dinstância de marcadores de plotagem x, y e/ou linha.

• caplines: Uma tupla de Line2Dinstâncias dos caps da barra de erro.

• barlinecols: Uma tupla de LineCollectioncom os intervalos de erro horizontal e vertical.

Outros Parâmetros :

objeto indexável de dados , opcional

Se fornecidos, os seguintes parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção):

x , y , xerr , yerr

** kwargs

Todos os outros argumentos de palavra-chave são passados ​​para a plotchamada que desenha os marcadores. Por exemplo, este código cria grandes quadrados vermelhos com bordas verdes grossas:

x, y, yerr = rand(3, 10)
errorbar(x, y, yerr, marker='s', mfc='red',
         mec='green', ms=20, mew=4)

onde mfc , mec , ms e mew são aliases para os nomes de propriedade mais longos, markerfacecolor , markeredgecolor , markersize e markeredgewidth .

Os kwargs válidos para as propriedades do marcador são:

• traços

• traço_capstyle

• dash_joinstyle

• estilo de desenho

• estilo de preenchimento

• estilo de linha

• marcador

• cor da borda do marcador

• largura da borda do marcador

• cor da face do marcador

• marcadorfacecoloralt

• tamanho do marcador

• markevery

• solid_capstyle

• solid_joinstyle

Consulte a Line2Dpropriedade correspondente para mais detalhes:

Propriedade	Descrição
agg_filter	uma função de filtro, que usa uma matriz flutuante (m, n, 3) e um valor de dpi e retorna uma matriz (m, n, 3) e dois deslocamentos do canto inferior esquerdo da imagem
alpha	escalar ou nenhum
animated	bool
antialiasedou aa	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch ou (Caminho, Transformação) ou Nenhum
colorou c	cor
dash_capstyle	CapStyleou {'bunda', 'projetando', 'redondo'}
dash_joinstyle	JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
dashes	sequência de flutuações (on/off ink em pontos) ou (None, None)
data	(2, N) array ou dois arrays 1D
drawstyleou ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
figure	Figure
fillstyle	{'completo', 'esquerda', 'direita', 'inferior', 'superior', 'nenhum'}
gapcolor	cor ou nenhum
gid	str
in_layout	bool
label	objeto
linestyleou ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidthou lw	flutuador
marker	string de estilo de marcador, PathouMarkerStyle
markeredgecolorou mec	cor
markeredgewidthou miar	flutuador
markerfacecolorou mfc	cor
markerfacecoloraltou mfcalt	cor
markersizeou senhora	flutuador
markevery	None ou int ou (int, int) ou slice ou list[int] ou float ou (float, float) ou list[bool]
mouseover	bool
path_effects	AbstractPathEffect
picker	float ou callable[[Artist, Event], tuple[bool, dict]]
pickradius	desconhecido
rasterized	bool
sketch_params	(escala: flutuante, comprimento: flutuante, aleatoriedade: flutuante)
snap	bool ou nenhum
solid_capstyle	CapStyleou {'bunda', 'projetando', 'redondo'}
solid_joinstyle	JoinStyleou {'esquadria', 'redondo', 'chanfrado'}
transform	desconhecido
url	str
visible	bool
xdata	matriz 1D
ydata	matriz 1D
zorder	flutuador

Exemplos usando matplotlib.pyplot.errorbar

Seleção do limite da barra de erros

Seleção do limite da barra de erros