Add a child inset Axes to this existing Axes.

Parameters¶

bounds[x0, y0, width, height]

Lower-left corner of inset Axes, and its width and height.

transform.Transform

Defaults to ax.transAxes, i.e. the units of rect are in Axes-relative coordinates.

projection{None, ‘aitoff’, ‘hammer’, ‘lambert’, ‘mollweide’, ‘polar’, ‘rectilinear’, str}, optional

The projection type of the inset ~.axes.Axes. str is the name of a custom projection, see ~matplotlib.projections. The default None results in a ‘rectilinear’ projection.

polarbool, default: False

If True, equivalent to projection=’polar’.

axes_classsubclass type of ~.axes.Axes, optional

The .axes.Axes subclass that is instantiated. This parameter is incompatible with projection and polar. See axisartist_users-guide-index for examples.

zordernumber

Defaults to 5 (same as .Axes.legend). Adjust higher or lower to change whether it is above or below data plotted on the parent Axes.

**kwargs

Other keyword arguments are passed on to the inset Axes class.

Returns¶

ax

The created ~.axes.Axes instance.

Examples¶

This example makes two inset Axes, the first is in Axes-relative coordinates, and the second in data-coordinates:

fig, ax = plt.subplots()
ax.plot(range(10))
axin1 = ax.inset_axes([0.8, 0.1, 0.15, 0.15])
axin2 = ax.inset_axes(
        [5, 7, 2.3, 2.3], transform=ax.transData)