Python matplotlib Axes.boxplot用法及代碼示例

本文簡要介紹 python 語言中 matplotlib.axes.Axes.boxplot 的用法。

用法

Axes.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, flierprops=None, medianprops=None, meanprops=None, capprops=None, whiskerprops=None, manage_ticks=True, autorange=False, zorder=None, capwidths=None, *, data=None)

繪製箱須圖。

該框從數據的第一個四分位數 (Q1) 延伸到第三個四分位數 (Q3)，中間有一條線。須線從方框延伸到距方框 1.5 倍四分位數範圍 (IQR) 內的最遠數據點。飛行點是那些超出胡須末端的點。請參閱https://en.wikipedia.org/wiki/Box_plot 以供參考。

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

參數：

x 數組或向量序列。

輸入數據。如果是二維數組，則會為 x 中的每一列繪製一個箱線圖。如果是一維數組序列，則會為 x 中的每個數組繪製箱線圖。

notch 布爾值，默認值：假

是繪製一個缺口箱線圖 ( True )，還是一個矩形箱線圖 ( False )。缺口代表中位數周圍的置信區間 (CI)。 bootstrap 的文檔說明了默認情況下如何計算槽口的位置，但也可以通過設置 conf_intervals 參數來覆蓋它們的位置。

注意

在 CI 值小於下四分位數或大於上四分位數的情況下，缺口將延伸到盒子之外，使其具有獨特的 "flipped" 外觀。這是預期的行為，並且與其他統計可視化包一致。

sym str，可選

飛行點的默認符號。空字符串 ('') 隱藏傳單。如果 None ，則傳單默認為 'b+'。 flierprops 參數提供更多控製。

vert 布爾值，默認值：真

如果 True ，則繪製垂直框。如果 False ，繪製水平框。

whis 浮點數或(浮點數，浮點數)，默認值：1.5

胡須的位置。

如果是浮點數，則下須線位於 Q1 - whis*(Q3-Q1) 上方的最低基準處，而上方須線位於 Q3 + whis*(Q3-Q1) 下方的最高基準處，其中 Q1 和 Q3 是第一和第三四分位數。 whis = 1.5 的默認值對應於 Tukey 對箱線圖的原始定義。

如果是一對浮點數，它們表示繪製胡須的百分位數(例如，(5, 95))。特別是，將其設置為 (0, 100) 會導致胡須覆蓋整個數據範圍。

在 Q1 == Q3 的邊情況下，如果 autorange 為 True，則 whis 會自動設置為 (0, 100)(覆蓋整個數據範圍)。

除了胡須，數據被認為是異常值，並被繪製為單個點。

bootstrap 整數，可選

指定是否在缺口箱線圖的中位數附近引導置信區間。如果bootstrap 為無，則不執行自舉，並使用基於高斯的漸近近似計算缺口(參見 McGill, R.、Tukey, J.W. 和 Larsen, W.A., 1978 以及 Kendall 和 Stuart, 1967)。否則，bootstrap 指定引導中位數以確定其 95% 置信區間的次數。建議使用 1000 到 10000 之間的值。

usermedians 一維數組，可選

長度為 len(x) 的類似一維數組。每個不是 None 的條目都會強製使用相應數據集的中位數。對於 None 的條目，中位數由 Matplotlib 正常計算。

conf_intervals 類似數組，可選

形狀為 (len(x), 2) 的類似二維數組。每個不是 None 的條目都會強製指定相應凹口的位置(僅當 notch 為 True 時才繪製)。對於 None 的條目，缺口是通過其他參數指定的方法(例如 bootstrap )計算的。

positions 類似數組，可選

箱子的位置。刻度線和限製會自動設置以匹配位置。默認為range(1, N+1)，其中 N 是要繪製的框數。

widths 浮點或類似數組

盒子的寬度。默認值為 0.5 或 0.15*(distance between extreme positions) (如果較小)。

patch_artist 布爾值，默認值：假

如果 False 使用 Line2D 藝術家生成框。否則，將使用 Patch 藝術家繪製框。

labels 順序，可選

每個數據集的標簽(每個數據集一個)。

manage_ticks 布爾值，默認值：真

如果為 True，將調整刻度位置和標簽以匹配箱線圖位置。

autorange 布爾值，默認值：假

當 True 和數據分布使得第 25 個和第 75 個百分位數相等時，whis 設置為 (0, 100)，使得須線末端位於數據的最小值和最大值處。

meanline 布爾值，默認值：假

如果 True (並且 showmeans 是 True )，將嘗試根據 meanprops 將平均值呈現為跨越框的整個寬度的線(見下文)。如果 shownotches 也是 True，則不推薦。否則，均值將顯示為點。

zorder 浮點數，默認：Line2D.zorder = 2

箱線圖的 zorder。

返回：

dict

將箱線圖的每個組件映射到創建的 Line2D 實例列表的字典。該字典具有以下鍵(假設垂直箱線圖)：

• boxes ：箱線圖的主體顯示四分位數和中位數的置信區間(如果啟用)。

• medians ：每個盒子中間的水平線。

• whiskers：垂直線延伸到最極端的非異常數據點。

• caps ：胡須末端的水平線。

• fliers ：表示超出胡須(飛行物)的數據的點。

• means ：表示均值的點或線。

其他參數：

showcaps 布爾值，默認值：真

顯示胡須末端的帽子。

showbox 布爾值，默認值：真

顯示中央框。

showfliers 布爾值，默認值：真

顯示超出上限的異常值。

showmeans 布爾值，默認值：假

顯示算術平均值。

capprops 字典，默認值：無

帽子的樣式。

capwidths 浮點數或數組，默認值：無

帽子的寬度。

boxprops 字典，默認值：無

盒子的樣式。

whiskerprops 字典，默認值：無

胡須的樣式。

flierprops 字典，默認值：無

傳單的風格。

medianprops 字典，默認值：無

中位數的樣式。

meanprops 字典，默認值：無

中庸的風格。

data 可索引對象，可選

如果給定，所有參數也接受一個字符串 s ，它被解釋為 data[s] (除非這引發異常)。