Figure has an `~.figure.Figure.add_artist` method

A method `~.figure.Figure.add_artist` has been added to the

:class:`~.figure.Figure` class, which allows artists to be added directly

to a figure. E.g.

::

In case the added artist has no transform set previously, it will be set to

the figure transform (``fig.transFigure``).

This new method may be useful for adding artists to figures without axes or to

easily position static elements in figure coordinates.

key=fixlist(args),fixitems(kwargs.items())

defadd_artist(self,artist,clip=False):

artist.set_figure(self)

self.artists.append(artist)

artist._remove_method=self.artists.remove

ifnotartist.is_transform_set():

artist.set_transform(self.transFigure)

ifclip:

artist.set_clip_path(self.patch)

self.stale=True

defadd_axes(self,*args,**kwargs):

frommatplotlib.testing.decoratorsimportimage_comparison

assertrepr(fig)=="<Figure size 100x200 with 0 Axes>"

deftest_add_artist():

fig,ax=plt.subplots(dpi=100)

l1=plt.Line2D([.2,.7], [.7,.7])

l2=plt.Line2D([.2,.7], [.8,.8])

r1=plt.Circle((20,20),100,transform=None)

r2=plt.Circle((.7,.5),.05)

r3=plt.Circle((4.5,.8),.55,transform=fig.dpi_scale_trans,

facecolor='crimson')

forain [l1,l2,r1,r2,r3]:

fig.add_artist(a)

l2.remove()

buf1=io.BytesIO()

fig.savefig(buf1)

fig2,ax2=plt.subplots(dpi=100)

l1=plt.Line2D([.2,.7], [.7,.7],transform=fig2.transFigure)

r1=plt.Circle((20,20),100,transform=None,clip_on=False,zorder=20)

r2=plt.Circle((.7,.5),.05,transform=fig2.transFigure)

r3=plt.Circle((4.5,.8),.55,transform=fig.dpi_scale_trans,

facecolor='crimson',clip_on=False,zorder=20)

forain [l1,r1,r2,r3]:

ax2.add_artist(a)

buf2=io.BytesIO()

fig2.savefig(buf2)

assertbuf1.getvalue()==buf2.getvalue()

deftest_fspath(fmt,tmpdir):