Функции текста и аннотаций уровня Figure в Matplotlib
Справочная документация Matplotlib
Помимо text() и annotate(), Matplotlib также предоставляет текстовые функции уровня Figure, добавление таблиц и рисование стрелок.
Обзор функций
| Функция | Описание |
|---|---|
| figtext() | Добавить текст на уровне Figure (не Axes) |
| figlegend() | Добавить легенду на уровне Figure (по всем Axes) |
| table() | Добавить таблицу в Axes |
| arrow() | Добавить простую стрелку |
figtext() - Текст уровня Figure
matplotlib.pyplot.figtext(x, y, s, fontdict=None, **kwargs)
Аналогично text(), но система координат — это координаты Figure (0-1), а не координаты данных.
Пример
import matplotlib.pyplot as plt
import numpy as np
fig, ax = plt.subplots(figsize=(8, 5))
ax.plot([0, 1], [0, 1], 'steelblue')
ax.set_title('Уровень Axes (text vs figtext)')
# Текст уровня Axes (координаты данных)
ax.text(0.3, 0.7, 'Текст Axes (координаты данных)',
fontsize=12, color='blue')
# Текст уровня Figure (относительные координаты Figure 0-1)
plt.figtext(0.5, 0.02,
'Текст Figure внизу по центру (координаты Figure)',
ha='center', fontsize=10, color='gray')
plt.figtext(0.02, 0.95,
'Сверху слева',
ha='left', va='top',
fontsize=12, fontweight='bold', color='red')
plt.show()
import numpy as np
fig, ax = plt.subplots(figsize=(8, 5))
ax.plot([0, 1], [0, 1], 'steelblue')
ax.set_title('Уровень Axes (text vs figtext)')
# Текст уровня Axes (координаты данных)
ax.text(0.3, 0.7, 'Текст Axes (координаты данных)',
fontsize=12, color='blue')
# Текст уровня Figure (относительные координаты Figure 0-1)
plt.figtext(0.5, 0.02,
'Текст Figure внизу по центру (координаты Figure)',
ha='center', fontsize=10, color='gray')
plt.figtext(0.02, 0.95,
'Сверху слева',
ha='left', va='top',
fontsize=12, fontweight='bold', color='red')
plt.show()
figlegend() - Легенда уровня Figure
matplotlib.pyplot.figlegend(*args, **kwargs)
Когда нескольким Axes нужно совместно использовать одну легенду, figlegend() может разместить легенду на уровне Figure.
Пример
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
layout='constrained')
# Нарисуйте те же две кривые на каждом Axes, но не добавляйте отдельные легенды
ax1.plot(x, np.sin(x), 'b-', label='sin(x)')
ax1.plot(x, np.cos(x), 'r--', label='cos(x)')
ax1.set_title('График 1')
ax2.plot(x, np.sin(x), 'b-', label='sin(x)')
ax2.plot(x, np.cos(x), 'r--', label='cos(x)')
ax2.set_title('График 2')
# Легенда уровня Figure (размещена сверху за пределами Figure)
fig.legend(loc='outside upper center', ncol=2,
fontsize=11, frameon=True)
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(10, 4),
layout='constrained')
# Нарисуйте те же две кривые на каждом Axes, но не добавляйте отдельные легенды
ax1.plot(x, np.sin(x), 'b-', label='sin(x)')
ax1.plot(x, np.cos(x), 'r--', label='cos(x)')
ax1.set_title('График 1')
ax2.plot(x, np.sin(x), 'b-', label='sin(x)')
ax2.plot(x, np.cos(x), 'r--', label='cos(x)')
ax2.set_title('График 2')
# Легенда уровня Figure (размещена сверху за пределами Figure)
fig.legend(loc='outside upper center', ncol=2,
fontsize=11, frameon=True)
plt.show()
table() - Добавление таблицы в Axes
matplotlib.pyplot.table(cellText=None, cellColours=None,
cellLoc='right', colWidths=None, rowLabels=None,
rowColours=None, rowLoc='left', colLabels=None,
colColours=None, colLoc='center', loc='bottom',
bbox=None, edges='closed', **kwargs)
Пример
import matplotlib.pyplot as plt
import numpy as np
# Данные для отображения
data = [[85, 90, 78, 92],
[76, 88, 82, 85],
[90, 93, 88, 95]]
row_labels = ['Студент A', 'Студент B', 'Студент C']
col_labels = ['Математика', 'Английский', 'Наука', 'История']
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Построить сравнительную диаграмму
x = np.arange(len(col_labels))
for i, (row, label) in enumerate(zip(data, row_labels)):
ax.plot(x, row, 'o-', label=label, markersize=8)
ax.set_xticks(x)
ax.set_xticklabels(col_labels)
ax.set_title('Баллы студентов')
ax.legend()
ax.grid(True, alpha=0.3)
# Добавить таблицу под диаграммой
table = ax.table(cellText=data,
rowLabels=row_labels,
colLabels=col_labels,
cellLoc='center',
loc='bottom',
bbox=[0, -0.35, 1, 0.25]) # [слева, снизу, ширина, высота]
plt.show()
import numpy as np
# Данные для отображения
data = [[85, 90, 78, 92],
[76, 88, 82, 85],
[90, 93, 88, 95]]
row_labels = ['Студент A', 'Студент B', 'Студент C']
col_labels = ['Математика', 'Английский', 'Наука', 'История']
fig, ax = plt.subplots(figsize=(8, 4), layout='constrained')
# Построить сравнительную диаграмму
x = np.arange(len(col_labels))
for i, (row, label) in enumerate(zip(data, row_labels)):
ax.plot(x, row, 'o-', label=label, markersize=8)
ax.set_xticks(x)
ax.set_xticklabels(col_labels)
ax.set_title('Баллы студентов')
ax.legend()
ax.grid(True, alpha=0.3)
# Добавить таблицу под диаграммой
table = ax.table(cellText=data,
rowLabels=row_labels,
colLabels=col_labels,
cellLoc='center',
loc='bottom',
bbox=[0, -0.35, 1, 0.25]) # [слева, снизу, ширина, высота]
plt.show()
arrow() — Добавить стрелку
matplotlib.pyplot.arrow(x, y, dx, dy, **kwargs)
arrow() — это сокращённый способ добавления простых стрелок. Для сложных аннотаций со стрелками рекомендуется использовать annotate().
Пример
import matplotlib.pyplot as plt
import numpy as np
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
# Нарисовать систему координат
ax.spines[['left', 'bottom']].set_position(('data', 0))
ax.spines[['top', 'right']].set_visible(False)
ax.set_xlim(-1, 5)
ax.set_ylim(-1, 5)
# Различные стрелки
ax.arrow(0, 0, 3, 0, head_width=0.2, head_length=0.2,
fc='red', ec='red', label='Вправо на 3 единицы')
ax.arrow(0, 0, 0, 3, head_width=0.2, head_length=0.2,
fc='blue', ec='blue', label='Вверх на 3 единицы')
ax.arrow(0, 0, 2, 2, head_width=0.2, head_length=0.2,
fc='green', ec='green', label='По диагонали')
ax.set_title('arrow() - Простые стрелки')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
import numpy as np
fig, ax = plt.subplots(figsize=(7, 5), layout='constrained')
# Нарисовать систему координат
ax.spines[['left', 'bottom']].set_position(('data', 0))
ax.spines[['top', 'right']].set_visible(False)
ax.set_xlim(-1, 5)
ax.set_ylim(-1, 5)
# Различные стрелки
ax.arrow(0, 0, 3, 0, head_width=0.2, head_length=0.2,
fc='red', ec='red', label='Вправо на 3 единицы')
ax.arrow(0, 0, 0, 3, head_width=0.2, head_length=0.2,
fc='blue', ec='blue', label='Вверх на 3 единицы')
ax.arrow(0, 0, 2, 2, head_width=0.2, head_length=0.2,
fc='green', ec='green', label='По диагонали')
ax.set_title('arrow() - Простые стрелки')
ax.legend()
ax.grid(True, alpha=0.3)
plt.show()
Другие расширения