matplotlib.axes.Axes.bxp#

Axes.bxp(bxpstats, positions=None, *, widths=None, vert=None, orientation='vertical', patch_artist=False, shownotches=False, showmeans=False, showcaps=True, showbox=True, showfliers=True, boxprops=None, whiskerprops=None, flierprops=None, medianprops=None, capprops=None, meanprops=None, meanline=False, manage_ticks=True, zorder=None, capwidths=None, label=None)[Quelle]#

Zeichnet ein Box-Whisker-Plot aus vorberechneten Statistiken.

Die Box erstreckt sich vom ersten Quartil q1 bis zum dritten Quartil q3 der Daten, mit einer Linie für den Median (med). Die Whisker erstrecken sich von whislow bis whishi. Ausreißer sind Markierungen jenseits des Endes der Whisker. Siehe https://en.wikipedia.org/wiki/Box_plot als Referenz.

      whislow    q1    med    q3    whishi
                  |-----:-----|
  o      |--------|     :     |--------|    o  o
                  |-----:-----|
flier                                      fliers

Hinweis

Dies ist eine Low-Level-Zeichenfunktion für Fälle, in denen Sie bereits die statistischen Parameter haben. Wenn Sie einen Boxplot basierend auf einem Datensatz wünschen, verwenden Sie stattdessen boxplot.

Parameter:
bxpstatsListe von Dictionaries

Eine Liste von Dictionaries, die Statistiken für jeden Boxplot enthalten. Erforderliche Schlüssel sind

  • med: Median (float).

  • q1, q3: Erstes und drittes Quartil (float).

  • whislo, whishi: Untere und obere Whisker-Positionen (float).

Optionale Schlüssel sind

  • mean: Mittelwert (float). Benötigt, wenn showmeans=True.

  • fliers: Datenpunkte jenseits der Whisker (array-ähnlich). Benötigt, wenn showfliers=True.

  • cilo, cihi: Untere und obere Konfidenzintervalle um den Median. Benötigt, wenn shownotches=True.

  • label: Name des Datensatzes (str). Falls vorhanden, wird dieser als Tick-Label für den Boxplot verwendet.

positionsarray-like, Standard: [1, 2, ..., n]

Die Positionen der Boxen. Die Ticks und Grenzen werden automatisch so eingestellt, dass sie den Positionen entsprechen.

widthsfloat oder array-ähnlich, Standard: None

Die Breiten der Boxen. Der Standardwert ist clip(0.15*(Abstand zwischen extremen Positionen), 0.15, 0.5).

capwidthsfloat oder array-ähnlich, Standard: None

Entweder ein Skalar oder ein Vektor, der die Breite jeder Kappe festlegt. Der Standardwert ist 0.5*(Breite der Box), siehe widths.

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.

patch_artistbool, Standard: False

Wenn False, werden Boxen mit dem Line2D-Künstler erstellt. Wenn True, werden Boxen mit dem Patch-Künstler erstellt.

shownotches, showmeans, showcaps, showbox, showfliersbool

Ob die CI-Notches, der Mittelwert (beide standardmäßig False), die Kappen, die Box und die Ausreißer (alle drei standardmäßig True) gezeichnet werden sollen.

boxprops, whiskerprops, capprops, flierprops, medianprops, meanpropsdict, optional

Künstler-Eigenschaften für die Boxen, Whisker, Kappen, Ausreißer, Mediane und Mittelwerte.

meanlinebool, Standard: False

Wenn True (und showmeans ist True), wird versucht, den Mittelwert als Linie darzustellen, die die gesamte Breite der Box abdeckt, gemäß meanprops. Nicht empfohlen, wenn shownotches ebenfalls True ist. Andernfalls werden Mittelwerte als Punkte angezeigt.

manage_ticksbool, Standard: True

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

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.

zorderfloat, Standard: Line2D.zorder = 2

Die Z-Reihenfolge des resultierenden 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: Hauptteile des Boxplots, die die Quartile und die Konfidenzintervalle des Medians anzeigen, falls aktiviert.

  • medians: horizontale Linien am Median jeder Box.

  • whiskers: vertikale Linien bis zu den letzten Nicht-Ausreißer-Daten.

  • caps: horizontale Linien an den Enden der Whisker.

  • fliers: Punkte, die Datenpunkte jenseits der Whisker darstellen (Ausreißer).

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

Siehe auch

boxplot

Zeichnet einen Boxplot aus Daten anstelle von vorberechneten Statistiken.

Beispiele für die Verwendung von matplotlib.axes.Axes.bxp#

Getrennte Berechnung und Darstellung von Boxplots

Getrennte Berechnung und Darstellung von Boxplots
Auf dieser Seite