matplotlib.axes.Axes.boxplot

Achsen. boxplot ( x , notch = None , sym = None , vert = None , whis = None , positions = None , widths = None , patch_artist = None , bootstrap = None , usermedians = None , conf_intervals = None , meanline = None , showmeans =None , showcaps = None , showbox = None , showfliers = None , boxprops = None , labels = None , flyerprops = None , medianprops = None , meanprops = None , capprops = None , whiskerprops = None , manage_ticks = True , autorange = False ,zorder = None , capwidths = None , * , data = None )

Zeichnen Sie ein Box-and-Whisker-Diagramm.

Die Box erstreckt sich vom ersten Quartil (Q1) bis zum dritten Quartil (Q3) der Daten, mit einer Linie am Median. Die Schnurrhaare erstrecken sich von der Box um das 1,5-fache des Interquartilbereichs (IQR). Fliegerpunkte sind diejenigen hinter dem Ende der Schnurrhaare. Siehe https://en.wikipedia.org/wiki/Box_plot als Referenz.

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

Parameter :

x Array oder eine Folge von Vektoren.

Die Eingabedaten. Bei einem 2D-Array wird für jede Spalte in x ein Boxplot gezeichnet . Bei einer Folge von 1D-Arrays wird für jedes Array in x ein Boxplot gezeichnet .

Kerbe bool, Standard: False

Ob ein eingekerbter Boxplot ( True) oder ein rechteckiger Boxplot ( False) gezeichnet werden soll. Die Kerben stellen das Konfidenzintervall (CI) um den Median dar. Die Dokumentation für Bootstrap beschreibt, wie die Positionen der Kerben standardmäßig berechnet werden, aber ihre Positionen können auch durch Setzen des Parameters conf_intervals überschrieben werden.

Notiz

In Fällen, in denen die Werte des CI kleiner als das untere Quartil oder größer als das obere Quartil sind, erstrecken sich die Kerben über die Box hinaus und verleihen ihr ein charakteristisches „umgedrehtes“ Aussehen. Dies ist das erwartete Verhalten und konsistent mit anderen statistischen Visualisierungspaketen.

symstr , optional

Das Standardsymbol für Fliegerpunkte. Eine leere Zeichenfolge ('') blendet die Flyer aus. Wenn None, dann sind die Flyer standardmäßig 'b+'. Mehr Kontrolle bietet der Parameter flyerprops .

vert bool, Standard: True

Wenn True, zeichnet vertikale Kästchen. Wenn False, zeichnen Sie horizontale Kästchen.

whis float oder (float, float), Standard: 1.5

Die Position der Schnurrhaare.

Wenn es sich um einen Float handelt, befindet sich der untere Whisker am niedrigsten Datum über und der obere Whisker am höchsten Datum unter , wobei Q1 und Q3 das erste und dritte Quartil sind. Der Standardwert von entspricht Tukeys ursprünglicher Definition von Boxplots.Q1 - whis*(Q3-Q1)Q3 + whis*(Q3-Q1)whis = 1.5

Wenn es sich um ein Paar Schwimmer handelt, geben sie die Perzentile an, bei denen die Schnurrhaare gezeichnet werden sollen (z. B. (5, 95)). Insbesondere die Einstellung auf (0, 100) führt zu Whiskern, die den gesamten Bereich der Daten abdecken.

Im Grenzfall , in dem whis automatisch auf (0, 100) gesetzt wird (den gesamten Datenbereich abdeckt), wenn Autorange True ist.Q1 == Q3

Jenseits der Schnurrhaare werden Daten als Ausreißer betrachtet und als einzelne Punkte dargestellt.

Bootstrap int, optional

Gibt an, ob die Konfidenzintervalle für gekerbte Boxplots um den Median herum gebootet werden sollen. Wenn Bootstrap None ist, wird kein Bootstrapping durchgeführt und Kerben werden unter Verwendung einer Gaußschen asymptotischen Näherung berechnet (siehe McGill, R., Tukey, JW, und Larsen, WA, 1978, und Kendall und Stuart, 1967). Andernfalls gibt Bootstrap an, wie oft der Median gebootet wird, um seine 95 %-Konfidenzintervalle zu bestimmen. Empfohlen werden Werte zwischen 1000 und 10000.

usermedians 1D-Array-ähnlich, optional

