Функция Matplotlib figure()
Справочная документация Matplotlib
figure()Используется для создания новой Figure (холста) или активации существующей Figure.
Figure — это контейнер верхнего уровня для всех графиков, управляющий размером, DPI и всеми подграфиками всей диаграммы.
Определение функции
matplotlib.pyplot.figure(num=None, figsize=None, dpi=None, *,
facecolor=None, edgecolor=None, frameon=True,
FigureClass=<class 'matplotlib.figure.Figure'>,
clear=False, layout=None, **kwargs)
Описание параметра
| Параметр | Type | Описание |
|---|---|---|
| num | int или str | Идентификатор Figure. Целые числа — это номера, строки — метки. Если он не существует, создаётся новый; если существует, активируется существующий. |
| figsize | tuple (w, h) | Размер Figure (в дюймах), например (8, 6). По умолчанию определяется rcParams. |
| dpi | float | Разрешение (точек на дюйм), например 100. Влияет на размер выходного изображения в пикселях. |
| facecolor | color | Цвет фона фигуры |
| edgecolor | color | Цвет границы Figure |
| frameon | bool | Отображать ли фоновую рамку Figure, по умолчанию True |
| clear | bool | Если num уже существует, очищать ли его перед использованием |
| layout | str или LayoutEngine | РекомендуемыйМеханизм компоновки: 'constrained', 'compressed', 'tight', 'none' |
Редко вызывается напрямую в повседневном использовании,
figure()чащеsubplots()создает Figure и Axes за один вызов. Использование figure() отдельно предназначено в основном для сценариев с несколькими Figure или пользовательских свойств холста.
Примеры использования
Пример 1: Создание Figure с пользовательским размером
Пример
import numpy as np
# Создание Figure с указанным размером и высоким DPI
fig = plt.figure(figsize=(10, 4), dpi=100,
facecolor='#f8f9fa',
layout='constrained')
# Добавить подграфики вручную
ax1 = fig.add_subplot(1, 2, 1)
ax2 = fig.add_subplot(1, 2, 2)
x = np.linspace(0, 10, 100)
ax1.plot(x, np.sin(x), 'steelblue', linewidth=2)
ax1.set_title('График 1')
ax2.plot(x, np.cos(x), 'coral', linewidth=2)
ax2.set_title('График 2')
plt.show()
Пример 2: Управление несколькими фигурами
Пример
import numpy as np
x = np.linspace(0, 10, 100)
# Создать фигуру #1
fig1 = plt.figure(1, figsize=(6, 4))
ax1 = fig1.subplots()
ax1.plot(x, np.sin(x), 'blue')
ax1.set_title('Фигура 1: sin(x)')
# Создать фигуру #2
fig2 = plt.figure(2, figsize=(6, 4))
ax2 = fig2.subplots()
ax2.plot(x, np.cos(x), 'red')
ax2.set_title('Рисунок 2: cos(x)')
# Активировать рисунок #1 и продолжить работу
plt.figure(1)
plt.plot(x, np.sin(2*x), '--', alpha=0.5)
# Сохранить конкретный рисунок
fig1.savefig('example_fig1.png', dpi=150)
fig2.savefig('example_fig2.png', dpi=150)
print("пример: два рисунка сохранены")
plt.show()
Пример 3: Автоматическая компоновка с параметром layout
Пример
import numpy as np
# Сравнить настройки layout
# Без использования layout (подписи могут перекрываться)
fig1 = plt.figure(1, figsize=(8, 4))
for i in range(3):
ax = fig1.add_subplot(1, 3, i+1)
ax.plot(np.random.randn(50).cumsum())
ax.set_title(f'График {i+1}')
ax.set_xlabel('Очень длинная метка x')
# Использовать layout='constrained' (автоматически обрабатывает перекрытие)
fig2 = plt.figure(2, figsize=(8, 4), layout='constrained')
for i in range(3):
ax = fig2.add_subplot(1, 3, i+1)
ax.plot(np.random.randn(50).cumsum())
ax.set_title(f'График {i+1}')
ax.set_xlabel('Очень длинная метка x')
plt.figure(1)
plt.suptitle('Без layout', y=1.02)
plt.figure(2)
plt.suptitle('С layout="constrained"', y=1.02)
plt.show()
print("пример: сравнить настройки layout")
ЧАВО
В каких единицах измеряется figsize?
Дюймы. Фактический размер в пикселях = figsize × dpi. Напримерfigsize=(8,6), dpi=100создаёт изображение размером 800×600 пикселей.
Какой вариант компоновки лучше?
'constrained'является рекомендуемым вариантом для большинства сценариев, автоматически управляя отступами подграфиков и подписей.
'compressed'дополнительно сжимает поля, подходит для сценариев, в которых нужно максимизировать область данных.
'none'не использует автоматическую компоновку (по умолчанию) и может быть настроен вручную с помощью subplots_adjust().
Другие расширения