You are reading an old version of the documentation (v2.0.1). For the latest version see https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.set_ylim.html

Travis-CI:

# matplotlib.axes.Axes.set_ylim¶

`Axes.``set_ylim`(bottom=None, top=None, emit=True, auto=False, **kw)

Set the data limits for the y-axis

Parameters: bottom : scalar, optional The bottom ylim (default: None, which leaves the bottom limit unchanged). top : scalar, optional The top ylim (default: None, which leaves the top 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 y-axis. True turns on, False turns off (default action), None leaves unchanged. ylimits : tuple, optional The bottom and top yxlims may be passed as the tuple (`bottom`, `top`) as the first positional argument (or as the `bottom` keyword argument). ylimits : tuple Returns the new y-axis limits as (`bottom`, `top`).

Notes

The `bottom` value may be greater than the `top` value, in which case the y-axis values will decrease from bottom to top.

Examples

```>>> set_ylim(bottom, top)
>>> set_ylim((bottom, top))
>>> bottom, top = set_ylim(bottom, top)
```

One limit may be left unchanged.

```>>> set_ylim(top=top_lim)
```

Limits may be passed in reverse order to flip the direction of the y-axis. For example, suppose `y` represents depth of the ocean in m. The y-axis limits might be set like the following so 5000 m depth is at the bottom of the plot and the surface, 0 m, is at the top.

```>>> set_ylim(5000, 0)
```