You are reading documentation for the unreleased version of Matplotlib. Try searching for the released version of this page instead?
Version 3.1.0.post1496+gb03370a04
matplotlib
Fork me on GitHub

matplotlib.pyplot.locator_params

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

Control behavior of major tick locators.

Because the locator is involved in autoscaling, autoscale_view is called automatically after the parameters are changed.

Parameters:
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:
**kwargs

Remaining keyword arguments are passed to directly to the set_params() method of the locator. Supported keywords depend on the type of the locator. See for example set_params for the ticker.MaxNLocator used by default for linear axes.

Examples

When plotting small subplots, one might want to reduce the maximum number of ticks and use tight bounds, for example:

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