matplotlib.axes.Axes.boxplot

Axes.boxplot(x, *, notch=None, sym=None, vert=None, orientation='vertical', 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, tick_labels=None, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_ticks=True, autorange=False, zorder=None, capwidths=None, label=None, data=None)

Zeichnet ein Box-Whisker-Diagramm.

Die Box erstreckt sich vom ersten Quartil (Q1) bis zum dritten Quartil (Q3) der Daten, mit einer Linie bei der Median. Die Whiskers erstrecken sich von der Box bis zum äußersten Datenpunkt, der sich innerhalb des 1,5-fachen des Interquartilsabstands (IQR) von der Box befindet. Flier-Punkte sind die Punkte außerhalb der Whiskers. 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:

xArray oder eine Sequenz von Vektoren.

Die Eingabedaten. Wenn es sich um ein 2D-Array handelt, wird für jede Spalte in x eine Boxplot gezeichnet. Wenn es sich um eine Sequenz von 1D-Arrays handelt, wird für jedes Array in x eine Boxplot gezeichnet.

notchbool, Standard: rcParams["boxplot.notch"] (Standard: False)

Ob eine eingekerbte Boxplot (True) oder eine rechteckige Boxplot (False) gezeichnet werden soll. Die Einkerbungen stellen das Konfidenzintervall (CI) um den Median dar. Die Dokumentation zu bootstrap beschreibt, wie die Positionen der Einkerbungen standardmäßig berechnet werden, aber ihre Positionen können auch überschrieben werden, indem der Parameter conf_intervals gesetzt wird.

Hinweis

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

symstr, optional

Das Standardsymbol für Flier-Punkte. Eine leere Zeichenkette ('') blendet die Flier aus. Wenn None, dann sind die Flier standardmäßig 'b+'. Mehr Kontrolle wird durch den Parameter flierprops geboten.

vertbool, optional

Deprecated since version 3.11: Verwenden Sie stattdessen orientation.

Dies ist eine anstehende Deprekation für 3.10, mit vollständiger Deprekation in 3.11 und Entfernung in 3.13. Wenn dies während der Deprekationsperiode angegeben wird, überschreibt es den Parameter orientation.

Wenn True, werden die Boxen vertikal gezeichnet. Wenn False, werden die Boxen horizontal gezeichnet.

orientation{'vertical', 'horizontal'}, Standard: 'vertical'

Wenn 'horizontal', werden die Boxen horizontal gezeichnet. Andernfalls werden die Boxen vertikal gezeichnet.

Hinzugefügt in Version 3.10.

whisfloat oder (float, float), Standard: 1.5

Die Position der Whiskers.

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

Wenn ein Paar von Floats, geben sie die Perzentile an, bei denen die Whiskers gezeichnet werden sollen (z.B. (5, 95)). Insbesondere führt die Einstellung auf (0, 100) dazu, dass die Whiskers den gesamten Datenbereich abdecken.

Im Sonderfall, dass Q1 == Q3, wird whis automatisch auf (0, 100) gesetzt (gesamter Datenbereich abdecken), wenn autorange True ist.

Über die Whiskers hinaus werden Daten als Ausreißer betrachtet und als einzelne Punkte dargestellt.

bootstrapint, optional

Gibt an, ob die Konfidenzintervalle um den Median für eingekerbte Boxplots gebootstrappt werden sollen. Wenn bootstrap None ist, wird kein Bootstrapping durchgeführt und die Einkerbungen werden mit einer Gauß-basierten asymptotischen Approximation berechnet (siehe McGill, R., Tukey, J.W., und Larsen, W.A., 1978, und Kendall und Stuart, 1967). Andernfalls gibt bootstrap die Anzahl der Bootstraps des Medians an, um dessen 95% Konfidenzintervalle zu bestimmen. Werte zwischen 1000 und 10000 werden empfohlen.

usermedians1D array-ähnlich, optional

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

conf_intervalsarray-ähnlich, optional

Ein 2D-Array, das einem Array ähnelt, mit der Form (len(x), 2). Jeder Eintrag, der nicht None ist, erzwingt die Position der entsprechenden Einkerbung (die nur gezeichnet wird, wenn notch True ist). Für Einträge, die None sind, werden die Einkerbungen nach der Methode berechnet, die durch die anderen Parameter angegeben wird (z.B. bootstrap).

positionsarray-ähnlich, optional

Die Positionen der Boxen. Die Ticks und Grenzen werden automatisch so eingestellt, dass sie den Positionen entsprechen. Standardmäßig ist dies range(1, N+1), wobei N die Anzahl der zu zeichnenden Boxen ist.

widthsfloat oder array-ähnlich

