matplotlib.pyplot.axes

matplotlib.pyplot.axes(arg=None, **kwargs)

Add an axes to the current figure and make it the current axes.

Parameters:

arg : None or 4-tuple or Axes

The exact behavior of this function depends on the type:

• None: A new full window axes is added using subplot(111, **kwargs)

• 4-tuple of floats rect = [left, bottom, width, height]. A new axes is added with dimensions rect in normalized (0, 1) units using add_axes on the current figure.

• Axes: This is equivalent to pyplot.sca. It sets the current axes to arg. Note: This implicitly changes the current figure to the parent of arg.

  Note

  The use of an Axes as an argument is deprecated and will be removed in v3.0. Please use pyplot.sca instead.

Returns:

axes : Axes

The created or activated axes.

Other Parameters:

**kwargs :

For allowed keyword arguments see pyplot.subplot and Figure.add_axes respectively. Some common keyword arguments are listed below:

kwarg	Accepts	Description
facecolor	color	the axes background color
frameon	bool	whether to display the frame
sharex	otherax	share x-axis with otherax
sharey	otherax	share y-axis with otherax
polar	bool	whether to use polar axes
aspect	[str | num]	['equal', 'auto'] or a number. If a number, the ratio of y-unit/x-unit in screen-space. See also set_aspect.

Examples

Creating a new full window axes:

>>> plt.axes()

Creating a new axes with specified dimensions and some kwargs:

>>> plt.axes((left, bottom, width, height), facecolor='w')

Examples using matplotlib.pyplot.axes

Subplots Adjust

Axes Demo

Scatter Hist

Arrow Simple Demo

Mathtext Examples

Demo Axes Hbox Divider

Make Room For Ylabel Using Axesgrid

Lasso Demo

Tight Bbox Test

Textbox

Check Buttons

Buttons

Radio Buttons

Slider Demo