matplotlib.axes.Axes.annotate

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

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

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

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

Параметры:

textstr

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

xy(float, float)

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

xytext(float, float), default: xy

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

xycoordsstr or Artist or Transform or callable or (float, float), default: 'data'

Система координат, в которой задаётся 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 должны быть одного из описанных выше типов.

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

textcoordsstr or Artist or Transform or callable or (float, float), default: value of xycoords

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

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

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

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, default: None

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

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

**kwargs