Die Breiten der Boxen. Der Standardwert ist 0.5, oder 0.15*(Abstand zwischen äußersten Positionen), wenn dieser kleiner ist.

patch_artistbool, Standard: rcParams["boxplot.patchartist"] (Standard: False)

Wenn False, werden Boxen mit dem Line2D-Künstler gezeichnet. Andernfalls werden Boxen mit Patch-Künstlern gezeichnet.

tick_labelsListe von Zeichenketten, optional

Die Beschriftungen der Ticks jeder Boxplot. Ticks werden immer an den Box-Positionen platziert. Wenn tick_labels angegeben wird, werden die Ticks entsprechend beschriftet. Andernfalls behalten sie ihre numerischen Werte.

Geändert in version 3.9: Umbenannt von labels, was seit 3.9 als veraltet gilt und in 3.11 entfernt wird.

manage_ticksbool, Standard: True

Wenn True, werden die Positionen und Beschriftungen der Ticks an die Boxplot-Positionen angepasst.

autorangebool, Standard: False

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

meanlinebool, Standard: rcParams["boxplot.meanline"] (Standard: False)

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

zorderfloat, Standard: Line2D.zorder = 2

Die zorder der Boxplot.

Gibt zurück:

dict

Ein Wörterbuch, das jede Komponente der Boxplot auf eine Liste der erstellten Line2D-Instanzen abbildet. Dieses Wörterbuch hat die folgenden Schlüssel (angenommen vertikale Boxplots)

• boxes: der Hauptteil der Boxplot, der die Quartile und das Konfidenzintervall des Medians anzeigt, falls aktiviert.

• medians: horizontale Linien am Median jeder Box.

• whiskers: die vertikalen Linien, die sich zu den extremsten, nicht-ausreißerhaften Datenpunkten erstrecken.

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

• fliers: Punkte, die Daten darstellen, die über die Whiskers hinausgehen (Flier).

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

Andere Parameter:

showcapsbool, Standard: rcParams["boxplot.showcaps"] (Standard: True)

Zeigt die Kappen an den Enden der Whiskers an.

showboxbool, Standard: rcParams["boxplot.showbox"] (Standard: True)

Zeigt die zentrale Box an.

showfliersbool, Standard: rcParams["boxplot.showfliers"] (Standard: True)

Zeigt die Ausreißer jenseits der Kappen an.

showmeansbool, Standard: rcParams["boxplot.showmeans"] (Standard: False)

Zeigt die arithmetischen Mittelwerte an.

cappropsdict, Standard: None

Der Stil der Kappen.

capwidthsfloat oder array, Standard: None

Die Breiten der Kappen.

boxpropsdict, Standard: None

Der Stil der Box.

whiskerpropsdict, Standard: None

Der Stil der Whiskers.

flierpropsdict, Standard: None

Der Stil der Flier.

medianpropsdict, Standard: None

Der Stil des Medians.

meanpropsdict, Standard: None

Der Stil des Mittelwerts.

labelstr oder Liste von str, optional

Legendenbeschriftungen. Verwenden Sie eine einzelne Zeichenkette, wenn alle Boxen denselben Stil haben und Sie nur einen einzigen Legenden-Eintrag dafür wünschen. Verwenden Sie eine Liste von Zeichenketten, um alle Boxen einzeln zu beschriften. Um unterscheidbar zu sein, sollten die Boxen individuell gestylt werden, was derzeit nur durch Modifikation der zurückgegebenen Künstler möglich ist, siehe z.B. Boxplots.

Bei einer einzelnen Zeichenkette wird der Legenden-Eintrag technisch nur mit der ersten Box verknüpft. Standardmäßig zeigt die Legende die Medianlinie (result["medians"]) an; wenn patch_artist True ist, zeigt die Legende stattdessen die Patch-Künstler der Box (result["boxes"]) an.

Hinzugefügt in Version 3.9.

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch eine Zeichenkette s, die als data[s] interpretiert wird, wenn s ein Schlüssel in data ist.

Siehe auch

Axes.bxp

Zeichnet eine Boxplot aus vorab berechneten Statistiken.

violinplot

Zeichnet eine Schätzung der Wahrscheinlichkeitsdichtefunktion.

Beispiele für die Verwendung von matplotlib.axes.Axes.boxplot

Künstler-Anpassung in Boxplots

Künstler-Anpassung in Boxplots

Boxplots mit benutzerdefinierten Füllfarben

Boxplots mit benutzerdefinierten Füllfarben

Boxplots

Boxplots

Vergleich von Boxplot und Violinplot

Vergleich von Boxplot und Violinplot

Getrennte Berechnung und Darstellung von Boxplots

Getrennte Berechnung und Darstellung von Boxplots

boxplot(X)

boxplot(X)