seaborn.
relplot
(*, x=None, y=None, hue=None, size=None, style=None, data=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, units=None, **kwargs)¶图形级接口,用于在FacetGrid上绘制关系图。
此函数提供对多个不同轴级别函数的访问,这些函数通过子集的语义映射显示两个变量之间的关系。这个 kind
参数选择要使用的底层轴级别函数:
scatterplot()
(与 kind="scatter"
;默认值)
lineplot()
(与 kind="line"
)
额外的关键字参数被传递给基础函数,因此您应该参考每个关键字的文档,以查看特定于种类的选项。
之间的关系 x
和 y
可以使用 hue
, size
和 style
参数。这些参数控制用于标识不同子集的视觉语义。通过使用所有三种语义类型,可以独立显示多达三个维度,但这种类型的情节可能很难解释,而且往往是无效的。使用冗余语义(即两者 hue
和 style
对于相同的变量)可以有助于使图形更易于访问。
见 tutorial 更多信息。
对 hue
(在较小程度上, size
)语义(如果存在的话)取决于变量是被推断为表示“数字”还是“分类”数据。特别是,默认情况下,数字变量用顺序颜色映射表示,图例条目显示规则的“记号”,其值可能在数据中存在,也可能不存在。这种行为可以通过各种参数来控制,如下所述和所示。
在策划之后 FacetGrid
与绘图一起返回,可直接用于调整支持的绘图细节或添加其他图层。
请注意,与直接使用底层绘图函数不同,数据必须以长格式数据帧的形式传递,其中的变量是通过将字符串传递给 x
, y
,以及其他参数。
data
向量或键指定x轴和y轴位置的变量。
data
向量或键将生成具有不同颜色的元素的分组变量。可以是分类的,也可以是数字的,尽管在后一种情况下颜色映射的行为会有所不同。
data
向量或键将产生不同大小元素的分组变量。可以是分类的,也可以是数字的,尽管大小映射在后一种情况下的行为不同。
data
向量或键将生成具有不同样式的元素的分组变量。可以具有数字数据类型,但始终被视为分类的。
pandas.DataFrame
, numpy.ndarray
、映射或序列1.数据帧, numpy.ndarray公司、映射或序列输入数据结构。可以指定给命名变量的向量的长格式集合,或将在内部重新成形的宽格式数据集。
data
向量或键定义要在不同面上绘制的子集的变量。
以此宽度“包装”列变量,以便列面跨多行。与…不相容 row
方面。
以组织中网格的行和/或列,否则将从数据对象推断顺序。
matplotlib.colors.Colormap
字符串、列表、dict或用于在映射时选择要使用的颜色的方法 hue
语义的。字符串值传递给 color_palette()
. List或dict值表示分类映射,而colormap对象表示数字映射。
指定文件的分类级别的处理和打印顺序 hue
语义的。
matplotlib.colors.Normalize
元组或以数据单位设置规范化范围的一对值或将从数据单位映射到 [0, 1] 间隔。用法意味着数字映射。
一种对象,它决定了当 size
已使用。它始终可以是大小值列表或对象的dict映射级别 size
大小不一。什么时候? size
如果是数字,它也可以是一个元组,指定要使用的最小和最大大小,以便在此范围内对其他值进行规范化。
指定的外观顺序 size
变量级别,否则根据数据确定。当 size
变量为数字。
当 size
变量为数字。
指定的外观顺序 style
变量水平,否则根据数据确定。当 style
变量为数字。
对象,用于确定如何绘制 style
变量。设置为 True
将使用默认的破折号代码,或者您可以传递破折号代码列表或 style
变量到破折号代码。设置为 False
将对所有子集使用实线。破折号是在matplotlib中指定的:一个元组 (segment, gap)
或一个空字符串来画一条实线。
对象,确定如何为不同级别的对象绘制标记 style
变量。设置为 True
将使用默认标记,或者您可以传递标记列表或字典映射的级别 style
变量到标记。设置为 False
将绘制无标记线。标记在matplotlib中指定。
如何绘制图例。如果为“简短”,则为数字 hue
和 size
变量将用均匀分布的值的样本来表示。如果“已满”,每个组都将在图例中获得一个条目。如果为“自动”,则根据级别数选择“简短”或“完整”表示。如果 False
,不添加图例数据,也不绘制图例。
Kind of plot to draw, corresponding to a seaborn relational plot.
Options are {scatter
and line
}.
每个面的高度(英寸)。另请参见: aspect
.
每个面的纵横比,以便 aspect * height
以英寸为单位给出每个面的宽度。
要传递到的其他关键字参数的字典 FacetGrid
.
data
向量或键识别取样单位的分组变量。使用时,将为每个单元绘制一条具有适当语义的单独线,但不会添加图例条目。当不需要精确的同一性时,用于显示实验复制品的分布。
其他关键字参数传递给底层的plotting函数。
FacetGrid
一种管理一个或多个子图的对象,该子图对应于条件数据子集,用方便的方法批量设置轴属性。
实例