You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 2.1.1.post1076+g937889f
Fork me on GitHub

This Page


matplotlib.pyplot.locator_params(axis='both', tight=None, **kwargs)

Control behavior of tick locators.


axis : [‘both’ | ‘x’ | ‘y’], optional

The axis on which to operate.

tight : bool or None, optional

Parameter passed to autoscale_view(). Default is None, for no change.

Other Parameters:

**kw :

Remaining keyword arguments are passed to directly to the set_params() method.

Typically one might want to reduce the maximum number

of ticks and use tight bounds when plotting small

subplots, for example::

ax.locator_params(tight=True, nbins=4)

Because the locator is involved in autoscaling,

:meth:`autoscale_view` is called automatically after

the parameters are changed.

This presently works only for the

:class:`~matplotlib.ticker.MaxNLocator` used

by default on linear axes, but it may be generalized.