You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Applications are open for the 2018 John Hunter Matplotlib Summer Fellowship. Apply now!
Version 2.2.2.post1772+gd9240e24b
Fork me on GitHub


matplotlib.pyplot.autoscale(enable=True, axis='both', tight=None)[source]

Autoscale the axis view to the data (toggle).

Convenience method for simple axis view autoscaling. It turns autoscaling on or off, and then, if autoscaling for either axis is on, it performs the autoscaling on the specified axis or axes.

enable : bool or None, optional

True (default) turns autoscaling on, False turns it off. None leaves the autoscaling state unchanged.

axis : {'both', 'x', 'y'}, optional

which axis to operate on; default is 'both'

tight: bool or None, optional

If True, set view limits to data limits; if False, let the locator and margins expand the view limits; if None, use tight scaling if the only artist is an image, otherwise treat tight as False. The tight setting is retained for future autoscaling until it is explicitly changed.