matplotlib.axes.Axes.text
- Axes.text(x, y, s, fontdict=None, **kwargs)[source]
-
Добавить текст на область Axes.
Добавьте текст s в область Axes в местоположении x, y в координатах данных, с по умолчанию
horizontalalignmentпоleftиverticalalignmentвbaseline. См. Выравнивание текста.- Параметры:
-
- x, yfloat
-
Позиция для размещения текста. По умолчанию это координаты данных. Система координат может быть изменена с помощью параметра transform.
- sstr
-
Текст.
- fontdictdict, по умолчанию: None
-
Не рекомендуется
Использование fontdict не рекомендуется. Параметры следует передавать как отдельные ключевые аргументы или с помощью распаковки словаря
text(..., **fontdict).Словарь для переопределения свойств текста по умолчанию. Если fontdict равен None, значения по умолчанию определяются с помощью
rcParams.
- Возвращаемое значение:
-
Text-
Созданный экземпляр
Text.
- Другие параметры:
-
-
**kwargs
Textсвойства.
-
**kwargs
-
Другие параметры, относящиеся к различным мелким деталям.
Свойство
Описание
функция-фильтр, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
скаляр или None
bool
bool
цвет
словарь с свойствами для
patches.FancyBboxPatchнеизвестно
неизвестно
неизвестно
colorили cцвет
fontfamilyили family или fontname{ШРИФТ, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertiesили font или font_propertiesfontsizeили 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'}
str
horizontalalignmentили ha{'left', 'center', 'right'}
bool
объект
число (кратное размеру шрифта)
str
bool
multialignmentили ma{'left', 'right', 'center'}
bool
список
AbstractPathEffectNone или bool или число или вызываемый объект
(число, число)
bool
число или {'vertical', 'horizontal'}
{None, 'default', 'anchor'}
(масштаб: число, длина: число, случайность: число)
bool или None
объект
bool
str
bool или None
verticalalignmentили va{'baseline', 'bottom', 'center', 'center_baseline', 'top'}
bool
-
-
Примеры
Отдельные ключевые аргументы могут быть использованы для переопределения заданного параметра:
>>> text(x, y, s, fontsize=12)
По умолчанию преобразование задает, что текст находится в координатах данных, альтернативно, вы можете указать текст в координатах осей ((0, 0) - нижний левый угол, (1, 1) - верхний правый угол). Приведенный ниже пример размещает текст в центре оси:
>>> 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
Объединение текстовых объектов с различными свойствами
Рендеринг математических уравнений с использованием TeX
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/_as_gen/matplotlib.axes.Axes.text.html
