"""

================

Annotation Polar

================

This example shows how to create an annotation on a polar graph.

For a complete overview of the annotation capabilities, also see the

:doc:`annotation tutorial</tutorials/text/annotations>`.

"""

import numpy as np

import matplotlib.pyplot as plt

fig = plt.figure()

ax = fig.add_subplot(111, polar=True)

r = np.arange(0,1,0.001)

theta = 2 * 2*np.pi * r

line, = ax.plot(theta, r, color='#ee8d18', lw=3)

ind = 800

thisr, thistheta = r[ind], theta[ind]

ax.plot([thistheta], [thisr], 'o')

ax.annotate('a polar annotation',

xy=(thistheta, thisr), # theta, radius

xytext=(0.05, 0.05), # fraction, fraction

textcoords='figure fraction',

arrowprops=dict(facecolor='black', shrink=0.05),

horizontalalignment='left',

verticalalignment='bottom',

)

plt.show()

#############################################################################

#

# ------------

#

# References

# """"""""""

#

# The use of the following functions, methods, classes and modules is shown

# in this example:

import matplotlib

matplotlib.projections.polar

matplotlib.axes.Axes.annotate

matplotlib.pyplot.annotate