matplotlib.pyplot.annotate

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

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

Дополнительные ключевые аргументы передаются в Text.

Параметры:

s : str

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

xy : iterable

Последовательность длиной 2, задающая точку (x,y) для аннотации.

xytext : iterable, optional

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

xycoords : str, Artist, Transform, callable or tuple, optional

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

Для str допустимые значения:

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

Если передан объект Artist, единицы — доля от его области.

Если передан объект Transform, используйте его для преобразования xy в экранные координаты

Если передан вызываемый объект, он должен принять объект RendererBase в качестве входных данных и вернуть объект Transform или Bbox

Если передан кортеж tuple, он должен быть кортежем длиной 2 из строк, Artist, Transform или вызываемых объектов. Первый преобразователь используется для координаты x, а второй — для y.

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

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

textcoords : str, Artist, Transform, callable or tuple, optional

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

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

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

по умолчанию, соответствует входу xycoords

arrowprops : dict, optional

Если не None, свойства, используемые для рисования стрелки 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_clip : bool, optional

Управляет видимость аннотации при выходе за область осей.

Если True, аннотация будет отображаться только если xy находится внутри осей. Если False, аннотация всегда будет отображаться независимо от ее положения.

По умолчанию None, что ведет себя как True только если xycoords равен "data".

Возвращает: