matplotlib.figure.Figure.add_axes — Matplotlib 3.10.3 documentation (original) (raw)
Figure.add_axes(*args, **kwargs)[source]#
Add an Axes to the figure.
Call signatures:
add_axes(rect, projection=None, polar=False, **kwargs) add_axes(ax)
Parameters:
recttuple (left, bottom, width, height)
The dimensions (left, bottom, width, height) of the newAxes. All quantities are in fractions of figure width and height.
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'.
axes_classsubclass type of Axes, optional
The axes.Axes subclass that is instantiated. This parameter is incompatible with projection and polar. Seeaxisartist for examples.
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.
Notes
In rare circumstances, add_axes may be called with a single argument, an Axes instance already created in the present figure but not in the figure's list of Axes.
Examples
Some simple examples:
rect = l, b, w, h fig = plt.figure() fig.add_axes(rect) fig.add_axes(rect, frameon=False, facecolor='g') fig.add_axes(rect, polar=True) ax = fig.add_axes(rect, projection='polar') fig.delaxes(ax) fig.add_axes(ax)