matplotlib.pyplot.subplots
- matplotlib.pyplot.subplots(nrows=1, ncols=1, *, sharex=False, sharey=False, squeeze=True, width_ratios=None, height_ratios=None, subplot_kw=None, gridspec_kw=None, **fig_kw)[source]
-
Создайте фигуру и набор подграфиков.
Эта утилитарная обёртка делает удобным создание распространённых макетов подграфиков, включая объект фигуры, в одном вызове.
- Параметры:
-
- nrows, ncolsint, по умолчанию: 1
-
Количество строк/столбцов сетки подграфиков.
- sharex, shareybool или {'none', 'all', 'row', 'col'}, по умолчанию: False
-
Управляет совместным использованием свойств между осями x (sharex) или y (sharey):
- True или 'all': ось x или y будет общей для всех подграфиков.
- False или 'none': каждая ось x или y каждого подграфика будет независимой.
- 'row': каждая строка подграфиков будет иметь общую ось x или y.
- 'col': каждый столбец подграфиков будет иметь общую ось x или y.
Когда у подграфиков общая ось x по столбцу, метки делений оси x создаются только для нижнего подграфика. Аналогично, когда у подграфиков общая ось y по строке, метки делений оси y создаются только для первого подграфика в столбце. Чтобы в дальнейшем включить метки делений других подграфиков, используйте
tick_params.Когда у подграфиков общая ось с единицами, вызов
set_unitsобновит каждую ось с новыми единицами. - squeezebool, по умолчанию: True
-
-
Если True, из возвращаемого массива
Axesудаляются дополнительные измерения:- если создан только один подграфик (nrows=ncols=1), возвращается единственный объект Axes в виде скаляра.
- для Nx1 или 1xM подграфиков, возвращаемый объект — это одномерный numpy-массив объектов Axes.
- для NxM подграфиков с N>1 и M>1 возвращается двумерный массив.
- Если False, сжатие не выполняется: возвращаемый объект Axes всегда является двумерным массивом, содержащим экземпляры Axes, даже если он оказывается 1x1.
-
- width_ratiosмассив-подобный объект длины ncols, необязательно
-
Определяет относительные ширины столбцов. Каждый столбец получает относительную ширину
width_ratios[i] / sum(width_ratios). Если не задано, все столбцы будут иметь одинаковую ширину. Эквивалентноgridspec_kw={'width_ratios': [...]}. - height_ratiosмассив-подобный объект длины nrows, необязательно
-
Определяет относительные высоты строк. Каждая строка получает относительную высоту
height_ratios[i] / sum(height_ratios). Если не задано, все строки будут иметь одинаковую высоту. Удобство дляgridspec_kw={'height_ratios': [...]}. - subplot_kwdict, необязательно
-
Словарь с ключевыми словами, передаваемыми в вызов
add_subplot, используемый для создания каждого подграфика. - gridspec_kwdict, необязательно
-
Словарь с ключевыми словами, передаваемыми конструктору
GridSpec, используемому для создания сетки, на которой размещаются подграфики. - **fig_kw
-
Все дополнительные ключевые параметры передаются в вызов
pyplot.figure.
- Возвращаемое значение:
-
-
fig
Figure -
ax
Axesили массив Axes -
ax может быть либо единственным объектом
Axes, либо массивом объектов Axes, если создано более одного подграфика. Размер возвращаемого массива можно контролировать с помощью ключевого слова squeeze, см. выше.Типичные способы обработки возвращаемого значения:
# using the variable ax for single a Axes fig, ax = plt.subplots() # using the variable axs for multiple Axes fig, axs = plt.subplots(2, 2) # using tuple unpacking for multiple Axes fig, (ax1, ax2) = plt.subplots(1, 2) fig, ((ax1, ax2), (ax3, ax4)) = plt.subplots(2, 2)
Имена
axи множественноеaxsпредпочтительнееaxes, поскольку для последнего не ясно, относится ли это к одному экземпляруAxesили к набору.
-
fig
Примеры
# First create some toy data: x = np.linspace(0, 2*np.pi, 400) y = np.sin(x**2) # Create just a figure and only one subplot fig, ax = plt.subplots() ax.plot(x, y) ax.set_title('Simple plot') # Create two subplots and unpack the output array immediately f, (ax1, ax2) = plt.subplots(1, 2, sharey=True) ax1.plot(x, y) ax1.set_title('Sharing Y axis') ax2.scatter(x, y) # Create four polar axes and access them through the returned array fig, axs = plt.subplots(2, 2, subplot_kw=dict(projection="polar")) axs[0, 0].plot(x, y) axs[1, 1].scatter(x, y) # Share a X axis with each column of subplots plt.subplots(2, 2, sharex='col') # Share a Y axis with each row of subplots plt.subplots(2, 2, sharey='row') # Share both X and Y axes with all subplots plt.subplots(2, 2, sharex='all', sharey='all') # Note that this is the same as plt.subplots(2, 2, sharex=True, sharey=True) # Create figure number 10 with a single subplot # and clears it if it already exists. fig, ax = plt.subplots(num=10, clear=True)
Примеры использования matplotlib.pyplot.subplots
Дискретное распределение в виде горизонтальной столбчатой диаграммы
Сопоставление свойств маркеров с многомерными данными
Заполнение областей, определённых логической маской, с помощью fill_between
Создание временной шкалы с линиями, датами и текстом
Смешивание прозрачности с цветом на 2D изображениях
Управление пределами отображения с помощью отступов и sticky_edges
Изменение размера осей с помощью ограниченного макета
Комбинирование двух подграфиков с использованием subplots и GridSpec
Создание нескольких подрисунков с помощью plt.subplots
Диаграммы размаха с настраиваемыми цветами заливки
Построение эллипса доверия двумерного набора данных
Создание прямоугольников из погрешностей с помощью PatchCollection
Демонстрация различных настроек histtype функции histogram
Функция histogram (hist) с несколькими наборами данных
Отображение математических уравнений с помощью TeX
Коллекции линий, полигонов и правильных многоугольников с автоматическим масштабированием
Отображение цветовых каналов RGB с помощью RGBAxes
Управление позицией и размером цветовых шкал с помощью вставленных осей
Диаграмма рассеяния с гистограммами (размещаемые оси)
Анимированное изображение с использованием предварительно вычисленного списка изображений
Анимированная диаграмма рассеяния, сохранённая как GIF
Построение гистограмм с помощью прямоугольников и коллекций многоугольников
Диаграмма радаров (также известная как паук или звёздная диаграмма)
Форматирование делений дат с помощью ConciseDateFormatter
Настраиваемый форматер делений для временных рядов
Групповая диаграмма столбцов с единицами измерения
Выбрать индексы из коллекции с помощью многоугольного селектора
Пороговое значение изображения с помощью RangeSlider
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.8.4/api/_as_gen/matplotlib.pyplot.subplots.html
