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

'off' or False

Hide all axis decorations, i.e. axis labels, spines, tick marks, tick labels, and grid lines. This is the same as set_axis_off().

'on' or True

Do not hide all axis decorations, i.e. axis labels, spines, tick marks, tick labels, and grid lines. This is the same as set_axis_on().

'equal'

Set equal scaling (i.e., make circles circular) by changing the 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.

Notes

For 3D axes, this method additionally takes zmin, zmax as parameters and likewise returns them.

Examples using matplotlib.axes.Axes.axis#

Filled polygon

Filled polygon

Clipping images with patches

Clipping images with patches

Bar of pie

Bar of pie

Hatch style reference

Hatch style reference

PathPatch object

PathPatch object

ggplot style sheet

ggplot style sheet

Parasite Simple2

Parasite Simple2

Simple Axisline4

Simple Axisline4

Axis Direction

Axis Direction

axis_direction demo

axis_direction demo

Axis line styles

Axis line styles

floating_axes features

floating_axes features

Parasite Axes demo

Parasite Axes demo

Parasite axis demo

Parasite axis demo

Ticklabel alignment

Ticklabel alignment

Ticklabel direction

Ticklabel direction

Simple axis direction

Simple axis direction

Simple axis tick label and tick directions

Simple axis tick label and tick directions

Simple Axis Pad

Simple Axis Pad

Custom spines with axisartist

Custom spines with axisartist

Simple Axisline

Simple Axisline

Simple Axisline3

Simple Axisline3

Packed-bubble chart

Packed-bubble chart

TickedStroke patheffect

TickedStroke patheffect

Ishikawa Diagram

Ishikawa Diagram

Quick start guide

Quick start guide

Specifying colors

Specifying colors

Text in Matplotlib

Text in Matplotlib