You are reading an old version of the documentation (v2.2.2). For the latest version see
Version 2.2.2
Fork me on GitHub

Table Of Contents


Axes.set_xlim(left=None, right=None, emit=True, auto=False, **kw)

Set the data limits for the x-axis

left : scalar, optional

The left xlim (default: None, which leaves the left limit unchanged).

right : scalar, optional

The right xlim (default: None, which leaves the right limit unchanged).

emit : bool, optional

Whether to notify observers of limit change (default: True).

auto : bool or None, optional

Whether to turn on autoscaling of the x-axis. True turns on, False turns off (default action), None leaves unchanged.

xlimits : tuple, optional

The left and right xlims may be passed as the tuple (left, right) as the first positional argument (or as the left keyword argument).

xlimits : tuple

Returns the new x-axis limits as (left, right).


The left value may be greater than the right value, in which case the x-axis values will decrease from left to right.


>>> set_xlim(left, right)
>>> set_xlim((left, right))
>>> left, right = set_xlim(left, right)

One limit may be left unchanged.

>>> set_xlim(right=right_lim)

Limits may be passed in reverse order to flip the direction of the x-axis. For example, suppose x represents the number of years before present. The x-axis limits might be set like the following so 5000 years ago is on the left of the plot and the present is on the right.

>>> set_xlim(5000, 0)

Examples using matplotlib.axes.Axes.set_xlim