绘图对象简介#

您在 Matplotlib 图表中交互的几乎所有对象都称为“绘图对象”(并且是 Artist 类的子类)。图形坐标轴 是绘图对象,通常包含 Axis 绘图对象以及包含数据或注释信息的绘图对象。

创建绘图对象#

通常我们不会直接实例化绘图对象,而是使用 Axes 上的绘图方法。下面给出了一些绘图方法和它们创建的绘图对象示例

坐标轴辅助方法

艺术家

annotate - 文本注释

注释

bar - 条形图

矩形

errorbar - 错误条形图

Line2DRectangle

fill - 共享区域

多边形

hist - 直方图

矩形

imshow - 图像数据

AxesImage

legend - 轴图例

图例

plot - xy 图

Line2D

scatter - 散点图

PolyCollection

text - 文本

文本

例如,我们可以保存从 axes.Axes.plot 返回的 Line2D 艺术家

In [209]: import matplotlib.pyplot as plt
In [210]: import matplotlib.artist as martist
In [211]: import numpy as np

In [212]: fig, ax = plt.subplots()
In [213]: x, y = np.random.rand(2, 100)
In [214]: lines = ax.plot(x, y, '-', label='example')
In [215]: print(lines)
[<matplotlib.lines.Line2D at 0xd378b0c>]

请注意,plot 返回一个 _列表_,因为您可以传入多个 x, y 对来进行绘图。该线已添加到 Axes 中,我们可以通过 get_lines() 获取 Artist。

In [216]: print(ax.get_lines())
<a list of 1 Line2D objects>
In [217]: print(ax.get_lines()[0])
Line2D(example)

更改 Artist 属性#

获取 lines 对象使我们能够访问 Line2D 对象的所有属性。因此,如果我们想在事后更改 _linewidth_,可以使用 Artist.set

fig, ax = plt.subplots(figsize=(4, 2.5))
x = np.arange(0, 13, 0.2)
y = np.sin(x)
lines = ax.plot(x, y, '-', label='example', linewidth=0.2, color='blue')
lines[0].set(color='green', linewidth=2)

(Source code, 2x.png, png)

我们可以使用 matplotlib.artist.getp 查询可设置属性的完整列表。

In [218]: martist.getp(lines[0])
agg_filter = None
alpha = None
animated = False
antialiased or aa = True
bbox = Bbox(x0=0.004013842290585101, y0=0.013914221641967...
children = []
clip_box = TransformedBbox(     Bbox(x0=0.0, y0=0.0, x1=1.0, ...
clip_on = True
clip_path = None
color or c = blue
dash_capstyle = butt
dash_joinstyle = round
data = (array([0.91377845, 0.58456834, 0.36492019, 0.0379...
drawstyle or ds = default
figure = Figure(550x450)
fillstyle = full
gapcolor = None
gid = None
in_layout = True
label = example
linestyle or ls = -
linewidth or lw = 2.0
marker = None
markeredgecolor or mec = blue
markeredgewidth or mew = 1.0
markerfacecolor or mfc = blue
markerfacecoloralt or mfcalt = none
markersize or ms = 6.0
markevery = None
mouseover = False
path = Path(array([[0.91377845, 0.51224793],        [0.58...
path_effects = []
picker = None
pickradius = 5
rasterized = False
sketch_params = None
snap = None
solid_capstyle = projecting
solid_joinstyle = round
tightbbox = Bbox(x0=70.4609002763619, y0=54.321277798941786, x...
transform = CompositeGenericTransform(     TransformWrapper(  ...
transformed_clip_path_and_affine = (None, None)
url = None
visible = True
window_extent = Bbox(x0=70.4609002763619, y0=54.321277798941786, x...
xdata = [0.91377845 0.58456834 0.36492019 0.03796664 0.884...
xydata = [[0.91377845 0.51224793]  [0.58456834 0.9820474 ] ...
ydata = [0.51224793 0.9820474  0.24469912 0.61647032 0.483...
zorder = 2

请注意,大多数 Artist 也有一个不同的 setter 列表;例如,Line2D.set_colorLine2D.set_linewidth

更改 Artist 数据#

除了像colorlinewidth这样的样式属性外,Line2D对象还具有data属性。您可以在创建线条后使用Line2D.set_data设置数据。这通常用于动画,其中显示同一线条随时间推移而演变(参见使用Matplotlib进行动画)。

fig, ax = plt.subplots(figsize=(4, 2.5))
x = np.arange(0, 13, 0.2)
y = np.sin(x)
lines = ax.plot(x, y, '-', label='example')
lines[0].set_data([x, np.cos(x)])

(源代码, 2x.png, png)

手动添加艺术家#

并非所有艺术家都有辅助方法,或者您可能出于某种原因想要使用低级方法。例如,patches.Circle艺术家没有辅助方法,但我们仍然可以使用axes.Axes.add_artist方法创建并添加到Axes。

import matplotlib.patches as mpatches

fig, ax = plt.subplots(figsize=(4, 2.5))
circle = mpatches.Circle((0.5, 0.5), 0.25, ec="none")
ax.add_artist(circle)
clipped_circle = mpatches.Circle((1, 0.5), 0.125, ec="none", facecolor='C1')
ax.add_artist(clipped_circle)
ax.set_aspect(1)

(源代码, 2x.png, png)

Circle以圆的中心和半径作为参数传递给它的构造函数;可选参数作为关键字参数传递。

请注意,当我们像这样手动添加艺术家时,它不一定会像大多数辅助方法那样调整轴限制,因此艺术家可能会被剪裁,就像上面对clipped_circle补丁所做的那样。

有关其他补丁,请参见Matplotlib 艺术家参考

移除艺术家#

有时我们想从图形中移除艺术家,而无需从头开始重新指定整个图形。大多数艺术家都有一个可用的remove方法,它将从其Axes列表中移除艺术家。例如,lines[0].remove()将移除上面示例中创建的Line2D艺术家。