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.post1695+gedd053d16
matplotlib
Fork me on GitHub

Table Of Contents

matplotlib.pyplot.yticks

matplotlib.pyplot.yticks(ticks=None, labels=None, **kwargs)[source]

Get or set the current tick locations and labels of the y-axis.

Call signatures:

locs, labels = yticks()           # Get locations and labels

yticks(ticks, [labels], **kwargs)  # Set locations and labels
Parameters:
ticks : array_like

A list of positions at which ticks should be placed. You can pass an empty list to disable yticks.

labels : array_like, optional

A list of explicit labels to place at the given locs.

**kwargs

Text properties can be used to control the appearance of the labels.

Returns:
locs

An array of label locations.

labels

A list of Text objects.

Notes

Calling this function with no arguments (e.g. yticks()) is the pyplot equivalent of calling get_yticks and get_yticklabels on the current axes. Calling this function with arguments is the pyplot equivalent of calling set_yticks and set_yticklabels on the current axes.

Examples

Get the current locations and labels:

>>> locs, labels = yticks()

Set label locations:

>>> yticks(np.arange(0, 1, step=0.2))

Set text labels:

>>> yticks(np.arange(5), ('Tom', 'Dick', 'Harry', 'Sally', 'Sue'))

Set text labels and properties:

>>> yticks(np.arange(12), calendar.month_name[1:13], rotation=45)

Disable yticks:

>>> yticks([])