Spec-Zone.ru › Matplotlib 2.1

matplotlib.axes.Axes.annotate

Axes.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.

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

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

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

textcoords : строка, Artist, Transform, вызываемая функция или кортеж, необязательно

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

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

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

По умолчанию — входное значение xycoords

arrowprops : dict, необязательно

Если не 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”.

Возвращает:

Аннотация

© 2012–2017 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
http://matplotlib.org/2.1.0/api/_as_gen/matplotlib.axes.Axes.annotate.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API