. xycoords : single or two-tuple of str or `.Artist` or `.Transform` or callable, default: 'data' The coordinate system that *xy* is given in. The following types of values are supported: - One of the following strings: ==================== ============================================ Value Description ==================== ============================================ 'figure points' Points from the lower left of the figure 'figure pixels' Pixels from the lower left of the figure 'figure fraction' Fraction of figure from lower left 'subfigure points' Points from the lower left of the subfigure 'subfigure pixels' Pixels from the lower left of the subfigure 'subfigure fraction' Fraction of subfigure from lower left 'axes points' Points from lower left corner of axes 'axes pixels' Pixels from lower left corner of axes 'axes fraction' Fraction of axes from lower left 'data' Use the coordinate system of the object being annotated (default) 'polar' *(theta, r)* if not native 'data' coordinates ==================== ============================================ Note that 'subfigure pixels' and 'figure pixels' are the same for the parent figure, so users who want code that is usable in a subfigure can use 'subfigure pixels'. - An `.Artist`: *xy* is interpreted as a fraction of the artist's `~matplotlib.transforms.Bbox`. E.g. *(0, 0)* would be the lower left corner of the bounding box and *(0.5, 1)* would be the center top of the bounding box. - A `.Transform` to transform *xy* to screen coordinates. - A function with one of the following signatures:: def transform(renderer) -> Bbox def transform(renderer) -> Transform where *renderer* is a `.RendererBase` subclass. The result of the function is interpreted like the `.Artist` and `.Transform` cases above. - A tuple *(xcoords, ycoords)* specifying separate coordinate systems for *x* and *y*. *xcoords* and *ycoords* must each be of one of the above described types. See :ref:`plotting-guide-annotation` for more details. textcoords : single or two-tuple of str or `.Artist` or `.Transform` or callable, default: value of *xycoords* The coordinate system that *xytext* is given in. All *xycoords* values are valid as well as the following strings: ================= ================================================= Value Description ================= ================================================= 'offset points' Offset, in points, from the *xy* value 'offset pixels' Offset, in pixels, from the *xy* value 'offset fontsize' Offset, relative to fontsize, from the *xy* value ================= ================================================= arrowprops : dict, optional The properties used to draw a `.FancyArrowPatch` arrow between the positions *xy* and *xytext*. Defaults to None, i.e. no arrow is drawn. For historical reasons there are two different ways to specify arrows, "simple" and "fancy": **Simple arrow:** If *arrowprops* does not contain the key 'arrowstyle' the allowed keys are: ========== ================================================= Key Description ========== ================================================= width The width of the arrow in points headwidth The width of the base of the arrow head in points headlength The length of the arrow head in points shrink Fraction of total length to shrink from both ends ? Any `.FancyArrowPatch` property ========== ================================================= The arrow is attached to the edge of the text box, the exact position (corners or centers) depending on where it's pointing to. **Fancy arrow:** This is used if 'arrowstyle' is provided in the *arrowprops*. Valid keys are the following `.FancyArrowPatch` parameters: =============== =================================== Key Description =============== =================================== arrowstyle The arrow style connectionstyle The connection style relpos See below; default is (0.5, 0.5) patchA Default is bounding box of the text patchB Default is None shrinkA Default is 2 points shrinkB Default is 2 points mutation_scale Default is text size (in points) mutation_aspect Default is 1 ? Any `.FancyArrowPatch` property =============== =================================== The exact starting point position of the arrow is defined by *relpos*. It's a tuple of relative coordinates of the text box, where (0, 0) is the lower left corner and (1, 1) is the upper right corner. Values <0 and >1 are supported and specify points outside the text box. By default (0.5, 0.5), so the starting point is centered in the text box. annotation_clip : bool or None, default: None Whether to clip (i.e. not draw) the annotation when the annotation point *xy* is outside the axes area. - If *True*, the annotation will be clipped when *xy* is outside the axes. - If *False*, the annotation will always be drawn. - If *None*, the annotation will be clipped when *xy* is outside the axes and *xycoords* is 'data'. **kwargs Additional kwargs are passed to `.Text`. Returns ------- `.Annotation` See Also -------- :ref:`plotting-guide-annotation` )