matplotlib.pyplot.boxplot #

matplotlib.pyplot. boxplot ( x , notch = Nenhum , sym = Nenhum , vert = Nenhum , whis = Nenhum , posições = Nenhum , larguras = Nenhum , patch_artist = Nenhum , bootstrap = Nenhum , usermedians = Nenhum , conf_intervals = Nenhum , meanline = Nenhum , showmeans= Nenhum , showcaps = Nenhum , showbox = Nenhum , showfliers = Nenhum , boxprops = Nenhum , labels = Nenhum , flierprops = Nenhum , medianprops = Nenhum , meanprops = Nenhum , capprops = Nenhum , whiskerprops = Nenhum , manage_ticks = True , autorange = False, zorder = None , capwidths = None , * , data = None ) [source] #

Desenhe um gráfico de caixa e bigodes.

A caixa se estende do primeiro quartil (Q1) ao terceiro quartil (Q3) dos dados, com uma linha na mediana. Os bigodes se estendem da caixa em 1,5x a faixa interquartil (IQR). Pontos voadores são aqueles além do final dos bigodes. Consulte https://en.wikipedia.org/wiki/Box_plot para referência.

     Q1-1.5IQR   Q1   median  Q3   Q3+1.5IQR
                  |-----:-----|
  o      |--------|     :     |--------|    o  o
                  |-----:-----|
flier             <----------->            fliers
                       IQR

Parâmetros :

x Array ou uma sequência de vetores.

Os dados de entrada. Se for um array 2D, um boxplot é desenhado para cada coluna em x . Se for uma sequência de arrays 1D, um boxplot é desenhado para cada array em x .

notch bool, padrão: Falso

Se deseja desenhar um boxplot entalhado ( True) ou um boxplot retangular ( False). Os entalhes representam o intervalo de confiança (CI) em torno da mediana. A documentação para bootstrap descreve como as localizações dos entalhes são calculadas por padrão, mas suas localizações também podem ser substituídas definindo o parâmetro conf_intervals .

Observação

Nos casos em que os valores do IC são menores que o quartil inferior ou maiores que o quartil superior, os entalhes se estenderão além da caixa, dando a ela uma aparência "invertida" distinta. Esse é o comportamento esperado e consistente com outros pacotes de visualização estatística.

sim str, opcional

O símbolo padrão para pontos de flyer. Uma string vazia ('') esconde os panfletos. Se None, então os panfletos assumem como padrão 'b+'. Mais controle é fornecido pelo parâmetro flyerprops .

vert bool, padrão: True

Se True, desenha caixas verticais. Se False, desenhe caixas horizontais.

whis float ou (float, float), padrão: 1.5

A posição dos bigodes.

Se flutuar, o bigode inferior está no datum mais baixo acima de , e o bigode superior no datum mais alto abaixo de , onde Q1 e Q3 são o primeiro e o terceiro quartis. O valor padrão de corresponde à definição original de boxplots de Tukey.Q1 - whis*(Q3-Q1)Q3 + whis*(Q3-Q1)whis = 1.5

Se um par de flutua, eles indicam os percentis nos quais desenhar os bigodes (por exemplo, (5, 95)). Em particular, definir isso como (0, 100) resulta em bigodes cobrindo todo o intervalo de dados.

No caso extremo em que , é definido automaticamente como (0, 100) (cobre todo o intervalo dos dados) se o intervalo automático for True.Q1 == Q3

Além dos bigodes, os dados são considerados outliers e são plotados como pontos individuais.

bootstrap int, opcional

Especifica se deve inicializar os intervalos de confiança em torno da mediana para boxplots notched. Se bootstrap for Nenhum, nenhum bootstrap será executado e os entalhes serão calculados usando uma aproximação assintótica baseada em Gaussiana (consulte McGill, R., Tukey, JW e Larsen, WA, 1978 e Kendall e Stuart, 1967). Caso contrário, bootstrap especifica o número de vezes para inicializar a mediana para determinar seus intervalos de confiança de 95%. Valores entre 1000 e 10000 são recomendados.

usermedians 1D tipo array, opcional

Uma matriz 1D de comprimento len(x). Cada entrada que não for Noneforça o valor da mediana para o conjunto de dados correspondente. Para entradas que são None, as medianas são calculadas pelo Matplotlib normalmente.

conf_intervals tipo array, opcional

Uma forma semelhante a uma matriz 2D . Cada entrada que não seja None força a localização do entalhe correspondente (que só é desenhado se o entalhe for ). Para entradas que são , os entalhes são calculados pelo método especificado pelos outros parâmetros (por exemplo, bootstrap ).(len(x), 2)TrueNone

posições tipo array, opcional

As posições das caixas. Os ticks e limites são definidos automaticamente para corresponder às posições. O padrão é onde N é o número de caixas a serem desenhadas.range(1, N+1)

larguras float ou array-like

As larguras das caixas. O padrão é 0,5 ou , se for menor.0.15*(distance between extreme positions)

patch_artist bool, padrão: Falso

Se Falseproduz caixas com o artista Line2D. Caso contrário, as caixas são desenhadas com artistas Patch.

sequência de rótulos , opcional

Rótulos para cada conjunto de dados (um por conjunto de dados).

manage_ticks bool, padrão: True

Se for True, os locais e rótulos dos marcadores serão ajustados para corresponder às posições do boxplot.

autorange bool, padrão: Falso

Quando Truee os dados são distribuídos de forma que os percentis 25 e 75 sejam iguais, é definido como (0, 100) de forma que as extremidades dos bigodes estejam no mínimo e no máximo dos dados.

bool de linha média , padrão: False

If True(e showmeans é True), tentará renderizar a média como uma linha abrangendo toda a largura da caixa de acordo com meanprops (veja abaixo). Não recomendado se shownotches também for True. Caso contrário, as médias serão mostradas como pontos.

zorder flutuante, padrão:Line2D.zorder = 2

A zorder do boxplot.

Devoluções :

ditado

Um dicionário mapeando cada componente do boxplot para uma lista das Line2Dinstâncias criadas. Esse dicionário tem as seguintes chaves (assumindo boxplots verticais):

boxes: o corpo principal do boxplot mostrando os quartis e os intervalos de confiança da mediana, se habilitado.
medians: linhas horizontais na mediana de cada caixa.
whiskers: as linhas verticais que se estendem até os pontos de dados mais extremos e não discrepantes.
caps: as linhas horizontais nas pontas dos bigodes.
fliers: pontos que representam dados que se estendem além dos bigodes (fliers).
means: pontos ou linhas que representam as médias.

Outros Parâmetros :

showcaps bool, padrão: True: Mostre as tampas nas pontas dos bigodes.
showbox bool, padrão: True: Mostre a caixa central.
showfliers bool, padrão: True: Mostre os outliers além dos limites.
showmeans bool, padrão: False: Mostre as médias aritméticas.
capprops dict, padrão: Nenhum: O estilo dos bonés.
capwidths float ou array, padrão: Nenhum: As larguras das tampas.
boxprops dict, padrão: Nenhum: O estilo da caixa.
ditado de whiskerprops , padrão: nenhum: O estilo dos bigodes.
Flierprops dict, padrão: Nenhum: O estilo dos aviadores.
medianprops dict, padrão: Nenhum: O estilo do mediano.
ditado meanprops , padrão: nenhum: O estilo da média.
objeto indexável de dados , opcional: Se fornecido, todos os parâmetros também aceitam uma string s, que é interpretada como data[s](a menos que isso gere uma exceção).

Veja também

violinplot: Desenhe uma estimativa da função de densidade de probabilidade.