matplotlib.axes.Axes.annotate#

Axes.annotate(text, xy, xytext=None, xycoords='data', textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)[source]#

用文本 text 注释点 xy。

最简单的形式是，文本放置在 *xy* 处。

可选地，文本可以显示在另一个位置 *xytext*。然后可以通过定义 *arrowprops* 来添加一个从文本指向被标注点 *xy* 的箭头。

参数:

textstr

标注的文本内容。

xy(float, float)

要标注的点 *(x, y)*。坐标系统由 *xycoords* 决定。

xytext(float, float)，默认值: *xy*

放置文本的位置 *(x, y)*。坐标系统由 *textcoords* 决定。

xycoords单个或两个字符串元组，或 Artist 或 Transform 或可调用对象，默认值: 'data'

给出 *xy* 的坐标系统。支持以下类型的值：

以下字符串之一

请注意，对于父图形，'subfigure pixels' 和 'figure pixels' 是相同的，因此希望代码可在子图中使用的用户可以使用 'subfigure pixels'。

一个 Artist：*xy* 被解释为艺术家 Bbox 的一部分。例如，*(0, 0)* 是包围盒的左下角，*(0.5, 1)* 是包围盒的中心顶部。
一个 Transform 用于将 *xy* 转换为屏幕坐标。
具有以下签名之一的函数
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
其中 *renderer* 是 RendererBase 的子类。

函数的结果被解释为与上述 Artist 和 Transform 情况类似。
一个元组 *(xcoords, ycoords)*，为 *x* 和 *y* 指定独立的坐标系统。*xcoords* 和 *ycoords* 都必须是上述类型之一。

有关更多详细信息，请参阅高级标注。

textcoords单个或两个字符串元组，或 Artist 或 Transform 或可调用对象，默认值: *xycoords* 的值

给出 *xytext* 的坐标系统。

所有 *xycoords* 值均有效，以及以下字符串：

arrowpropsdict，可选

用于在 *xy* 和 *xytext* 位置之间绘制 FancyArrowPatch 箭头的属性。默认为 None，即不绘制箭头。

出于历史原因，有两种不同的方式指定箭头：“简单”和“花式”

简单箭头

如果 *arrowprops* 不包含键 'arrowstyle'，则允许的键为：

箭头附着在文本框的边缘，确切位置（角或中心）取决于其指向。

花式箭头

如果 *arrowprops* 中提供了 'arrowstyle'，则使用此选项。

有效键是以下 FancyArrowPatch 参数：