matplotlib.axes.Axes.annotate

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

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

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

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

Параметры:

textstr

Текст аннотации.

xy(float, float)

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

xytext(float, float), по умолчанию: xy

Позиция (x, y) для размещения текста. Система координат определяется параметром textcoords.

xycoordsstr или Artist или Transform или вызываемая функция или (float, float), по умолчанию: 'data'

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

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

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

Обратите внимание, что 'subfigure pixels' и 'figure pixels' совпадают для родительской фигуры, поэтому пользователи, которые хотят код, пригодный для использования в подрисунке, могут использовать 'subfigure pixels'.

Объект 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 должны быть одного из вышеописанных типов.

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

textcoordsstr или Artist или Transform или вызываемая функция или (float, float), по умолчанию: значение xycoords

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

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

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

arrowpropsdict, необязательно

Свойства, используемые для рисования стрелки FancyArrowPatch между позициями xy и xytext. Обратите внимание, что край стрелки, указывающий на xytext, будет центрирован по тексту и может не указывать непосредственно на координаты, заданные в 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 или None, по умолчанию: None

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

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

**kwargs