You are reading an old version of the documentation (v3.1.3). For the latest version see https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.add_artist.html
Version 3.1.3
matplotlib
Fork me on GitHub

Table of Contents

matplotlib.axes.Axes.add_artist

Axes.add_artist(self, a)

Add an Artist to the axes, and return the artist.

Use add_artist only for artists for which there is no dedicated "add" method; and if necessary, use a method such as update_datalim to manually update the dataLim if the artist is to be included in autoscaling.

If no transform has been specified when creating the artist (e.g. artist.get_transform() == None) then the transform is set to ax.transData.