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, 字典, 数组, 或数组的列表
用于绘图的数据集。如果
x和y缺失,则解释为宽格式。否则,预期为长格式。- x, y, hue :
data中的变量名称或向量数据变量名 绘制长格式数据的输入。参见示例以进行解释。
- order, hue_order字符串列表
指定分类级别的绘制顺序;否则,级别将从数据对象中推断。
- orient“v” | “h” | “x” | “y”
图形的方向(垂直或水平)。这通常根据输入变量的类型推断,但在
x和y都是数值或绘制宽格式数据时,可以用来解决歧义。在 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)。当为
None或False时,seaborn 将遵循现有的 Axes 比例。在 v0.13.0 版本加入.
- native_scale布尔
当为 True 时,分类轴上的数值或日期时间值将保持其原始比例,而不是被转换为固定索引。
在 v0.13.0 版本加入.
- 格式化器可调用
用于将分类数据转换为字符串的函数。影响分组和刻度标签。
在 v0.13.0 版本加入.
- 图例“auto”、“brief”、“full”或False
如何绘制图例。如果为“brief”,数值型的
hue和size变量将用均匀间隔的值样本表示。如果为“full”,每个组都会在图例中获得一个条目。如果为“auto”,则根据级别的数量在简短或完整表示之间选择。如果为False,则不会添加图例数据,也不会绘制图例。在 v0.13.0 版本加入.
- axmatplotlib Axes
要在其上绘制图形的 Axes 对象,否则使用当前的 Axes。
- kwargs键, 值 映射
其他参数传递给
matplotlib.patches.Rectangle。
- 返回:
- axmatplotlib Axes
返回带有绘图的 Axes 对象。
示例