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的箭头。

参数：

文字串

注释的文本。

xy （浮点数，浮点数）

要注释的点(x, y) 。坐标系由xycoords确定。

xytext （浮点数，浮点数），默认值：xy

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

xycoords str or Artistor or Transformor callable or (float, float)，默认值：'data'

给定xy的坐标系。支持以下类型的值：

以下字符串之一：

价值	描述
'数字点'	图左下角的点
'数字像素'	图左下角的像素
'数字分数'	图左下角的分数
'子图点'	子图左下角的点
'子图像素'	子图左下角的像素
'子图分数'	左下角子图的分数
'轴点'	坐标轴左下角的点
'轴像素'	坐标轴左下角的像素
'轴分数'	左下角轴的分数
'数据'	使用被注释对象的坐标系（默认）
'极性'	(theta, r)如果不是本机“数据”坐标

请注意，父图的“子图像素”和“图像素”是相同的，因此想要在子图中可用的代码的用户可以使用“子图像素”。

An Artist: xy被解释为艺术家的 Bbox. 例如，(0, 0)将是边界框的左下角，(0.5, 1)将是边界框的中心顶部。
ATransform将xy转换为屏幕坐标。
具有以下签名之一的函数：
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
其中渲染器是一个RendererBase子类。

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

有关详细信息，请参阅高级注释。

textcoords str or Artistor Transformor callable or (float, float)，默认值：xycoords的值

给定xytext的坐标系。

所有xycoords值以及以下字符串都是有效的：

价值	描述
'偏移点'	与xy值的偏移量（以磅为单位）
'偏移像素'	从xy值偏移（以像素为单位）

arrowprops dict，可选

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

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

简单箭头：

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

钥匙	描述
宽度	箭头的宽度（以磅为单位）
头宽	箭头底部的宽度（以磅为单位）
头长	箭头的长度（以磅为单位）
收缩	从两端收缩的总长度的分数
?	任意键`matplotlib.patches.FancyArrowPatch`

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

花式箭头：

如果在 arrowprops 中提供了“arrowstyle”，则使用此选项。

有效键是以下FancyArrowPatch 参数：

钥匙	描述
箭头样式	箭头样式
连接方式	连接方式
回复	见下文; 默认为 (0.5, 0.5)
补丁A	默认是文本的边界框
补丁B	默认为无
收缩A	默认为 2 点
收缩B	默认为 2 点
突变规模	默认为文本大小（以磅为单位）
突变方面	默认值为 1。
?	任何钥匙`matplotlib.patches.PathPatch`