matplotlib.pyplot.xticks — Matplotlib 3.10.1 documentation (original) (raw)
matplotlib.pyplot.xticks(ticks=None, labels=None, *, minor=False, **kwargs)[source]#
Get or set the current tick locations and labels of the x-axis.
Pass no arguments to return the current values without modifying them.
Parameters:
ticksarray-like, optional
The list of xtick locations. Passing an empty list removes all xticks.
labelsarray-like, optional
The labels to place at the given ticks locations. This argument can only be passed if ticks is passed as well.
minorbool, default: False
If False, get/set the major ticks/labels; if True, the minor ticks/labels.
**kwargs
Text properties can be used to control the appearance of the labels.
Warning
This only sets the properties of the current ticks, which is only sufficient if you either pass ticks, resulting in a fixed list of ticks, or if the plot is static.
Ticks are not guaranteed to be persistent. Various operations can create, delete and modify the Tick instances. There is an imminent risk that these settings can get lost if you work on the figure further (including also panning/zooming on a displayed figure).
Use tick_params instead if possible.
Returns:
locs
The list of xtick locations.
labels
The list of xlabel Text objects.
Notes
Calling this function with no arguments (e.g. xticks()) is the pyplot equivalent of calling get_xticks and get_xticklabels on the current Axes. Calling this function with arguments is the pyplot equivalent of callingset_xticks and set_xticklabels on the current Axes.
Examples
locs, labels = xticks() # Get the current locations and labels. xticks(np.arange(0, 1, step=0.2)) # Set label locations. xticks(np.arange(3), ['Tom', 'Dick', 'Sue']) # Set text labels. xticks([0, 1, 2], ['January', 'February', 'March'], ... rotation=20) # Set text labels and properties. xticks([]) # Disable xticks.