matplotlib.pyplot.axes — Matplotlib 3.10.1 documentation (original) (raw)
matplotlib.pyplot.axes(arg=None, **kwargs)[source]#
Add an Axes to the current figure and make it the current Axes.
Call signatures:
plt.axes() plt.axes(rect, projection=None, polar=False, **kwargs) plt.axes(ax)
Parameters:
argNone or 4-tuple
The exact behavior of this function depends on the type:
- None: A new full window Axes is added using
subplot(**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.
projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optional
The projection type of the Axes. str is the name of a custom projection, see projections. The default None results in a 'rectilinear' projection.
polarbool, default: False
If True, equivalent to projection='polar'.
sharex, shareyAxes, optional
Share the x or y axis with sharex and/or sharey. The axis will have the same limits, ticks, and scale as the axis of the shared Axes.
labelstr
A label for the returned Axes.
Returns:
The returned Axes class depends on the projection used. It isAxes if rectilinear projection is used andprojections.polar.PolarAxes if polar projection is used.
Other Parameters:
**kwargs
This method also takes the keyword arguments for the returned Axes class. The keyword arguments for the rectilinear Axes class Axes can be found in the following table but there might also be other keyword arguments if another projection is used, see the actual Axes class.
Examples
Creating a new full window Axes
plt.axes()
Creating a new Axes with specified dimensions and a grey background
plt.axes((left, bottom, width, height), facecolor='grey')