matplotlib.pyplot.annotate

matplotlib.pyplot.annotate(*args, **kwargs)

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

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

Параметры:

s : str Текст аннотации xy : итерируемый объект Последовательность длины 2, определяющая точку (x,y), к которой добавляется аннотация xytext : итерируемый объект, необязательно Последовательность длины 2, определяющая точку (x,y) для размещения текста. Если None, по умолчанию используется xy. xycoords : строка, объект Artist, преобразование, вызываемая функция или кортеж, необязательно Система координат, в которой указана точка 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 Если кортеж, он должен быть кортежем длины 2 из строк, Artist, Transform или вызываемых функций. Первое преобразование используется для координаты x, а второе – для y. См. Дополнительная информация об аннотациях для получения дополнительной информации. По умолчанию 'data' textcoords : строка, Artist, Transform, вызываемая функция или кортеж, необязательно Система координат, в которой указан текст xytext может отличаться от системы координат, используемой для xy. Все xycoords значения допустимы, а также следующие строки: Свойство Описание ‘offset points’ смещение (в пунктах) от значения xy ‘offset pixels’ смещение (в пикселях) от значения xy По умолчанию используется значение xycoords arrowprops : словарь, необязательно Если не 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, необязательно Управляет видимостью аннотации, когда она выходит за пределы области осей. Если True, аннотация отображается только тогда, когда xy находится внутри осей. Если False, аннотация всегда отображается независимо от ее положения. По умолчанию None, что ведет себя как True только если xycoords равно “data”.

Возвращает:

Аннотация

Примеры использования matplotlib.pyplot.annotate

Пример аннотации pyplot

Примеры Mathtext

XKCD

Учебник по pyplot