matplotlib.pyplot.boxplot

matplotlib.pyplot.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 auf dem Median. Die Whisker erstrecken sich von der Box bis zum am weitesten entfernten Datenpunkt, der sich innerhalb des 1,5-fachen des Interquartilsabstands (IQR) von der Box befindet. Flier-Punkte sind die Punkte, die über das Ende der Whisker hinausgehen. 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 ein 2D-Array, wird für jede Spalte in x ein Boxplot gezeichnet. Wenn eine Sequenz von 1D-Arrays, wird für jedes Array in x ein Boxplot gezeichnet.

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

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

Hinweis

In Fällen, in denen die Werte des CI kleiner als das untere Quartil oder größer als das obere Quartil sind, ragen die Einkerbungen über die Box hinaus und verleihen ihr ein charakteristisches „umgekehrtes“ Erscheinungsbild. Dies ist das erwartete Verhalten und steht im Einklang mit anderen statistischen Visualisierungspaketen.

symstr, optional

Das Standardsymbol für Flier-Punkte. Eine leere Zeichenkette ('') verbirgt die Flier. 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 bootstrapped werden sollen. Wenn bootstrap None ist, wird kein Bootstrapping durchgeführt, und die Einkerbungen werden mit einer Gauß-basierten asymptotischen Annäherung berechnet (siehe McGill, R., Tukey, J.W., und Larsen, W.A., 1978 und Kendall und Stuart, 1967). Andernfalls gibt bootstrap die Anzahl der Bootstrap-Durchläufe des Medians an, um seine 95% Konfidenzintervalle zu ermitteln. Werte zwischen 1000 und 10000 werden empfohlen.

usermedians1D-Array-ähnlich, optional

Ein 1D-Array-ähnliches Objekt 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-ähnliches Objekt 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 mit den Positionen übereinstimmen. Standardmäßig 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 den extremen 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 str, optional

Die Tick-Beschriftungen jedes Boxplots. Die Ticks werden immer an den Positionen der Box platziert. Wenn tick_labels angegeben ist, 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 Whisker beim 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 über die gesamte Breite der Box gemäß meanprops (siehe unten) darzustellen. Nicht empfohlen, wenn shownotches ebenfalls True ist. Andernfalls werden Mittelwerte als Punkte angezeigt.

zorderfloat, Standard: Line2D.zorder = 2

Die zorder des Boxplots.

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 des Boxplots, 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ßenden Datenpunkten erstrecken.

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

• fliers: Punkte, die Daten darstellen, die über die Whisker hinausgehen (Fliers).

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

Andere Parameter:

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

Zeigt die Kappen an den Enden der Whisker 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 Whisker.

flierpropsdict, Standard: None

Der Stil der Flier.

medianpropsdict, Standard: None

Der Stil des Medians.

meanpropsdict, Standard: None

Der Stil des Mittels.

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 einen Boxplot aus vorab berechneten Statistiken.

violinplot

Zeichnet eine Schätzung der Wahrscheinlichkeitsdichtefunktion.

Anmerkungen

Hinweis

Dies ist der pyplot-Wrapper für axes.Axes.boxplot.

Beispiele zur Verwendung von matplotlib.pyplot.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