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_kwсловарь, необязательно

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

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

Словарь с ключевыми словами, передаваемыми конструктору 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`