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

Table Of Contents


matplotlib.pyplot.ylim(*args, **kwargs)[source]

Get or set the y-limits of the current axes.

Call signatures:

ymin, ymax = ylim()  # return the current ylim
ylim((ymin, ymax))   # set the ylim to ymin, ymax
ylim(ymin, ymax)     # set the ylim to ymin, ymax

If you do not specify args, you can alternatively pass ymin or ymax as kwargs, i.e.:

ylim(ymax=3)  # adjust the max leaving min unchanged
ylim(ymin=1)  # adjust the min leaving max unchanged

Setting limits turns autoscaling off for the y-axis.

ymin, ymax

A tuple of the new y-axis limits.


Calling this function with no arguments (e.g. ylim()) is the pyplot equivalent of calling get_ylim on the current axes. Calling this function with arguments is the pyplot equivalent of calling set_ylim on the current axes. All arguments are passed though.