matplotlib.pyplot.text

matplotlib.pyplot.text(x, y, s, fontdict=None, **kwargs)[source]

Добавление текста на область графика.

Добавляет текст s на область графика в позиции x, y в координатах данных.

Параметры

x, yfloat

Позиция для размещения текста. По умолчанию, в координатах данных. Система координат может быть изменена с помощью параметра transform.

sstr

Текст.

fontdictdict, по умолчанию: None

Словарь для переопределения свойств текста по умолчанию. Если fontdict равен None, значения по умолчанию определяются параметром rcParams.

Возвращаемое значение

Text

Созданный экземпляр Text.

Дополнительные параметры

**kwargsСвойства Text.

Другие параметры текста общего назначения.

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3)
alpha	скаляр или None
animated	bool
backgroundcolor	цвет
bbox	словарь с параметрами для patches.FancyBboxPatch
clip_box	неизвестно
clip_on	неизвестно
clip_path	неизвестно
color или c	цвет
figure	Figure
fontfamily или family	{ШРИФТ, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties	font_manager.FontProperties или str или pathlib.Path
fontsize или size	числовое значение или {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch или stretch	{числовое значение в диапазоне 0-1000, 'ultra-condensed', 'extra-condensed', 'condensed', 'semi-condensed', 'normal', 'semi-expanded', 'expanded', 'extra-expanded', 'ultra-expanded'}
fontstyle или style	{'normal', 'italic', 'oblique'}
fontvariant или variant	{'normal', 'small-caps'}
fontweight или weight	{числовое значение в диапазоне 0-1000, 'ultralight', 'light', 'normal', 'regular', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'bold', 'heavy', 'extra bold', 'black'}
gid	str
horizontalalignment или ha	{'center', 'right', 'left'}
in_layout	bool
label	объект
linespacing	числовое значение (кратное размеру шрифта)
math_fontfamily	str
multialignment или ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None или bool или числовое значение или вызываемый объект
position	(числовое значение, числовое значение)
rasterized	bool
rotation	числовое значение или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(масштаб: числовое значение, длина: числовое значение, случайность: числовое значение)
snap	bool или None
text	объект
transform	Transform
transform_rotates_text	bool
url	строка
usetex	bool или None
verticalalignment или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
visible	bool
wrap	bool
x	числовое значение
y	числовое значение

zorder

число с плавающей точкой

Примеры

Отдельные ключевые аргументы могут быть использованы для переопределения любого заданного параметра:

>>> text(x, y, s, fontsize=12)

По умолчанию преобразование указывает, что текст находится в координатах данных, альтернативно, вы можете указать текст в координатах оси ((0, 0) — нижний левый, (1, 1) — верхний правый). Приведенный ниже пример размещает текст в центре области Axes:

>>> text(0.5, 0.5, 'matplotlib', horizontalalignment='center',
...      verticalalignment='center', transform=ax.transAxes)

Вы можете поместить прямоугольную рамку вокруг текстового элемента (например, чтобы задать цвет фона) с помощью ключевого слова bbox. bbox — это словарь свойств Rectangle. Например:

>>> text(x, y, s, bbox=dict(facecolor='red', alpha=0.5))

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