seaborn.relplot#

seaborn.relplot(data=None, *, x=None, y=None, hue=None, size=None, style=None, units=None, weights=None, row=None, col=None, col_wrap=None, row_order=None, col_order=None, palette=None, hue_order=None, hue_norm=None, sizes=None, size_order=None, size_norm=None, markers=None, dashes=None, style_order=None, legend='auto', kind='scatter', height=5, aspect=1, facet_kws=None, **kwargs)[源代码]#

用于在 FacetGrid 上绘制关系图的图级别接口。

此函数提供了访问多个不同的轴级函数的功能，这些函数显示了两个变量之间的关系，并使用子集的语义映射。kind 参数选择要使用的底层轴级函数：

  • 散点图() (使用 kind="scatter"；默认)

  • lineplot() (使用 kind="line")

额外的关键字参数会传递给底层函数，因此您应该参考每个函数的文档以查看特定类型的选项。

通过使用 hue、size 和 style 参数，可以展示 x 和 y 在数据不同子集之间的关系。这些参数控制用于标识不同子集的可视化语义。通过使用所有三种语义类型，可以独立显示多达三个维度，但这种图表风格可能难以解释，并且通常效果不佳。使用冗余语义（即对同一变量同时使用 hue 和 style）可以帮助使图形更易于理解。

更多信息请参见 教程。

如果存在 hue`（以及在较小程度上，`size）语义，默认的处理方式取决于变量是否被推断为表示“数值”或“分类”数据。特别是，数值变量默认使用顺序色图表示，并且图例条目显示带有值的常规“刻度”，这些值可能存在于数据中，也可能不存在。这种行为可以通过以下描述和示例的各种参数进行控制。

绘图后，返回带有绘图的 FacetGrid ，可以直接用于调整支持绘图的细节或添加其他图层。

参数:
数据 : pandas.DataFrame, numpy.ndarray, 映射, 或序列pandas.DataFrame, numpy.ndarray, 映射, 或序列

输入数据结构。可以是可分配给命名变量的长格式向量集合，也可以是将被内部重塑的宽格式数据集。

x, y : data 中的向量或键向量或键

指定x轴和y轴位置的变量。

hue : data 中的向量或键向量或键

将生成具有不同颜色的元素的分组变量。可以是分类变量或数值变量，尽管在后一种情况下颜色映射的行为会有所不同。

size : 向量或 data 中的键向量或键

将生成不同大小元素的分组变量。可以是分类变量或数值变量，尽管在后一种情况下，大小映射的行为会有所不同。

样式 : 向量或 数据 中的键向量或键

将生成具有不同样式的分组变量。可以具有数值类型，但始终会被视为分类变量。

单位 : 向量或 数据 中的键向量或键

分组变量，用于识别采样单位。使用时，将为每个单位绘制单独的线条，并带有适当的语义，但不会添加图例条目。在不需要精确身份时，显示实验重复的分布非常有用。

weights : 向量或 data 中的键向量或键

用于计算加权估计的数据值或列。请注意，目前使用权重将统计选择限制为 ‘均值’ 估计器和 ‘置信区间’ 误差条。

row, col : data 中的向量或键向量或键

定义在不同方面绘制子集的变量。

col_wrap整数

在此宽度处“包裹”列变量，以便列分面跨越多行。与 row 分面不兼容。

row_order, col_order字符串列表

用于组织网格的行和/或列的顺序，否则顺序将从数据对象中推断。

palette : 字符串, 列表, 字典, 或 matplotlib.colors.Colormap字符串, 列表, 字典, 或

选择用于映射 hue 语义的颜色时的方法。字符串值传递给 color_palette()。列表或字典值意味着分类映射，而颜色映射对象意味着数值映射。

hue_order字符串向量

指定 hue 语义的分类级别的处理和绘图顺序。

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

一对设置数据单位归一化范围的值，或一个将数据单位映射到 [0, 1] 区间的对象。使用时意味着数值映射。

尺寸列表、字典或元组

一个决定在使用 size 时如何选择大小的对象。列表或字典参数应为每个唯一的数据值提供一个大小，这会强制进行分类解释。该参数也可以是一个最小值、最大值的元组。

size_order列表

指定 size 变量级别的显示顺序，否则它们将从数据中确定。当 size 变量为数值时不相关。

size_norm元组或归一化对象

当 size 变量为数值时，用于缩放绘图对象的数据单位标准化。

style_order列表

指定 style 变量级别的显示顺序，否则它们将从数据中确定。当 style 变量为数值时，此设置不相关。

破折号布尔值、列表或字典

对象确定如何绘制 style 变量不同级别的线条。设置为 True 将使用默认的虚线代码，或者您可以传递一个虚线代码列表或一个将 style 变量的级别映射到虚线代码的字典。设置为 False 将使用实线绘制所有子集。虚线在 matplotlib 中指定为：一个 (线段, 间隙) 长度的元组，或者一个空字符串来绘制实线。

标记布尔值、列表或字典

对象确定如何绘制 style 变量不同级别的标记。设置为 True 将使用默认标记，或者您可以传递一个标记列表或一个将 style 变量级别映射到标记的字典。设置为 False 将绘制无标记的线条。标记的指定方式与 matplotlib 中相同。

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

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

种类字符串

要绘制的图形类型，对应于 seaborn 的关系图。选项为 "scatter" 或 "line"。

高度标量

每个分面的高度（以英寸为单位）。另见：aspect。

方面标量

每个面的宽高比，使得 aspect * height 给出每个面在英寸中的宽度。

facet_kwsdict

传递给 FacetGrid 的其他关键字参数的字典。

kwargs键, 值 配对

其他关键字参数将传递给底层绘图函数。

返回:
FacetGrid

一个管理一个或多个子图的对象，这些子图对应于条件数据子集，并具有方便的方法来批量设置轴属性。

示例