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.

Когда подграфики имеют общую ось с единицами, вызов Axis.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.

Возвращаемое значение:

figFigure

axAxes или массив 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 или к набору таких.

matplotlib.pyplot.subplots

Примеры

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

Примеры использования `matplotlib.pyplot.subplots`