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 подграфиков, возвращаемый объект — это 1D массив NumPy из объектов Axes.
- для NxM подграфиков, где N>1 и M>1, возвращается 2D массив.
Если False, сжатие не выполняется: возвращаемый объект Axes всегда является 2D массивом, содержащим экземпляры 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_kwсловарь, необязательно

Словарь с ключевыми словами, передаваемыми вызову add_subplot для создания каждого подграфика.

gridspec_kwсловарь, необязательно

Словарь с ключевыми словами, передаваемыми конструктору GridSpec, используемому для создания сетки, на которой размещаются подграфики.

**fig_kw

Все дополнительные ключевые аргументы передаются в вызов pyplot.figure.

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

figFigure

axAxes или массив осей

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`