matplotlib.axes.Axes.text

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

Добавить текст на Axes.

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

Параметры

x, yfloat

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

sstr

Текст.

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

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

Возвращает

Text

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

Другие параметры

**kwargsText свойства.

Другие параметры смешанного типа.

Свойство	Описание
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	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties или font или font_properties	font_manager.FontProperties или str или pathlib.Path
fontsize или size	float или {'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	float (кратное размеру шрифта)
math_fontfamily	str
multialignment или ma	{'left', 'right', 'center'}
parse_math	bool
path_effects	AbstractPathEffect
picker	None или bool или float или вызываемая функция
position	(float, float)
rasterized	bool
rotation	float или {'vertical', 'horizontal'}
rotation_mode	{None, 'default', 'anchor'}
sketch_params	(масштаб: float, длина: float, случайность: float)
snap	bool или None
text	объект
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool или None
verticalalignment или va	{'center', 'top', 'bottom', 'baseline', 'center_baseline'}
visible	bool
wrap	bool
x	float
y	float

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