Функция Matplotlib figure()


Matplotlib 参考文档Справочная документация 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Описание
numint или strИдентификатор Figure. Целые числа — это номера, строки — метки. Если он не существует, создаётся новый; если существует, активируется существующий.
figsizetuple (w, h)Размер Figure (в дюймах), например (8, 6). По умолчанию определяется rcParams.
dpifloatРазрешение (точек на дюйм), например 100. Влияет на размер выходного изображения в пикселях.
facecolorcolorЦвет фона фигуры
edgecolorcolorЦвет границы Figure
frameonboolОтображать ли фоновую рамку Figure, по умолчанию True
clearboolЕсли num уже существует, очищать ли его перед использованием
layoutstr или LayoutEngineРекомендуемыйМеханизм компоновки: 'constrained', 'compressed', 'tight', 'none'

Редко вызывается напрямую в повседневном использовании,figure()чащеsubplots()создает Figure и Axes за один вызов. Использование figure() отдельно предназначено в основном для сценариев с несколькими Figure или пользовательских свойств холста.


Примеры использования

Пример 1: Создание Figure с пользовательским размером

Пример

import matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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 matplotlib.pyplot as plt
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().


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

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