### Navigation

- index
- modules |
- next |
- previous |
- home|
- examples|
- tutorials|
- pyplot|
- docs »
- The Matplotlib API »
- `Axes` class »

# 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).
  Returns: | 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)

## Examples using `matplotlib.axes.Axes.set_ylim`

Custom projection