seaborn.countplot#
- seaborn.countplot(data=None, *, x=None, y=None, hue=None, order=None, hue_order=None, orient=None, color=None, palette=None, saturation=0.75, fill=True, hue_norm=None, stat='count', width=0.8, dodge='auto', gap=0, log_scale=None, native_scale=False, formatter=None, legend='auto', ax=None, **kwargs)#
使用長條圖顯示每個類別分組中的觀察次數。
計數圖可以被視為跨類別變數而非量化變數的直方圖。基本 API 和選項與
barplot()的相同，因此您可以比較巢狀變數之間的計數。請注意，
histplot()函式提供類似的功能以及其他功能（例如長條堆疊），儘管其預設行為有些不同。有關更多資訊，請參閱教學。
注意
預設情況下，此函式將其中一個變數視為類別變數，並在相關軸上的序數位置（0、1、... n）繪製資料。從 0.13.0 版本開始，可以透過設定
native_scale=True來停用此功能。- 參數:
- dataDataFrame、Series、dict、陣列或陣列列表
用於繪圖的資料集。如果缺少
x和y，則將其解釋為寬格式。否則，預期為長格式。- x, y, hue
data中的變數名稱或向量資料 用於繪製長格式資料的輸入。請參閱範例以瞭解說明。
- order, hue_order字串列表
繪製類別層級的順序；否則，層級會從資料物件推斷。
- orient“v” | “h” | “x” | “y”
繪圖的方向（垂直或水平）。通常會根據輸入變數的類型推斷，但當
x和y皆為數值時或繪製寬格式資料時，可以用於解決不明確的情況。在 v0.13.0 版本中變更：新增 ‘x’/’y’ 作為選項，等同於 ‘v’/’h’。
- colormatplotlib 色彩
繪圖中元素使用的單一色彩。
- palette調色盤名稱、列表或字典
用於
hue變數不同層級的色彩。應該是可由color_palette()解釋的內容，或是將色調層級對應到 matplotlib 色彩的字典。- saturation浮點數
繪製填滿色彩時的原始飽和度比例。較大的色塊通常在飽和度較低的色彩下看起來更好，但如果您希望色彩完全符合輸入值，請將此值設定為
1。- hue_norm元組或
matplotlib.colors.Normalize物件 當
hue變數為數值時，將色彩映射套用至hue變數的資料單位歸一化。如果hue是類別變數，則不相關。在 v0.12.0 版本中新增。
- stat{‘count’、‘percent’、‘proportion’、‘probability’}
要計算的統計量；如果不是
'count'，長條高度將會歸一化，使它們在整個圖表中加總為 100（對於'percent'）或 1（其他情況）。在 v0.13.0 版本中新增。
- width浮點數
在 orient 軸上分配給每個元素的寬度。當
native_scale=True時，它是相對於原生刻度中兩個值之間的最小距離。- dodge“auto” 或布林值
使用色調映射時，元素是否應沿著 orient 軸縮窄和移動以消除重疊。如果為
"auto"，當 orient 變數與類別變數交叉時設定為True，否則設定為False。在 0.13.0 版本中變更：新增
"auto"模式作為新的預設值。- log_scale布林值或數字，或布林值或數字對
將軸刻度設定為對數。單一值設定繪圖中任何數值軸的資料軸。一對值會獨立設定每個軸。數值會被解釋為所需的基數（預設為 10）。當
None或False時，seaborn 會延後至現有的軸刻度。在 v0.13.0 版本中新增。
- native_scale布林值
若為真 (True)，類別軸上的數值或日期時間值將保持其原始比例，而不會被轉換為固定索引。
在 v0.13.0 版本中新增。
- formatter可呼叫 (callable)
將類別資料轉換為字串的函數。會影響分組和刻度標籤。
在 v0.13.0 版本中新增。
- legend“auto”, “brief”, “full”, 或 False
如何繪製圖例。若為 “brief”，數值
hue和size變數將以均勻間隔的值樣本表示。若為 “full”，每個群組都會在圖例中獲得一個條目。若為 “auto”，則根據級別數選擇簡短或完整表示。若為False，則不添加圖例資料，也不會繪製圖例。在 v0.13.0 版本中新增。
- axmatplotlib Axes
要將圖形繪製到其上的 Axes 物件，否則使用目前的 Axes。
- kwargs鍵, 值對應 (key, value mappings)
其他參數會傳遞至
matplotlib.patches.Rectangle。
- 返回:
- axmatplotlib Axes
返回繪製了圖形的 Axes 物件。
範例
顯示單個類別變數的值計數
sns.countplot(titanic, x="class")
按第二個變數分組
sns.countplot(titanic, x="class", hue="survived")
正規化計數以顯示百分比
sns.countplot(titanic, x="class", hue="survived", stat="percent")
