Update diagram in subplots_adjust documentation to clarify parameter meaning

ellie · ellie · commit ac5225483f9b · 2025-05-09T01:06:30.000+01:00
diff --git a/doc/_embedded_plots/figure_subplots_adjust.py b/doc/_embedded_plots/figure_subplots_adjust.py
@@ -1,28 +1,30 @@
 import matplotlib.pyplot as plt
 
-
 def arrow(p1, p2, **props):
-    axs[0, 0].annotate(
-        "", p1, p2,  xycoords='figure fraction',
+    overlay.annotate(
+        "", p1, p2, xycoords='figure fraction',
         arrowprops=dict(arrowstyle="<->", shrinkA=0, shrinkB=0, **props))
 
-
 fig, axs = plt.subplots(2, 2, figsize=(6.5, 4))
 fig.set_facecolor('lightblue')
 fig.subplots_adjust(0.1, 0.1, 0.9, 0.9, 0.4, 0.4)
+
+overlay = fig.add_axes([0, 0, 1, 1], zorder=100)
+overlay.axis("off")
+
 for ax in axs.flat:
     ax.set(xticks=[], yticks=[])
 
 arrow((0, 0.75), (0.1, 0.75))  # left
-arrow((0.435, 0.75), (0.565, 0.75))  # wspace
-arrow((0.9, 0.75), (1, 0.75))  # right
+arrow((0.435, 0.25), (0.565, 0.25))  # wspace
+arrow((0.1, 0.8), (1, 0.8))  # right
 fig.text(0.05, 0.7, "left", ha="center")
-fig.text(0.5, 0.7, "wspace", ha="center")
-fig.text(0.95, 0.7, "right", ha="center")
+fig.text(0.5, 0.3, "wspace", ha="center")
+fig.text(0.95, 0.83, "right", ha="center")
 
-arrow((0.25, 0), (0.25, 0.1))  # bottom
+arrow((0.75, 0), (0.75, 0.1))  # bottom
 arrow((0.25, 0.435), (0.25, 0.565))  # hspace
-arrow((0.25, 0.9), (0.25, 1))  # top
-fig.text(0.28, 0.05, "bottom", va="center")
+arrow((0.80, 0.1), (0.8, 1))  # top
+fig.text(0.65, 0.05, "bottom", va="center")
 fig.text(0.28, 0.5, "hspace", va="center")
-fig.text(0.28, 0.95, "top", va="center")
+fig.text(0.75, 0.95, "top", va="center")
