Python matplotlib AnchoredDirectionArrows用法及代码示例

本文简要介绍 python 语言中mpl_toolkits.axes_grid1.anchored_artists.AnchoredDirectionArrows的用法。

用法

class mpl_toolkits.axes_grid1.anchored_artists.AnchoredDirectionArrows(transform, label_x, label_y, length=0.15, fontsize=0.08, loc='upper left', angle=0, aspect_ratio=1, pad=0.4, borderpad=0.4, frameon=False, color='w', alpha=1, sep_x=0.01, sep_y=0, fontproperties=None, back_length=0.15, head_width=10, head_length=15, tail_width=2, text_props=None, arrow_props=None, **kwargs)

基础： AnchoredOffsetbox

画两个垂直的箭头来指示方向。

参数：

transform Transform

正在使用的坐标系的变换对象，即 matplotlib.axes.Axes.transAxes 。

label_x, label_y str

x 和 y 箭头的标签文本

length 浮点数，默认值：0.15

箭头的长度，以 transform 的坐标给出。

fontsize 浮点数，默认：0.08

标签字符串的大小，以 transform 的坐标给出。

loc str，默认值：'upper left'

箭头的位置。有效位置为'upper left'、'upper center'、'upper right'、'center left'、'center'、'center right'、'lower left'、'lower center'、'lower right'。为了向后兼容，也接受数值。详情请参见 Legend 的参数loc。

angle 浮点数，默认值：0

箭头的角度，以度为单位。

aspect_ratio 浮点数，默认值：1

arrow_x 和 arrow_y 的长度之比。负数可用于改变方向。

pad 浮点数，默认值：0.4

标签和箭头周围的填充，以字体大小的一小部分。

borderpad 浮点数，默认值：0.4

边框填充，以字体大小的分数表示。

frameon 布尔值，默认值：假

如果为 True，请在箭头和标签周围画一个框。

color str，默认值：'white'

箭头和标签的颜色。

alpha 浮点数，默认值：1

箭头和标签的 Alpha 值

sep_x, sep_y 浮点数，默认值：分别为 0.01 和 0

transform 坐标中的箭头和标签之间的分隔。

fontproperties FontProperties ，可选

标签文本的字体属性。

back_length 浮点数，默认值：0.15

箭头交叉点后面的箭头分数。

head_width 浮点数，默认值：10

箭头宽度，发送至 ArrowStyle 。

head_length 浮点数，默认值：15

箭头长度，发送到 ArrowStyle 。

tail_width 浮点数，默认值：2

箭尾宽度，发送至 ArrowStyle 。

text_props, arrow_props dict

文本和箭头的属性，传递给 TextPath 和 FancyArrowPatch 。

**kwargs

关键字参数转发到 AnchoredOffsetbox 。

注意

如果 prop 作为关键字参数传递，但 fontproperties 不是，则 prop 被假定为预期的 fontproperties 。不支持同时使用prop 和fontproperties。

例子

>>> import matplotlib.pyplot as plt
>>> import numpy as np
>>> from mpl_toolkits.axes_grid1.anchored_artists import (
...     AnchoredDirectionArrows)
>>> fig, ax = plt.subplots()
>>> ax.imshow(np.random.random((10, 10)))
>>> arrows = AnchoredDirectionArrows(ax.transAxes, '111', '110')
>>> ax.add_artist(arrows)
>>> fig.show()

使用几个可选参数，创建向下箭头和高对比度文本标签。

>>> import matplotlib.font_manager as fm
>>> fontprops = fm.FontProperties(family='monospace')
>>> arrows = AnchoredDirectionArrows(ax.transAxes, 'East', 'South',
...                                  loc='lower left', color='k',
...                                  aspect_ratio=-1, sep_x=0.02,
...                                  sep_y=-0.01,
...                                  text_props={'ec':'w', 'fc':'k'},
...                                  fontproperties=fontprops)

属性：

arrow_x, arrow_y FancyArrowPatch

箭头 x 和 y

text_path_x, text_path_y TextPath

箭头标签的路径

p_x, p_y PathPatch

箭头标签补丁

box AuxTransformBox

箭头和标签的容器。