Ein 1D-Array ähnlich der Länge len(x). Jeder Eintrag, der nicht ist, Noneerzwingt den Wert des Medians für den entsprechenden Datensatz. Für Einträge, die sind None, werden die Mediane wie gewohnt von Matplotlib berechnet.

conf_intervals Array-ähnlich, optional

Ein 2D-Array ähnlich der Form . Jeder Eintrag, der nicht None ist, erzwingt die Position der entsprechenden Kerbe (die nur gezeichnet wird, wenn Kerbe ist ). Für Einträge, die sind , werden die Kerben durch die Methode berechnet, die durch die anderen Parameter angegeben ist (z . B. bootstrap ).(len(x), 2)TrueNone

Positionen Array-artig, optional

Die Positionen der Boxen. Die Ticks und Limits werden automatisch passend zu den Positionen gesetzt. Standardmäßig wobei N die Anzahl der zu zeichnenden Kästchen ist.range(1, N+1)

Breiten Float oder Array-artig

Die Breite der Boxen. Der Standardwert ist 0,5 oder , wenn dieser kleiner ist.0.15*(distance between extreme positions)

patch_artist bool, Standard: False

FalseEs produziert Boxen mit dem Line2D-Künstler . Ansonsten werden Kästchen mit Patch-Künstlern gezeichnet.

Beschriftungssequenz , optional

Labels für jeden Datensatz (eine pro Datensatz).

manage_ticks bool, Standard: True

Wenn True, werden die Tick-Positionen und Beschriftungen angepasst, um mit den Boxplot-Positionen übereinzustimmen.

autorange bool, Standard: False

Wenn Truedie Daten so verteilt sind, dass das 25. und 75. Perzentil gleich sind, wird whis auf (0, 100) gesetzt, so dass die Whisker-Enden am Minimum und Maximum der Daten liegen.

Meanline bool, Standard: False

Wenn True(und showmeans ist True), wird versucht, den Mittelwert gemäß meanprops (siehe unten) als eine Linie darzustellen, die sich über die gesamte Breite der Box erstreckt. Nicht empfohlen, wenn shownotches auch True ist. Andernfalls werden Mittel als Punkte angezeigt.

zorder Float, Standard:Line2D.zorder = 2

Die Zorder des Boxplots.

Rückgaben :

Diktat

Ein Wörterbuch, das jede Komponente des Boxplots einer Liste der Line2Derstellten Instanzen zuordnet. Dieses Wörterbuch hat die folgenden Schlüssel (unter der Annahme vertikaler Boxplots):

• boxes: Der Hauptteil des Boxplots, der die Quartile und die Konfidenzintervalle des Medians anzeigt, falls aktiviert.

• medians: horizontale Linien am Median jedes Kästchens.

• whiskers: die vertikalen Linien, die sich zu den extremsten Datenpunkten ohne Ausreißer erstrecken.

• caps: die horizontalen Linien an den Enden der Schnurrhaare.

• fliers: Punkte, die Daten darstellen, die sich über die Schnurrhaare (Flieger) hinaus erstrecken.

• means: Punkte oder Linien, die die Mittel darstellen.

Andere Parameter :

showcaps bool, Standard: True

Zeigen Sie die Kappen an den Enden der Schnurrhaare.

showbox bool, Standard: True

Zeigen Sie das mittlere Kästchen.

showfliers bool, Standard: True

Zeigen Sie die Ausreißer jenseits der Kappen an.

showmeans bool, Standard: False

Zeige das arithmetische Mittel.

capprops dict, Standard: Keine

Der Stil der Kappen.

capwidths Float oder Array, Standard: Keine

Die Breiten der Kappen.

boxprops dict, Standard: Keine

Der Stil der Box.

whiskerprops dict, Standard: Keine

Der Stil der Schnurrhaare.

flyerprops dict, Standard: Keine

Der Stil der Flyer.

medianprops dict, Standard: Keine

Der Stil des Medians.

meanprops dict, Standard: Keine

Der Stil der Mitte.

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

Siehe auch

violinplot

Zeichnen Sie eine Schätzung der Wahrscheinlichkeitsdichtefunktion.

Beispiele mit matplotlib.axes.Axes.boxplot

Boxplots mit benutzerdefinierten Füllfarben

Boxplots mit benutzerdefinierten Füllfarben

Boxplots

Boxplots

Boxplot-Demo

Boxplot-Demo

Boxplot(X)

Boxplot(X)