Spec-Zone.ru › Matplotlib 2.2

matplotlib.axes.Axes.annotate

Axes.annotate(*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_donut_thumb.png

Пончики!!!

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

Spec-Zone.ru

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