Spec-Zone.ru › Matplotlib 2.2

matplotlib.pyplot.annotate

matplotlib.pyplot.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.pyplot.annotate

../../_images/sphx_glr_usetex_demo_thumb.png

Демонстрация использования LaTeX

../../_images/sphx_glr_mathtext_examples_thumb.png

Примеры Mathtext

../../_images/sphx_glr_xkcd_thumb.png

XKCD

../../_images/sphx_glr_pyplot_thumb.png

Урок по pyplot

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

Spec-Zone.ru

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