Функции управления фигурами и осями Matplotlib
Справочная документация Matplotlib
Matplotlib предоставляет ряд функций для создания и управления объектами Figure и Axes. Все связанные функции перечислены ниже.
Список функций
| Функция | Описание | pyplot | Соответствующий метод |
|---|---|---|---|
| figure() | Создать или активировать Figure | plt.figure() | - |
| subplots() | Создать Figure и сетку Axes | plt.subplots() | fig.subplots() |
| subplot() | Добавить один подграфик по индексу строки и столбца | plt.subplot() | fig.add_subplot() |
| subplot2grid() | Создать подграфик в указанной позиции в сетке | plt.subplot2grid() | - |
| subplot_mosaic() | Компоновка подграфиков с помощью строковых меток | plt.subplot_mosaic() | fig.subplot_mosaic() |
| axes() | Добавить Axes в текущую Figure | plt.axes() | fig.add_axes() |
| gca() | Получить текущие Axes | plt.gca() | fig.gca() |
| gcf() | Получить текущую фигуру | plt.gcf() | - |
| sca() | Установить текущий Axes | plt.sca(ax) | fig.sca(ax) |
| cla() | Очистить текущий Axes | plt.cla() | ax.cla() |
| clf() | Очистить текущий Figure | plt.clf() | fig.clear() |
| close() | Закрыть окно Figure | plt.close() | - |
| delaxes() | Удалить Axes из Figure | plt.delaxes(ax) | fig.delaxes(ax) |
| fignum_exists() | Проверить, существует ли номер Figure | plt.fignum_exists(n) | - |
| get_figlabels() | Получить список всех меток Figure | plt.get_figlabels() | - |
| get_fignums() | Получить список всех номеров фигур | plt.get_fignums() | - |
| twinx() | Создать двойную ось Y с общей осью X | plt.twinx() | ax.twinx() |
| twiny() | Создать парную ось x с общей осью y | plt.twiny() | ax.twiny() |
Примеры использования
Пример 1: gca/gcf/sca, работающие с текущей фигурой
Пример
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
# Создать первую фигуру
plt.figure(1)
plt.plot(x, np.sin(x), label='sin(x)')
# Создать вторую фигуру
plt.figure(2)
plt.plot(x, np.cos(x), label='cos(x)')
# Проверить, существует ли рисунок 1
print(plt.fignum_exists(1)) # True
# Получить все номера рисунков
print(plt.get_fignums()) # [1, 2]
# Переключиться обратно на рисунок 1
plt.figure(1)
ax = plt.gca() # Получить текущий Axes
print(ax.get_title())
# Сделать текущим другой Axes
plt.sca(ax)
plt.title('Переключено через sca()')
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
# Создать первую фигуру
plt.figure(1)
plt.plot(x, np.sin(x), label='sin(x)')
# Создать вторую фигуру
plt.figure(2)
plt.plot(x, np.cos(x), label='cos(x)')
# Проверить, существует ли рисунок 1
print(plt.fignum_exists(1)) # True
# Получить все номера рисунков
print(plt.get_fignums()) # [1, 2]
# Переключиться обратно на рисунок 1
plt.figure(1)
ax = plt.gca() # Получить текущий Axes
print(ax.get_title())
# Сделать текущим другой Axes
plt.sca(ax)
plt.title('Переключено через sca()')
plt.show()
True [1, 2]
Пример 2: Создание неравномерного макета с помощью subplot2grid
Пример
import matplotlib.pyplot as plt
import numpy as np
fig = plt.figure(figsize=(10, 6), layout='constrained')
# subplot2grid(shape, loc, rowspan, colspan)
# shape=(3,3): сетка из 3 строк и 3 столбцов
ax1 = plt.subplot2grid((3, 3), (0, 0), colspan=3) # Верхний занимает всю строку
ax2 = plt.subplot2grid((3, 3), (1, 0), rowspan=2) # Левый занимает 2 строки по вертикали
ax3 = plt.subplot2grid((3, 3), (1, 1), colspan=2) # Верхний правый занимает 2 столбца
ax4 = plt.subplot2grid((3, 3), (2, 1)) # Правый средний
ax5 = plt.subplot2grid((3, 3), (2, 2)) # Правый нижний
x = np.linspace(0, 10, 50)
ax1.plot(x, np.sin(x))
ax1.set_title('Сверху: colspan=3')
ax2.plot(x, np.cos(x), 'orange')
ax2.set_title('Слева: rowspan=2')
ax3.bar(['A','B','C'], [3,7,5])
ax3.set_title('Справа сверху: colspan=2')
ax4.text(0.5, 0.5, 'Панель 4', ha='center', va='center')
ax5.text(0.5, 0.5, 'Панель 5', ha='center', va='center')
fig.suptitle('Макет subplot2grid', fontsize=14)
plt.show()
import numpy as np
fig = plt.figure(figsize=(10, 6), layout='constrained')
# subplot2grid(shape, loc, rowspan, colspan)
# shape=(3,3): сетка из 3 строк и 3 столбцов
ax1 = plt.subplot2grid((3, 3), (0, 0), colspan=3) # Верхний занимает всю строку
ax2 = plt.subplot2grid((3, 3), (1, 0), rowspan=2) # Левый занимает 2 строки по вертикали
ax3 = plt.subplot2grid((3, 3), (1, 1), colspan=2) # Верхний правый занимает 2 столбца
ax4 = plt.subplot2grid((3, 3), (2, 1)) # Правый средний
ax5 = plt.subplot2grid((3, 3), (2, 2)) # Правый нижний
x = np.linspace(0, 10, 50)
ax1.plot(x, np.sin(x))
ax1.set_title('Сверху: colspan=3')
ax2.plot(x, np.cos(x), 'orange')
ax2.set_title('Слева: rowspan=2')
ax3.bar(['A','B','C'], [3,7,5])
ax3.set_title('Справа сверху: colspan=2')
ax4.text(0.5, 0.5, 'Панель 4', ha='center', va='center')
ax5.text(0.5, 0.5, 'Панель 5', ha='center', va='center')
fig.suptitle('Макет subplot2grid', fontsize=14)
plt.show()
Пример 3: разметка меток subplot_mosaic
Пример
import matplotlib.pyplot as plt
import numpy as np
layout = """
AAAB
CCDD
"""
fig, axes = plt.subplot_mosaic(layout, figsize=(10, 6),
layout='constrained')
x = np.linspace(0, 10, 100)
# Доступ к подграфикам по имени метки
axes['A'].plot(x, np.sin(x))
axes['A'].set_title('A: Верхняя широкая панель')
axes['B'].plot(x, np.cos(x), 'orange')
axes['B'].set_title('B: Верхний правый')
axes['C'].bar(['X','Y','Z'], [5, 8, 3], color='steelblue')
axes['C'].set_title('C: Нижний левый')
axes['D'].hist(np.random.randn(200), bins=20,
color='coral', edgecolor='white')
axes['D'].set_title('D: Нижний правый')
fig.suptitle('subplot_mosaic() с доступом по меткам')
plt.show()
import numpy as np
layout = """
AAAB
CCDD
"""
fig, axes = plt.subplot_mosaic(layout, figsize=(10, 6),
layout='constrained')
x = np.linspace(0, 10, 100)
# Доступ к подграфикам по имени метки
axes['A'].plot(x, np.sin(x))
axes['A'].set_title('A: Верхняя широкая панель')
axes['B'].plot(x, np.cos(x), 'orange')
axes['B'].set_title('B: Верхний правый')
axes['C'].bar(['X','Y','Z'], [5, 8, 3], color='steelblue')
axes['C'].set_title('C: Нижний левый')
axes['D'].hist(np.random.randn(200), bins=20,
color='coral', edgecolor='white')
axes['D'].set_title('D: Нижний правый')
fig.suptitle('subplot_mosaic() с доступом по меткам')
plt.show()
Пример 4: двойные оси twinx/twiny
Пример
import matplotlib.pyplot as plt
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax1 = plt.subplots(figsize=(8, 4), layout='constrained')
# Основная ось Y (левая сторона)
color1 = 'tab:blue'
ax1.plot(x, np.sin(x) * 100, color=color1, label='Напряжение')
ax1.set_xlabel('Время (s)')
ax1.set_ylabel('Напряжение (mV)', color=color1)
ax1.tick_params(axis='y', labelcolor=color1)
# twinx() создаёт вторую ось Y, имеющую общую ось X (правая сторона)
ax2 = ax1.twinx()
color2 = 'tab:red'
ax2.plot(x, np.cos(x) * 40 + 50, color=color2, linestyle='--',
label='Температура')
ax2.set_ylabel('Температура (°C)', color=color2)
ax2.tick_params(axis='y', labelcolor=color2)
ax1.set_title('Двойные оси Y с twinx()')
plt.show()
import numpy as np
x = np.linspace(0, 10, 100)
fig, ax1 = plt.subplots(figsize=(8, 4), layout='constrained')
# Основная ось Y (левая сторона)
color1 = 'tab:blue'
ax1.plot(x, np.sin(x) * 100, color=color1, label='Напряжение')
ax1.set_xlabel('Время (s)')
ax1.set_ylabel('Напряжение (mV)', color=color1)
ax1.tick_params(axis='y', labelcolor=color1)
# twinx() создаёт вторую ось Y, имеющую общую ось X (правая сторона)
ax2 = ax1.twinx()
color2 = 'tab:red'
ax2.plot(x, np.cos(x) * 40 + 50, color=color2, linestyle='--',
label='Температура')
ax2.set_ylabel('Температура (°C)', color=color2)
ax2.tick_params(axis='y', labelcolor=color2)
ax1.set_title('Двойные оси Y с twinx()')
plt.show()
Пример 5: операции очистки cla/clf/close
Пример
import matplotlib.pyplot as plt
import numpy as np
# Создать Figure и построить график
fig, ax = plt.subplots()
ax.plot([1, 2, 3], [4, 5, 6])
ax.set_title('Исходный график')
print('Перед cla():', len(ax.get_lines())) # 1
# cla() очищает содержимое Axes (сохраняет Axes и Figure)
ax.cla()
print('После cla():', len(ax.get_lines())) # 0
# Перестроить график
ax.plot([1, 2, 3], [1, 4, 9])
ax.set_title('После cla() и перестроения графика')
plt.show()
# clf() очищает всю фигуру
plt.clf()
print('После clf():', len(fig.get_axes())) # 0
# close() закрывает окно Figure
plt.close('all')
print('пример: очистка завершена')
import numpy as np
# Создать Figure и построить график
fig, ax = plt.subplots()
ax.plot([1, 2, 3], [4, 5, 6])
ax.set_title('Исходный график')
print('Перед cla():', len(ax.get_lines())) # 1
# cla() очищает содержимое Axes (сохраняет Axes и Figure)
ax.cla()
print('После cla():', len(ax.get_lines())) # 0
# Перестроить график
ax.plot([1, 2, 3], [1, 4, 9])
ax.set_title('После cla() и перестроения графика')
plt.show()
# clf() очищает всю фигуру
plt.clf()
print('После clf():', len(fig.get_axes())) # 0
# close() закрывает окно Figure
plt.close('all')
print('пример: очистка завершена')
Другие расширения