From 17cd3631a3c3ff94079b40bb4adfe5e2206c5a6a Mon Sep 17 00:00:00 2001 From: Thomas A Caswell Date: Tue, 3 Jun 2014 11:54:53 -0400 Subject: [PATCH] DOC : clarified doc of add_artist Added note about add_artist not automatically updating the data limits used by the auto-scaling. --- lib/matplotlib/axes/_base.py | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py index a1f25f9f9920..bc5d9c884bfe 100644 --- a/lib/matplotlib/axes/_base.py +++ b/lib/matplotlib/axes/_base.py @@ -1423,8 +1423,12 @@ def has_data(self): len(self.patches)) > 0 def add_artist(self, a): - """ - Add any :class:`~matplotlib.artist.Artist` to the axes. + """Add any :class:`~matplotlib.artist.Artist` to the axes. + + Use `add_artist` only for artists for which there is no dedicated + "add" method; and if necessary, use a method such as + `update_datalim` or `update_datalim_numerix` to manually update the + dataLim if the artist is to be included in autoscaling. Returns the artist. """