Spec-Zone.ru › Matplotlib 3.0

matplotlib.axes.Axes.annotate

Axes.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 из str, 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".

Возвращает:
Аннотация

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

../../_images/sphx_glr_annotate_transform_thumb.png

Преобразование аннотации

../../_images/sphx_glr_annotation_basic_thumb.png

Добавление аннотации к графику

../../_images/sphx_glr_annotation_polar_thumb.png

Аннотация на полярном графике

../../_images/sphx_glr_text_commands_thumb.png

Команды для текста

../../_images/sphx_glr_whats_new_98_4_fancy_thumb.png

Новые функции 0.98.4

../../_images/sphx_glr_donut_thumb.png

Ммм, пончики!!!

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

Spec-Zone.ru

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