matplotlib.axes.Axes.axis#

Axes.axis(arg=None, /, *, emit=True, **kwargs)[source]#

Convenience method to get or set some axis properties.

Call signatures:

xmin, xmax, ymin, ymax = axis()
xmin, xmax, ymin, ymax = axis([xmin, xmax, ymin, ymax])
xmin, xmax, ymin, ymax = axis(option)
xmin, xmax, ymin, ymax = axis(**kwargs)
Parameters:
xmin, xmax, ymin, ymaxfloat, optional

The axis limits to be set. This can also be achieved using

ax.set(xlim=(xmin, xmax), ylim=(ymin, ymax))
optionbool or str

If a bool, turns axis lines and labels on or off. If a string, possible values are:

Value

Description

'on'

Turn on axis lines and labels. Same as True.

'off'

Turn off axis lines and labels. Same as False.

'equal'

Set equal scaling (i.e., make circles circular) by changing axis limits. This is the same as ax.set_aspect('equal', adjustable='datalim'). Explicit data limits may not be respected in this case.

'scaled'

Set equal scaling (i.e., make circles circular) by changing dimensions of the plot box. This is the same as ax.set_aspect('equal', adjustable='box', anchor='C'). Additionally, further autoscaling will be disabled.

'tight'

Set limits just large enough to show all data, then disable further autoscaling.

'auto'

Automatic scaling (fill plot box with data).

'image'

'scaled' with axis limits equal to data limits.

'square'

Square plot; similar to 'scaled', but initially forcing xmax-xmin == ymax-ymin.

emitbool, default: True

Whether observers are notified of the axis limit change. This option is passed on to set_xlim and set_ylim.

Returns:
xmin, xmax, ymin, ymaxfloat

The axis limits.

Examples using matplotlib.axes.Axes.axis#

Clipping images with patches

Clipping images with patches

Clipping images with patches
Basic pie chart

Basic pie chart

Basic pie chart
Bar of pie

Bar of pie

Bar of pie
Hatch style reference

Hatch style reference

Hatch style reference
PathPatch object

PathPatch object

PathPatch object
ggplot style sheet

ggplot style sheet

ggplot style sheet
Parasite Simple2

Parasite Simple2

Parasite Simple2
Simple Axisline4

Simple Axisline4

Simple Axisline4
Axis Direction

Axis Direction

Axis Direction
axis_direction demo

axis_direction demo

axis_direction demo
Axis line styles

Axis line styles

Axis line styles
``floating_axes`` features

floating_axes features

``floating_axes`` features
Parasite Axes demo

Parasite Axes demo

Parasite Axes demo
Parasite axis demo

Parasite axis demo

Parasite axis demo
Ticklabel alignment

Ticklabel alignment

Ticklabel alignment
Ticklabel direction

Ticklabel direction

Ticklabel direction
Simple Axis Direction01

Simple Axis Direction01

Simple Axis Direction01
Simple Axis Direction03

Simple Axis Direction03

Simple Axis Direction03
Simple Axis Pad

Simple Axis Pad

Simple Axis Pad
Custom spines with axisartist

Custom spines with axisartist

Custom spines with axisartist
Simple Axisline

Simple Axisline

Simple Axisline
Simple Axisline3

Simple Axisline3

Simple Axisline3
Packed-bubble chart

Packed-bubble chart

Packed-bubble chart
TickedStroke patheffect

TickedStroke patheffect

TickedStroke patheffect
===

MRI

===
MRI with EEG

MRI with EEG

MRI with EEG
Quick start guide

Quick start guide

Quick start guide
Specifying colors

Specifying colors

Specifying colors
Text in Matplotlib Plots

Text in Matplotlib Plots

Text in Matplotlib Plots