Merge pull request matplotlib#30479 from anntzer/ilia

Clarify inset_locator.inset_axes demo.

Author: timhoffm

galleries/examples/axes_grid1/demo_colorbar_with_inset_locator.py

@@ -1,17 +1,17 @@
 """
 .. _demo-colorbar-with-inset-locator:
 
-===========================================================
-Control the position and size of a colorbar with Inset Axes
-===========================================================
+=========================================================================
+Control the position and size of a colorbar with inset_locator.inset_axes
+=========================================================================
 
 This example shows how to control the position, height, and width of colorbars
-using `~mpl_toolkits.axes_grid1.inset_locator.inset_axes`.
+using `.inset_locator.inset_axes`.
 
-Inset Axes placement is controlled as for legends: either by providing a *loc*
-option ("upper right", "best", ...), or by providing a locator with respect to
-the parent bbox.  Parameters such as *bbox_to_anchor* and *borderpad* likewise
-work in the same way, and are also demonstrated here.
+`.inset_locator.inset_axes` placement is controlled as for legends: either
+by providing a *loc* option ("upper right", "best", ...), or by providing a
+locator with respect to the parent bbox.  Parameters such as *bbox_to_anchor*
+and *borderpad* likewise work in the same way, and are also demonstrated here.
 
 Users should consider using `.Axes.inset_axes` instead (see
 :ref:`colorbar_placement`).
@@ -21,12 +21,12 @@
 
 import matplotlib.pyplot as plt
 
-from mpl_toolkits.axes_grid1.inset_locator import inset_axes
+from mpl_toolkits.axes_grid1 import inset_locator
 
 fig, (ax1, ax2) = plt.subplots(1, 2, figsize=[6, 3])
 
 im1 = ax1.imshow([[1, 2], [2, 3]])
-axins1 = inset_axes(
+axins1 = inset_locator.inset_axes(
     ax1,
     width="50%",  # width: 50% of parent_bbox width
     height="5%",  # height: 5%
@@ -36,7 +36,7 @@
 fig.colorbar(im1, cax=axins1, orientation="horizontal", ticks=[1, 2, 3])
 
 im = ax2.imshow([[1, 2], [2, 3]])
-axins = inset_axes(
+axins = inset_locator.inset_axes(
     ax2,
     width="5%",  # width: 5% of parent_bbox width
     height="50%",  # height: 50%