seaborn.swarmplot

seaborn.swarmplot(data=None, *, x=None, y=None, hue=None, order=None, hue_order=None, dodge=False, orient=None, color=None, palette=None, size=5, edgecolor=None, linewidth=0, hue_norm=None, log_scale=None, native_scale=False, formatter=None, legend='auto', warn_thresh=0.05, ax=None, **kwargs)

绘制一个分类散点图，点调整以避免重叠。

此函数类似于 stripplot()，但点会调整（仅沿分类轴）以避免重叠。这提供了值分布的更好表示，但它不能很好地扩展到大量观察值。这种样式的图有时被称为“蜂群图”。

蜂群图可以单独绘制，但在你想展示所有观测值以及一些底层分布表示的情况下，它也是箱形图或小提琴图的一个很好的补充。

更多信息请参见 教程。

备注

默认情况下，此函数将其中一个变量视为分类变量，并在相关轴上按序数位置（0, 1, … n）绘制数据。自版本 0.13.0 起，可以通过设置 native_scale=True 来禁用此功能。

参数:

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

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

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

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

order, hue_order字符串列表

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

躲避布尔

当分配了 hue 变量时，将其设置为 True 将沿着分类轴为不同的色调级别分离群集，并减少分配给每个条带的空间量。否则，每个级别的点将在同一个群集中绘制。

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

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

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

颜色matplotlib 颜色

图表中元素的单一颜色。

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

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

大小浮动

标记的半径，以点为单位。

edgecolormatplotlib 颜色, “gray” 是特殊处理的

每个点周围的线条颜色。如果你传递 "gray"，亮度将由用于点主体的颜色调色板决定。

行宽浮动

包围绘图元素的线条宽度。

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.axes.Axes.scatter()。

返回:

axmatplotlib Axes

返回带有绘图的 Axes 对象。

参见

boxplot

一个具有类似API的传统箱线图。

violinplot

箱线图和核密度估计的结合。

stripplot

一个散点图，其中一变量为分类变量。可以与其他图表结合使用，以显示每个观察结果。

catplot

将分类图与 FacetGrid 结合。

示例