Merge pull request #29819 from meeseeksmachine/auto-backport-of-pr-29801-on-v3.10.1-doc

QuLogic · web-flow · commit f0322e96e166 · 2025-03-27T22:54:43.000-04:00
Backport PR #29801 on branch v3.10.1-doc (DOC: Slightly further improve arrowstyle demo)
diff --git a/galleries/examples/text_labels_and_annotations/fancyarrow_demo.py b/galleries/examples/text_labels_and_annotations/fancyarrow_demo.py
@@ -3,7 +3,11 @@
 Annotation arrow style reference
 ================================
 
-Overview of the arrow styles available in `~.Axes.annotate`.
+Overview of the available `.ArrowStyle` settings. These are used for the *arrowstyle*
+parameter of `~.Axes.annotate` and `.FancyArrowPatch`.
+
+Each style can be configured with a set of parameters, which are stated along with
+their default values.
 """
 
 import inspect
@@ -12,38 +16,38 @@
 
 import matplotlib.pyplot as plt
 
-import matplotlib.patches as mpatches
+from matplotlib.patches import ArrowStyle
 
-styles = mpatches.ArrowStyle.get_styles()
+styles = ArrowStyle.get_styles()
 ncol = 2
 nrow = (len(styles) + 1) // ncol
-axs = (plt.figure(figsize=(4 * ncol, 1 + nrow))
-       .add_gridspec(1 + nrow, ncol,
-                     wspace=0, hspace=0, left=0, right=1, bottom=0, top=1).subplots())
+gridspec_kw = dict(wspace=0, hspace=0.05, left=0, right=1, bottom=0, top=1)
+fig, axs = plt.subplots(1 + nrow, ncol,
+                        figsize=(4 * ncol, 1 + nrow), gridspec_kw=gridspec_kw)
 for ax in axs.flat:
-    ax.set_xlim(-0.5, 4)
+    ax.set_xlim(-0.1, 4)
     ax.set_axis_off()
 for ax in axs[0, :]:
-    ax.text(-0.25, 0.5, "arrowstyle", size="large", color="tab:blue")
-    ax.text(1.25, .5, "default parameters", size="large")
+    ax.text(0, 0.5, "arrowstyle", size="large", color="tab:blue")
+    ax.text(1.4, .5, "default parameters", size="large")
 for ax, (stylename, stylecls) in zip(axs[1:, :].T.flat, styles.items()):
     # draw dot and annotation with arrowstyle
-    l, = ax.plot(1, 0, "o", color="grey")
-    ax.annotate(stylename, (1, 0), (0, 0),
-                size="large", color="tab:blue", ha="center", va="center",
+    l, = ax.plot(1.25, 0, "o", color="darkgrey")
+    ax.annotate(stylename, (1.25, 0), (0, 0),
+                size="large", color="tab:blue", va="center", family="monospace",
                 arrowprops=dict(
-                    arrowstyle=stylename, connectionstyle="arc3,rad=-0.05",
-                    color="k", shrinkA=5, shrinkB=5, patchB=l,
+                    arrowstyle=stylename, connectionstyle="arc3,rad=0",
+                    color="black", shrinkA=5, shrinkB=5, patchB=l,
                 ),
-                bbox=dict(boxstyle="square", fc="w", ec="grey"))
+                bbox=dict(boxstyle="square", fc="w", ec="darkgrey"))
     # draw default parameters
     # wrap at every nth comma (n = 1 or 2, depending on text length)
     s = str(inspect.signature(stylecls))[1:-1]
     n = 2 if s.count(',') > 3 else 1
-    ax.text(1.25, 0,
+    ax.text(1.4, 0,
             re.sub(', ', lambda m, c=itertools.count(1): m.group()
                    if next(c) % n else '\n', s),
-            verticalalignment="center")
+            verticalalignment="center", color="0.3")
 
 plt.show()
 
