adds section on annotating an artist using axes.annotate

story645 · story645 · commit 9bd3c1e4cd57 · 2023-01-27T16:19:47.000-05:00
diff --git a/tutorials/text/annotations.py b/tutorials/text/annotations.py
@@ -92,6 +92,26 @@
 
 # %%
 #
+# Annotating an Artist
+# ~~~~~~~~~~~~~~~~~~~~
+#
+# Annotations can be positioned relative to an artist by passing the artist
+# in as *xycoords*. Then *xy* is interpreted as a fraction of the artist's
+# boundingbox.
+
+import matplotlib.patches as mpatches
+
+fig, ax = plt.subplots(figsize=(3, 3))
+arr = mpatches.FancyArrowPatch((.25, .25), (.75, .75),
+                               arrowstyle='->,head_width=.15', mutation_scale=20)
+ax.add_patch(arr)
+ax.annotate("label", (.25, .25), xycoords=arr, ha='center', va='center')
+ax.set(xlim=(0, 1), ylim=(0, 1))
+
+# %%
+# Here the annotion is placed at position (.25,.25) relative to the arrow's
+# lower left corner and is vertically and horzintally centered at that position.
+#
 # .. _annotation-with-arrow:
 #
 # Annotating with arrows
