matplotlib.axes.Axes.annotate

Axes.annotate(self, s, xy, *args, **kwargs) [source]

Добавляет аннотацию к точке xy с текстом text.

В простейшем случае текст размещается в точке xy.

В качестве опции, текст можно отобразить в другой позиции xytext. Стрелка, указывающая от текста к аннотируемой точке xy, может быть добавлена при определении arrowprops.

Параметры:

textstr

Текст аннотации. s — устаревший синоним для этого параметра.

xy(float, float)

Точка (x, y), к которой добавляется аннотация.

xytext(float, float), optional

Позиция (x, y), в которой будет размещен текст. Если None, используется xy по умолчанию.

xycoordsstr, Artist, Transform, callable or tuple, optional

Система координат, в которой заданы значения xy. Поддерживаются следующие типы значений:

Один из следующих строк:

Значение	Описание
'figure points'	Точки от нижнего левого угла фигуры
'figure pixels'	Пиксели от нижнего левого угла фигуры
'figure fraction'	Доля фигуры от нижнего левого угла
'axes points'	Точки от нижнего левого угла осей
'axes pixels'	Пиксели от нижнего левого угла осей
'axes fraction'	Доля осей от нижнего левого угла
'data'	Использовать систему координат объекта, к которому добавляется аннотация (по умолчанию)
'polar'	(theta, r) если не родные координаты 'data'

Объект Artist: xy интерпретируется как доля от Bbox объекта. Например, (0, 0) — нижний левый угол ограничивающей рамки, а (0.5, 1) — центр верхней части ограничивающей рамки.
Объект Transform, преобразующий xy в экранные координаты.
Функция с одной из следующих сигнатур:
```
def transform(renderer) -> Bbox
def transform(renderer) -> Transform
```
где renderer — подкласс RendererBase.

Результат функции интерпретируется так же, как в случаях с Artist и Transform.
Кортеж (xcoords, ycoords), задающий отдельные системы координат для x и y. xcoords и ycoords должны быть одного из описанных выше типов.

См. Дополнительные аннотации для получения более подробной информации.

По умолчанию — 'data'.

textcoordsstr, Artist, Transform, callable or tuple, optional

Система координат, в которой заданы значения xytext.

Все значения xycoords также допустимы, а также следующие строки:

Значение	Описание
'offset points'	Смещение (в пунктах) от значения xy
'offset pixels'	Смещение (в пикселях) от значения xy

По умолчанию — значение xycoords, т.е. используется та же система координат для точки аннотации и позиции текста.

arrowpropsdict, optional

Свойства, используемые для отрисовки стрелки FancyArrowPatch между позициями xy и xytext.

Если arrowprops не содержит ключа 'arrowstyle', разрешены следующие ключи:

Ключ	Описание
width	Ширина стрелки в пунктах
headwidth	Ширина основания стрелки в пунктах
headlength	Длина стрелки в пунктах
shrink	Доля общей длины, уменьшенная с обеих концов
?	Любой ключ для `matplotlib.patches.FancyArrowPatch`

Если arrowprops содержит ключ 'arrowstyle', вышеперечисленные ключи запрещены. Разрешенные значения '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:

Ключ	Описание
arrowstyle	стиль стрелки
connectionstyle	стиль соединения
relpos	по умолчанию (0.5, 0.5)
patchA	по умолчанию — ограничивающая рамка текста
patchB	по умолчанию — None
shrinkA	по умолчанию — 2 пункта
shrinkB	по умолчанию — 2 пункта
mutation_scale	по умолчанию — размер текста (в пунктах)
mutation_aspect	по умолчанию — 1.
?	любой ключ для `matplotlib.patches.PathPatch`

По умолчанию — None, т.е. стрелка не рисуется.

annotation_clipbool or None, optional

Рисовать аннотацию, когда точка аннотации xy находится за пределами области осей.

Если True, аннотация рисуется только тогда, когда xy находится внутри осей.
Если False, аннотация всегда рисуется.
Если None, аннотация рисуется только тогда, когда xy находится внутри осей и xycoords равно 'data'.

По умолчанию — None.

**kwargs