annotate 函数的用法

Axes.annotate(s, xy, *args, **kwargs)

• s：注释文本的内容
• xy：被注释的坐标点，二维元组形如(x,y)
• xytext：注释文本的坐标点，也是二维元组，默认与xy相同
• xycoords：被注释点的坐标系属性，允许输入的值如下

属性值	含义
'figure points'	以绘图区左下角为参考，单位是点数
'figure pixels'	以绘图区左下角为参考，单位是像素数
'figure fraction'	以绘图区左下角为参考，单位是百分比
'axes points'	以子绘图区左下角为参考，单位是点数（一个figure可以有多个axex，默认为1个）
'axes pixels'	以子绘图区左下角为参考，单位是像素数
'axes fraction'	以子绘图区左下角为参考，单位是百分比
'data'	以被注释的坐标点xy为参考 (默认值)
'polar'	不使用本地数据坐标系，使用极坐标系

• textcoords ：注释文本的坐标系属性，默认与xycoords属性值相同，也可设为不同的值。除了允许输入xycoords的属性值，还允许输入以下两种：

属性值	含义
'offset points'	相对于被注释点xy的偏移量（单位是点）
'offset pixels'	相对于被注释点xy的偏移量（单位是像素）

arrowprops：箭头的样式，dict（字典）型数据，如果该属性非空，则会在注释文本和被注释点之间画一个箭头。如果不设置'arrowstyle' 关键字，则允许包含以下关键字：

关键字	说明
width	箭头的宽度（单位是点）
headwidth	箭头头部的宽度（点）
headlength	箭头头部的长度（点）
shrink	箭头两端收缩的百分比（占总长）
?	任何 matplotlib.patches.FancyArrowPatch中的关键字

如果设置了‘arrowstyle’关键字，以上关键字就不能使用。允许的值有：

箭头的样式	属性
'-'	None
'->'	head_length=0.4,head_width=0.2
'-['	widthB=1.0,lengthB=0.2,angleB=None
'|-|'	widthA=1.0,widthB=1.0
'-|>'	head_length=0.4,head_width=0.2
'<-'	head_length=0.4,head_width=0.2
'<->'	head_length=0.4,head_width=0.2
'<|-'	head_length=0.4,head_width=0.2
'<|-|>'	head_length=0.4,head_width=0.2
'fancy'	head_length=0.4,head_width=0.4,tail_width=0.4
'simple'	head_length=0.5,head_width=0.5,tail_width=0.2
'wedge'	tail_width=0.3,shrink_factor=0.5

FancyArrowPatch的关键字包括:

Key	Description
arrowstyle	箭头的样式
connectionstyle	连接线的样式
relpos	箭头起始点相对注释文本的位置，默认为 (0.5, 0.5)，即文本的中心， （0，0）表示左下角，（1，1）表示右上角
patchA	箭头起点处的图形（matplotlib.patches对象），默认是注释文字框
patchB	箭头终点处的图形（matplotlib.patches对象），默认为空
shrinkA	箭头起点的缩进点数，默认为2
shrinkB	箭头终点的缩进点数，默认为2
mutation_scale	default is text size (in points)
mutation_aspect	default is 1.
?	any key for matplotlib.patches.PathPatch

• annotation_clip : 布尔值，可选参数，默认为空。设为True时，只有被注释点在子图区内时才绘制注释；设为False时，无论被注释点在哪里都绘制注释。仅当xycoords为‘data’时，默认值空相当于True。

返回值：

Annotation对象