Hello, I would like to work with that issue. However, I think I did not completely understand your idea, it is to draw the angles in the image to make it more clear, like in your sugestion?

Exactly, a

1. new gallery example (this may end up appended to an existing example, but easier if you start it new)
2. that looks like the bracket example from what's new
3. where the angle argument is annotated like in the scale invariant angle

@story645 Something like this?

Yup, except the angle is always between the brace and the perpendicular

I see, but I'm unsure how I would do that with matplotlib

I think by importing the ArcAnnotation class from the scale invariant example (you can cross link in the text) and using that to label the angles. I think the perpendicular can be drawn using either vlines or plot.

Ok, thanks. I'll see this tomorrow

I successfully created the lines using vlines() but I can't do the same with Arc()

Hi @story645, can I contribute to this issue? Is this what you are looking for:

That looks great! Go for it!!!

Bonus: Maybe add an arrow head to the grey arc to indicate the angle direction (from the blue line to the bracket)?

Sure thing @timhoffm, I'll look into that.

Hi @timhoffm, I looked at a few ways of adding the arrows.

One way is to simply add a FancyArrowPatch to the plot (as shown below), but this won't be scale invariant.

Secondly, I added an arrow annotation to AngleAnnotation (similar to the text annotation):

self.arrow = ax.annotate("", xy=(0.5, 0.5), xytext=(0, 0), arrowprops=arrowprops, **self.kw)

I then tried to update it's position at plot time. I can easily set self.arrow.yx (similar to self.text.xy) but can't access the xytext variable (arrow._arrow_relpos I believe) to tell the updated arrow where to point from.

Is it possible to set this during plot time, and if not do you have any other suggestions? Am I on the right track or is the FancyArrowPatch solution fine?

The FancyArrowPatch is fine here. This is mainly used as a static illustration in the docs. Scale invariance is not important.

Hi @timhoffm or @story645 is there a way to import the AngleAnnotation code from examples/text_labels_and_annotations/angle_annotation.py into whats-new-3-4-0.rst? I've read through the contribution guide and can't find an example of this. Thanks, ready to submit the PR then.

I was thinking this becomes a gallery example w/ the other annotation examples and is then linked to at the bottom of https://matplotlib.org/devdocs/api/_as_gen/matplotlib.patches.ArrowStyle.html#matplotlib.patches.ArrowStyle in the way that examples are linked in https://matplotlib.org/devdocs/api/_as_gen/matplotlib.patches.Arrow.html

Then you also should be able to import the code since it'll be in the same folder.

Ok thanks for the guidance @story645, first contributor here so a lot to learn 👌🏻😁 Appreciate it.

Should I delete the PR?

Absolutely not! Please just update the PR by restoring the what's new, creating a new example, and updating the arrow style docstrings to point to the example https://sphinx-gallery.github.io/stable/configuration.html#add-mini-galleries-for-api-documentation