matplotlib.pyplot.annotate#

matplotlib.pyplot.annotate(text, xy, xytext=None, xycoords='data', textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)[源码]#

用文本 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) 为边界框的顶部中心。
用于将 xy 转换为屏幕坐标的 Transform。
具有以下签名之一的函数
```
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 参数