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()のAPIとオプションと同じであるため、ネストされた変数全体の数を比較できます。

histplot()関数は、デフォルトの動作が多少異なるものの、追加機能（例：バーの積み重ね）を備えた同様の機能を提供することに注意してください。

詳細については、チュートリアルを参照してください。

注記

デフォルトでは、この関数は変数の1つをカテゴリとして扱い、関連する軸上の序数位置（0、1、… n）にデータを描画します。バージョン0.13.0以降、native_scale=Trueを設定することで、これを無効にすることができます。

パラメータ:
dataDataFrame、Series、dict、array、またはarrayのリスト

プロット用のデータセット。 xとyが存在しない場合、これはワイドフォームとして解釈されます。 それ以外の場合は、ロングフォームであると予想されます。

**x, y, huedata内の変数の名前またはベクトルデータ

ロングフォームデータのプロット用の入力。解釈については例を参照してください。

order, hue_order文字列のリスト

カテゴリレベルをプロットする順序。それ以外の場合は、レベルはデータオブジェクトから推測されます。

**orient”v” | “h” | “x” | “y”

プロットの方向（垂直または水平）。これは通常、入力変数のタイプに基づいて推測されますが、xとyの両方が数値の場合、またはワイドフォームデータをプロットする場合に、あいまいさを解決するために使用できます。

バージョンv0.13.0で変更されました: 「v」/「h」と同等のオプションとして「x」/「y」を追加しました。

colormatplotlibの色

プロット内の要素の単一の色。

paletteパレット名、リスト、またはdict

hue変数の異なるレベルに使用する色。color_palette()によって解釈できるもの、または色相レベルをmatplotlibの色にマッピングする辞書である必要があります。

saturation浮動小数点数

塗りつぶしの色を描画するための元の彩度の割合。大きなパッチは彩度が低い色の方がよく見えることがよくありますが、入力値と完全に一致させる場合は、これを1に設定します。

hue_normタプルまたはmatplotlib.colors.Normalizeオブジェクト

hue変数が数値の場合に、それに適用されるカラーマップのデータ単位での正規化。hueがカテゴリの場合、関連しません。

バージョンv0.12.0の新機能。

**stat{‘count’, ‘percent’, ‘proportion’, ‘probability’}

計算する統計量。 'count'でない場合、バーの高さは、プロット全体で100（'percent'の場合）または1（それ以外の場合）に合計されるように正規化されます。

バージョンv0.13.0の新機能。

width浮動小数点数

方向軸上の各要素に割り当てられた幅。 native_scale=Trueの場合、ネイティブスケールでの2つの値間の最小距離に対する相対値です。

dodge”auto”またはbool

色相マッピングが使用されている場合、要素を狭めて方向軸に沿ってシフトしてオーバーラップをなくすかどうか。「auto」の場合、方向変数がカテゴリ変数と交差している場合はTrueに、それ以外の場合はFalseに設定します。

バージョン0.13.0で変更されました: 新しいデフォルトとして"auto"モードを追加しました。

log_scaleboolまたは数値、またはboolまたは数値のペア

軸スケールをログに設定します。単一の値は、プロット内の数値軸のデータ軸を設定します。値のペアは、各軸を個別に設定します。数値は、目的の底（デフォルトは10）として解釈されます。NoneまたはFalseの場合、seabornは既存の軸スケールに依存します。

バージョンv0.13.0の新機能。

**native_scalebool

Trueの場合、カテゴリ軸の数値または日付時刻値は、固定インデックスに変換されるのではなく、元のスケールが維持されます。

バージョンv0.13.0の新機能。

formatter呼び出し可能

カテゴリデータを文字列に変換する関数。グループ化と目盛ラベルの両方に影響します。

バージョンv0.13.0の新機能。

legend“auto”, “brief”, “full”, または False

凡例の描画方法。 "brief"の場合、数値のhue変数とsize変数は、等間隔の値のサンプルで表されます。 "full"の場合、すべてのグループが凡例にエントリを取得します。 "auto"の場合、レベルの数に基づいてbriefまたはfullの表現を選択します。 Falseの場合、凡例データは追加されず、凡例は描画されません。

バージョンv0.13.0の新機能。

axmatplotlib Axes

プロットを描画するAxesオブジェクト。指定しない場合は、現在のAxesが使用されます。

kwargsキーと値のマッピング

その他のパラメータはmatplotlib.patches.Rectangleに渡されます。

戻り値:
axmatplotlib Axes

プロットが描画されたAxesオブジェクトを返します。

参照

histplot

追加オプションを使用して観測値をビン化してカウントします。

barplot

バーを使用して点推定値と信頼区間を表示します。

catplot

カテゴリプロットとFacetGridを組み合わせます。

例

単一のカテゴリ変数の値の数を表示します。

sns.countplot(titanic, x="class")
../_images/countplot_1_0.png

2番目の変数でグループ化します。

sns.countplot(titanic, x="class", hue="survived")
../_images/countplot_3_0.png

割合を表示するためにカウントを正規化します。

sns.countplot(titanic, x="class", hue="survived", stat="percent")
../_images/countplot_5_0.png