seaborn.objects.Plot#

class seaborn.objects.Plot(*args, data=None, x=None, y=None, color=None, alpha=None, fill=None, marker=None, pointsize=None, stroke=None, linewidth=None, linestyle=None, fillcolor=None, fillalpha=None, edgewidth=None, edgestyle=None, edgecolor=None, edgealpha=None, text=None, halign=None, valign=None, offset=None, fontsize=None, xmin=None, xmax=None, ymin=None, ymax=None, group=None)[源代码]#

一个用于声明式指定统计图形的接口。

图表是通过初始化此类并添加一个或多个层来构建的,这些层包括一个 Mark 和可选的 StatMove。此外,可以定义分面变量或变量对来将空间划分为多个子图。可以使用比例参数化从数据值到视觉属性的映射,尽管当未明确定义比例时,图表将尝试推断良好的默认值。

构造函数接受一个数据源(一个 pandas.DataFrame 或包含列值的字典)和变量赋值。变量可以作为数据源的键传递,或者直接作为数据向量传递。如果提供了多个包含数据的对象,它们将按索引对齐。

在构造函数中定义的数据源和变量将用于图中的所有层,除非在添加层时被覆盖或禁用。

以下变量可以在构造函数中定义:

x, y, color, alpha, fill, marker, pointsize, stroke, linewidth, linestyle, fillcolor, fillalpha, edgewidth, edgestyle, edgecolor, edgealpha, text, halign, valign, offset, fontsize, xmin, xmax, ymin, ymax, group

dataxy 变量可以通过位置参数或使用关键字传递。第一个位置参数是解释为数据源还是 x 变量取决于其类型。

此类的方法返回实例的副本;通过多次调用构建图表时使用链式调用。方法可以按任意顺序调用。

大多数方法仅向绘图规范添加信息;直到显示或保存绘图时才会进行实际处理。也可以在不渲染的情况下编译绘图以访问较低级别的表示。

方法#

规范方法

add

在标记和数据转换方面指定可视化的一层。

scale

指定数据单元到视觉属性的映射。

子图方法

facet

根据数据的条件子集生成子图。

pair

通过配对多个 x 和/或 y 变量来生成子图。

自定义方法

layout

控制图形的大小和布局。

label

控制轴、图例和子图的标签和标题。

limit

控制可见数据的范围。

share

控制子图之间轴限和刻度的共享。

theme

控制图表中元素的外观。

集成方法

on

提供现有的 Matplotlib 图形或轴以绘制图表。

输出方法

plot

编译绘图规范并返回 Plotter 对象。

save

编译图表并将其写入缓冲区或磁盘文件。

show

通过钩入 pyplot 来编译并显示图表。

配置#

可以通过 Plot 对象的 Plot.config 属性来配置其默认行为。请注意,这是一个类的属性,而不是实例上的方法。