0.12.0.dev0
  • Gallery
  • Tutorial
  • API
  • Site
      • 发行说明
      • 安装
      • 示例库
      • 教程
      • API引用
      • 引用
      • 档案文件
  • Page
      • seaborn.relplot

seaborn.relplot¶

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 ,以及其他参数。

参数
x, y :矢量或键入 data向量或键

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

hue :矢量或键入 data向量或键

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

size :矢量或键入 data向量或键

将产生不同大小元素的分组变量。可以是分类的,也可以是数字的,尽管大小映射在后一种情况下的行为不同。

风格 :矢量或键入 data向量或键

将生成具有不同样式的元素的分组变量。可以具有数字数据类型,但始终被视为分类的。

data : pandas.DataFrame , numpy.ndarray 、映射或序列1.数据帧, numpy.ndarray公司、映射或序列

输入数据结构。可以指定给命名变量的向量的长格式集合,或将在内部重新成形的宽格式数据集。

行,列 :矢量或键入 data向量或键

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

col_wrap利息

以此宽度“包装”列变量,以便列面跨多行。与…不相容 row 方面。

row_order, col_order字符串列表

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

调色板 : string, list, dict, or matplotlib.colors.Colormap字符串、列表、dict或

用于在映射时选择要使用的颜色的方法 hue 语义的。字符串值传递给 color_palette() . List或dict值表示分类映射,而colormap对象表示数字映射。

hue_order弦向量

指定文件的分类级别的处理和打印顺序 hue 语义的。

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

以数据单位设置规范化范围的一对值或将从数据单位映射到 [0, 1] 间隔。用法意味着数字映射。

sizes列表、dict或tuple

一种对象,它决定了当 size 已使用。它始终可以是大小值列表或对象的dict映射级别 size 大小不一。什么时候? size 如果是数字,它也可以是一个元组,指定要使用的最小和最大大小,以便在此范围内对其他值进行规范化。

size_order列表

指定的外观顺序 size 变量级别,否则根据数据确定。当 size 变量为数字。

size_norm元组或规范化对象

当 size 变量为数字。

style_order列表

指定的外观顺序 style 变量水平,否则根据数据确定。当 style 变量为数字。

dashes布尔值、列表或字典

对象,用于确定如何绘制 style 变量。设置为 True 将使用默认的破折号代码,或者您可以传递破折号代码列表或 style 变量到破折号代码。设置为 False 将对所有子集使用实线。破折号是在matplotlib中指定的:一个元组 (segment, gap) 或一个空字符串来画一条实线。

markers布尔值、列表或字典

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

legend“auto”、“brief”、“full”或False

如何绘制图例。如果为“简短”,则为数字 hue 和 size 变量将用均匀分布的值的样本来表示。如果“已满”,每个组都将在图例中获得一个条目。如果为“自动”,则根据级别数选择“简短”或“完整”表示。如果 False ,不添加图例数据,也不绘制图例。

kind一串

Kind of plot to draw, corresponding to a seaborn relational plot. Options are {scatter and line}.

height标量

每个面的高度(英寸)。另请参见: aspect .

aspect标量

每个面的纵横比,以便 aspect * height 以英寸为单位给出每个面的宽度。

facet_kws双关语

要传递到的其他关键字参数的字典 FacetGrid .

单位 :矢量或键入 data向量或键

识别取样单位的分组变量。使用时,将为每个单元绘制一条具有适当语义的单独线,但不会添加图例条目。当不需要精确的同一性时,用于显示实验复制品的分布。

kwargs键,值配对

其他关键字参数传递给底层的plotting函数。

返回
FacetGrid

一种管理一个或多个子图的对象,该子图对应于条件数据子集,用方便的方法批量设置轴属性。

实例

Back to top

© Copyright 2012-2021, Michael Waskom. 构建基于 Sphinx 3.4.1.