matplotlib.pyplot.annotate

matplotlib.pyplot.annotate(text, xy, *args, **kwargs)[源代码]

注释该点 xy 带文字 text .

在最简单的形式中,文本放置在 xy .

或者,文本可以显示在其他位置 木文 . 从文本指向注释点的箭头 xy 然后可以通过定义 箭头 .

参数:
textSTR

批注的文本。 s 是此参数的已弃用同义词。

xy(浮标,浮标)

重点 (x,y) 注释。坐标系由 木栓 .

木文 :(float,float),默认值: xy(float,float),默认值:

位置 (x,y) 将文本放置在。坐标系由 文本框 .

木栓 STR或 ArtistTransform 或callable或(float,float),默认值:“data”str或

坐标系 xy 给出。支持以下类型的值:

  • 下列字符串之一:

    价值 描述
    “图形点” 图左下角的点
    “图形像素” 图片左下角的像素
    '数字分数' 从左下角开始的分数
    “轴点” 轴左下角的点
    “轴像素” 来自轴左下角的像素
    “轴分数” 从左下角开始的轴分数
    “数据” 使用要注释的对象的坐标系(默认)
    “极地” (θ,r) 如果不是本机“数据”坐标
  • Artistxy 被解读为艺术家作品的一小部分 Bbox . 例如。 (0, 0) 将是边界框的左下角,并且 (0.5,1) 将是边界框的中心顶部。

  • A Transform 改造 xy 以筛选坐标。

  • 具有以下签名之一的函数:

    def transform(renderer) -> Bbox
    def transform(renderer) -> Transform
    

    在哪里? 渲染器 是一个 RendererBase 子类。

    函数的结果解释为 ArtistTransform 以上病例。

  • 元组 (xcoords,ycoords) 为指定单独的坐标系 xy . XCORDS钇铝石榴石 必须为上述类型之一。

高级批注 了解更多详细信息。

文本框 STR或 ArtistTransform 或float,或float,默认值 木栓str或

坐标系 木文 给出。

所有 木栓 值和以下字符串都有效:

价值 描述
“偏移点” 偏移(以点为单位) xy 价值
偏移像素 偏移(像素) xy 价值
arrowprops可选的

用于绘制 FancyArrowPatch 位置之间的箭头 xy木文 .

如果 箭头 不包含键“arrowstyle”。允许的键为:

描述
宽度 箭头的宽度(以点为单位)
头宽 箭头底端的宽度(以点为单位)
头长 箭头的长度(以点为单位)
收缩 从两端收缩的总长度的分数
是吗? 任何密钥到 matplotlib.patches.FancyArrowPatch

如果 箭头 包含键“arrowstyle”。禁止使用上述键。允许的值 'arrowstyle' 是:

名字 阿特斯
'-' 没有
'->' 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 是:

描述
箭头风格 箭头风格
连接方式 连接方式
雷波斯 默认值为(0.5,0.5)
帕查 默认为文本的边界框
帕奇布 默认为无
克里斯 默认为2分
收缩 默认为2分
mutation_scale 默认为文本大小(以点为单位)
mutation_aspect 默认值为1。
是吗? 任意键 matplotlib.patches.PathPatch

默认为无,即不绘制箭头。

annotation_clipbool或None,默认值:None

是否在批注点时绘制批注 xy 在轴区域之外。

  • 如果 True ,仅当 xy 在轴内。
  • 如果 ,注释将始终绘制。
  • 如果 None ,仅当 xy 在轴和 木栓 是“数据”。
**kwargs

额外的禁运转给 Text .

返回:
Annotation

参见

高级批注