matplotlib.axes.Axes.set_ylim#

Axes.set_ylim(bottom=None, top=None, *, emit=True, auto=False, ymin=None, ymax=None)[source]#

Set the y-axis view limits.

Parameters:
bottomfloat, optional

The bottom ylim in data coordinates. Passing None leaves the limit unchanged.

The bottom and top ylims may also be passed as the tuple (bottom, top) as the first positional argument (or as the bottom keyword argument).

topfloat, optional

The top ylim in data coordinates. Passing None leaves the limit unchanged.

emitbool, default: True

Whether to notify observers of limit change.

autobool or None, default: False

Whether to turn on autoscaling of the y-axis. True turns on, False turns off, None leaves unchanged.

ymin, ymaxfloat, optional

They are equivalent to bottom and top respectively, and it is an error to pass both ymin and bottom or ymax and top.

Returns:
bottom, top(float, float)

The new y-axis limits in data coordinates.

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#

Broken Barh

Broken Barh

Broken Barh
EventCollection Demo

EventCollection Demo

EventCollection Demo
Hat graph

Hat graph

Hat graph
Markevery Demo

Markevery Demo

Markevery Demo
Psd Demo

Psd Demo

Psd Demo
Contouring the solution space of optimizations

Contouring the solution space of optimizations

Contouring the solution space of optimizations
Image Nonuniform

Image Nonuniform

Image Nonuniform
pcolormesh grids and shading

pcolormesh grids and shading

pcolormesh grids and shading
Axes Demo

Axes Demo

Axes Demo
Broken Axis

Broken Axis

Broken Axis
Figure labels: suptitle, supxlabel, supylabel

Figure labels: suptitle, supxlabel, supylabel

Figure labels: suptitle, supxlabel, supylabel
Zoom region inset axes

Zoom region inset axes

Zoom region inset axes
Boxplots

Boxplots

Boxplots
AnnotationBbox demo

AnnotationBbox demo

AnnotationBbox demo
Using a text as a Path

Using a text as a Path

Using a text as a Path
Annotate Transform

Annotate Transform

Annotate Transform
Annotating a plot

Annotating a plot

Annotating a plot
Line, Poly and RegularPoly Collection with autoscaling

Line, Poly and RegularPoly Collection with autoscaling

Line, Poly and RegularPoly Collection with autoscaling
Mmh Donuts!!!

Mmh Donuts!!!

Mmh Donuts!!!
Ellipse Demo

Ellipse Demo

Ellipse Demo
Line Collection

Line Collection

Line Collection
Inset Locator Demo2

Inset Locator Demo2

Inset Locator Demo2
Parasite Simple2

Parasite Simple2

Parasite Simple2
axis_direction demo

axis_direction demo

axis_direction demo
Parasite Axes demo

Parasite Axes demo

Parasite Axes demo
Parasite axis demo

Parasite axis demo

Parasite axis demo
Simple Axis Pad

Simple Axis Pad

Simple Axis Pad
Simple Axisline

Simple Axisline

Simple Axisline
Anatomy of a figure

Anatomy of a figure

Anatomy of a figure
Integral as the area under a curve

Integral as the area under a curve

Integral as the area under a curve
XKCD

XKCD

XKCD
Decay

Decay

Decay
Animated histogram

Animated histogram

Animated histogram
Rain simulation

Rain simulation

Rain simulation
MATPLOTLIB **UNCHAINED**

MATPLOTLIB UNCHAINED

MATPLOTLIB **UNCHAINED**
Data Browser

Data Browser

Data Browser
Path Editor

Path Editor

Path Editor
Pick Event Demo2

Pick Event Demo2

Pick Event Demo2
Poly Editor

Poly Editor

Poly Editor
Zoom Window

Zoom Window

Zoom Window
Custom projection

Custom projection

Custom projection
Building histograms using Rectangles and PolyCollections

Building histograms using Rectangles and PolyCollections

Building histograms using Rectangles and PolyCollections
Pythonic Matplotlib

Pythonic Matplotlib

Pythonic Matplotlib
SVG Filter Line

SVG Filter Line

SVG Filter Line
TickedStroke patheffect

TickedStroke patheffect

TickedStroke patheffect
Plot 2D data on 3D plot

Plot 2D data on 3D plot

Plot 2D data on 3D plot
Draw flat objects in 3D plot

Draw flat objects in 3D plot

Draw flat objects in 3D plot
Text annotations in 3D

Text annotations in 3D

Text annotations in 3D
Asinh Demo

Asinh Demo

Asinh Demo
Loglog Aspect

Loglog Aspect

Loglog Aspect
Log Demo

Log Demo

Log Demo
MRI with EEG

MRI with EEG

MRI with EEG
SkewT-logP diagram: using transforms and custom projections

SkewT-logP diagram: using transforms and custom projections

SkewT-logP diagram: using transforms and custom projections
Multiple Yaxis With Spines

Multiple Yaxis With Spines

Multiple Yaxis With Spines
Custom spine bounds

Custom spine bounds

Custom spine bounds
Annotation with units

Annotation with units

Annotation with units
Artist tests

Artist tests

Artist tests
Annotate Text Arrow

Annotate Text Arrow

Annotate Text Arrow
Connect Simple01

Connect Simple01

Connect Simple01
Annotated Cursor

Annotated Cursor

Annotated Cursor
Cursor

Cursor

Cursor
Span Selector

Span Selector

Span Selector
Quick start guide

Quick start guide

Quick start guide
Path Tutorial

Path Tutorial

Path Tutorial
Transformations Tutorial

Transformations Tutorial

Transformations Tutorial
Specifying Colors

Specifying Colors

Specifying Colors
Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib

Choosing Colormaps in Matplotlib