Функция text() / annotate() в Matplotlib
Справочная документация Matplotlib
text()Добавление текста в указанных координатах на графике,annotate()Добавление аннотаций со стрелками, которые могут точно указывать на точки данных.
Определение функции
text()
matplotlib.pyplot.text(x, y, s, fontdict=None, **kwargs) Axes.text(x, y, s, fontdict=None, **kwargs)
annotate()
matplotlib.pyplot.annotate(text, xy, xytext=None, xycoords='data',
textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)
Axes.annotate(text, xy, xytext=None, xycoords='data',
textcoords=None, arrowprops=None, annotation_clip=None, **kwargs)
Описание параметра
Параметры text()
| Параметр | Описание |
|---|---|
| x, y | Координаты положения текста |
| s | Текстовая строка для отображения |
| fontsize | Размер шрифта |
| color | Цвет текста |
| ha / horizontalalignment | Горизонтальное выравнивание: 'center', 'right', 'left' |
| va / verticalalignment | Вертикальное выравнивание: 'center', 'top', 'bottom', 'baseline' |
| rotation | Угол поворота (градусы) |
| fontweight | Насыщенность шрифта: 'normal', 'bold', 'light' |
| bbox | Свойства фоновой рамки текста, например, dict(facecolor='yellow', alpha=0.5) |
Специфические параметры annotate()
| Параметр | Описание |
|---|---|
| text | Текстовое содержимое аннотации |
| xy | Координаты целевой точки, на которую указывает стрелка (x, y) (кончик стрелки) |
| xytext | Координаты позиции размещения текста. По умолчанию — None (текст размещается в позиции xy) |
| xycoords / textcoords | Система координат для xy / xytext: 'data', 'axes fraction', 'figure fraction', 'offset points' и т. д. |
| arrowprops | Словарь свойств стрелки, например dict(arrowstyle='->', color='gray', lw=1.5) |
Основная ценность annotate в том, что xy и xytext могут отдельно задавать точку с координатами и позицию текста и соединять их стрелкой, чего не может сделать text().
arrowprops: распространённые стили стрелок
| Style | Эффект |
|---|---|
| '->' | Сплошная треугольная стрелка |
| '-' | Нет линии |
| '<->' | Двунаправленная стрелка |
| '-[widthB=...,lengthB=...]' | Пользовательская прямоугольная стрелка |
| 'fancy' | Изящная изогнутая стрелка |
| 'simple' | Простая прямая стрелка |
Примеры использования
Пример 1: Базовое добавление текста (text)
Пример
import numpy as np
x = np.linspace(0, 10, 100)
y = np.sin(x)
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
ax.plot(x, y, 'steelblue', linewidth=2)
# Добавить текстовую метку на пике
peak_idx = np.argmax(y)
ax.text(x[peak_idx], y[peak_idx] + 0.1,
f'Пик: ({x[peak_idx]:.2f}, {y[peak_idx]:.2f})',
fontsize=10, color='red',
ha='center', va='bottom',
fontweight='bold')
# Добавить текст + фоновую рамку в точке минимума
valley_idx = np.argmin(y)
ax.text(x[valley_idx], y[valley_idx] - 0.15,
f'Долина: ({x[valley_idx]:.2f}, {y[valley_idx]:.2f})',
fontsize=10, ha='center', va='top',
bbox=dict(boxstyle='round,pad=0.3',
facecolor='yellow', alpha=0.7))
ax.set_title('text() - Добавление текста в заданных координатах')
ax.set_xlabel('x')
ax.set_ylabel('sin(x)')
ax.grid(True, alpha=0.3)
plt.show()
Пример 2: Аннотация со стрелкой (annotate)
Пример
import numpy as np
x = np.linspace(0, 10, 50)
y = np.exp(-x/3) * np.sin(2 * x) # Затухающие колебания
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y, 'steelblue', linewidth=2, marker='o', markersize=4)
# Аннотировать первый пик (стрелка указывает от текста к точке данных)
peak1_idx = np.argmax(y)
ax.annotate('1-й пик',
xy=(x[peak1_idx], y[peak1_idx]), # Точка, на которую указывает стрелка
xytext=(x[peak1_idx] + 1.5, y[peak1_idx] + 0.2), # Позиция текста
arrowprops=dict(arrowstyle='->',
color='red', lw=1.5),
fontsize=11, color='red', fontweight='bold')
# Аннотировать область распада
ax.annotate('Область распада',
xy=(.7, .3), xycoords='axes fraction', # Использовать координаты в долях осей
xytext=(0.5, 0.8), textcoords='доля осей',
arrowprops=dict(arrowstyle='fancy',
color='green',
connectionstyle='arc3,rad=0.3'),
fontsize=11, color='green',
bbox=dict(boxstyle='round', facecolor='wheat', alpha=0.5))
ax.set_title('annotate() - Аннотации со стрелками')
ax.set_xlabel('Время (s)')
ax.set_ylabel('Амплитуда')
ax.grid(True, alpha=0.3)
plt.show()
Пример 3: аннотация формулы и система координат
Пример
import numpy as np
x = np.linspace(0, 4*np.pi, 200)
y1 = np.sin(x)
y2 = np.cos(x)
fig, ax = plt.subplots(figsize=(8, 5), layout='constrained')
ax.plot(x, y1, 'blue', label='sin(x)')
ax.plot(x, y2, 'red', label='cos(x)')
# Аннотировать с помощью математической формулы в фиксированной позиции на графике
ax.text(0.02, 0.95,
r'$f(x) = sin(x)$',
transform=ax.transAxes, # Использовать относительные координаты осей (0-1)
fontsize=14, color='blue',
verticalalignment='top',
bbox=dict(boxstyle='round', facecolor='lightblue', alpha=0.5))
ax.text(0.02, 0.82,
r'$g(x) = cos(x)$',
transform=ax.transAxes,
fontsize=14, color='red',
verticalalignment='top',
bbox=dict(boxstyle='round', facecolor='lightcoral', alpha=0.5))
ax.set_title(r'Математическая формула с LaTeX: $sum_{i=1}^{n} x_i$')
ax.set_xlabel('x (радианы)')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
print("пример: математическая аннотация отображена")
ЧАВО
В чем разница между text и annotate?
text()Только размещает текст в указанных координатах, подходит для добавления меток или описаний.
annotate()Может добавить стрелку, соединяющую текст и точку данных, подходит для точной аннотации ключевых позиций.
Как использовать математические формулы в тексте?
Используйте синтаксис LaTeX:r'$alpha + beta$'Префикс r указывает на необработанную строку, а содержимое внутри $...$ будет отображаться как математическая формула.
Требуется установленный в системе LaTeX или используйте встроенный в Matplotlib рендерер mathtext.
Другие расширения