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、array 或 array 列表

用于绘图的数据集。如果 x 和 y 缺失，则将其解释为宽格式。否则，预计它将是长格式。

x, y, hue数据中的变量名称或向量数据

用于绘制长格式数据的输入。有关解释，请参阅示例。

order, hue_order字符串列表

绘制类别级别的顺序；否则，级别将从数据对象推断出来。

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

绘图的方向（垂直或水平）。这通常根据输入变量的类型推断出来，但可用于解决当 x 和 y 均为数值或绘制宽格式数据时出现的歧义。

在版本 v0.13.0 中更改: 添加了 ‘x’/’y’ 作为选项，等效于 ‘v’/’h’。

colormatplotlib 颜色

绘图中元素的单一颜色。

palette调色板名称、列表或字典

用于 hue 变量的不同级别的颜色。应该是 color_palette() 可以解释的内容，或者是一个将色调级别映射到 matplotlib 颜色的字典。

saturationfloat

绘制填充颜色的原始饱和度比例。较大的色块通常在使用去饱和颜色时看起来更好，但如果要让颜色与输入值完全匹配，请将其设置为 1。

hue_norm元组或 matplotlib.colors.Normalize 对象

当 hue 为数字时，应用于 hue 变量的颜色图的数据单位标准化。如果 hue 为类别变量，则无关紧要。

v0.12.0 版本新增。

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

要计算的统计信息；当不是 'count' 时，条形高度将被标准化，以便它们在整个绘图中相加为 100（对于 'percent'）或 1（否则）。

v0.13.0 版本新增。

widthfloat

分配给 orient 轴上每个元素的宽度。当 native_scale=True 时，它相对于本机刻度中两个值的最小距离。

dodge“auto” 或 bool

当使用色调映射时，元素是否应该沿 orient 轴变窄并移动以消除重叠。如果为 "auto"，则在 orient 变量与类别变量交叉时设置为 True，否则设置为 False。

在版本 0.13.0 中更改: 添加了 "auto" 模式作为新的默认模式。

log_scalebool 或数字，或 bool 或数字对

将轴刻度设置为对数。单个值会设置图中任何数值轴的数据轴。一对值会独立设置每个轴。数值被解释为所需的基数（默认值 10）。当为 None 或 False 时，seaborn 会参考现有的 Axes 刻度。

v0.13.0 版本新增。

native_scalebool

当为 True 时，分类轴上的数值或日期时间值将保持其原始比例，而不是被转换为固定索引。

v0.13.0 版本新增。

formattercallable

用于将分类数据转换为字符串的函数。影响分组和刻度标签。

v0.13.0 版本新增。

legend“auto”, “brief”, “full”, or False

如何绘制图例。如果为“brief”，则数值 hue 和 size 变量将使用均匀间隔值的样本进行表示。如果为“full”，则每个组将在图例中获得一个条目。如果为“auto”，则根据级别数量选择简要或完整的表示方式。如果为 False，则不会添加图例数据，也不会绘制图例。

v0.13.0 版本新增。

axmatplotlib Axes

用于绘制图形的 Axes 对象，否则使用当前 Axes。

kwargskey, value mappings

其他参数将传递给 matplotlib.patches.Rectangle.

返回:

axmatplotlib Axes

返回绘制了图形的 Axes 对象。

另请参阅

histplot

使用其他选项对观察结果进行分箱和计数。

barplot

使用条形图显示点估计和置信区间。

catplot

将分类图与 FacetGrid 组合在一起。

示例

显示单个分类变量的值计数

sns.countplot(titanic, x="class")

按第二个变量进行分组

sns.countplot(titanic, x="class", hue="survived")

对计数进行归一化以显示百分比

sns.countplot(titanic, x="class", hue="survived", stat="percent")