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 来禁用此功能。

参数:
数据DataFrame, Series, 字典, 数组, 或数组的列表

用于绘图的数据集。如果 xy 缺失,则解释为宽格式。否则,预期为长格式。

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

绘制长格式数据的输入。参见示例以进行解释。

order, hue_order字符串列表

指定分类级别的绘制顺序;否则,级别将从数据对象中推断。

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

图形的方向(垂直或水平)。这通常根据输入变量的类型推断,但在 xy 都是数值或绘制宽格式数据时,可以用来解决歧义。

在 v0.13.0 版本发生变更: 添加了 ‘x’/’y’ 作为选项,等同于 ‘v’/’h’。

颜色matplotlib 颜色

图表中元素的单一颜色。

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

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

饱和度浮动

用于绘制填充颜色的原始饱和度比例。大面积的色块通常用去饱和的颜色看起来更好,但如果您希望颜色与输入值完全匹配,请将其设置为 1

hue_norm : 元组或 matplotlib.colors.Normalize 对象元组或

应用于 hue 变量时的数据单位归一化,当 hue 为数值型时。如果 hue 是分类变量,则不相关。

在 v0.12.0 版本加入.

统计{‘count’, ‘percent’, ‘proportion’, ‘probability’}

要计算的统计量;当不是 'count' 时,条形高度将被标准化,使得它们在图表中总和为 100(对于 'percent')或 1(否则)。

在 v0.13.0 版本加入.

宽度浮动

在方向轴上分配给每个元素的宽度。当 native_scale=True 时,它是相对于原生刻度中两个值之间的最小距离的。

躲避“auto” 或 bool

当使用色调映射时,是否应沿方向轴缩小和移动元素以消除重叠。如果为 "auto",则在方向变量与分类变量交叉时设置为 True,否则设置为 False

在 0.13.0 版本发生变更: 新增了 "auto" 模式作为新的默认设置。

log_scale布尔值或数字,或布尔值或数字对

将轴比例设置为对数。单个值设置图中任何数值轴的数据轴。一对值分别独立设置每个轴。数值被解释为所需的对数底数(默认10)。当为 NoneFalse 时,seaborn 将遵循现有的 Axes 比例。

在 v0.13.0 版本加入.

native_scale布尔

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

在 v0.13.0 版本加入.

格式化器可调用

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

在 v0.13.0 版本加入.

图例“auto”、“brief”、“full”或False

如何绘制图例。如果为“brief”,数值型的 huesize 变量将用均匀间隔的值样本表示。如果为“full”,每个组都会在图例中获得一个条目。如果为“auto”,则根据级别的数量在简短或完整表示之间选择。如果为 False,则不会添加图例数据,也不会绘制图例。

在 v0.13.0 版本加入.

axmatplotlib Axes

要在其上绘制图形的 Axes 对象,否则使用当前的 Axes。

kwargs键, 值 映射

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

返回:
axmatplotlib Axes

返回带有绘图的 Axes 对象。

参见

histplot

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

barplot

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

catplot

将分类图与 FacetGrid 结合。

示例