Функция text() / annotate() в Matplotlib


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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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='-&gt;',
                            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 matplotlib.pyplot as plt
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.


Matplotlib 参考文档Справочная документация Matplotlib

Другие расширения